Contratos internos

Cómo se oculta

El menú del panel muestra Guía y Soporte. Esta página no tiene enlace ahí, ni en Inicio, ni en la Guía.

El acceso es la URL directa /docs. No hay query secreta, cabecera ni variable para encenderla: quien conoce la ruta la abre. El proxy de sesión no envuelve /docs, igual que /help y /support.

Contrato de producto

Chat Game API es el contrato HTTP del panel. Lead Game es el CRM donde vive la conversación 1 a 1.

• El 1 a 1 sale de Lead Game → Conversaciones. El canal del cuadro es SMS (marca blanca). Ese SMS es WhatsApp vía Chat Game. No hay un canal aparte. Este panel no envía 1 a 1.
• #btn y #list se copian en Constructor y se pegan en ese chat. No salen a grupos.
• A grupos, Chat Game API acepta texto, imagen, video, GIF, archivo, nota de voz y encuesta.
• La cola de grupos va a unos 20 mensajes por hora, 80 al día y 8–20 segundos entre cada envío.
• Crear una comunidad no está en el servidor. Snapshot, disparadores de Marketplace y Session Linker no se configuran aquí.

Chat Game API

El navegador habla con el servidor del panel. El token del panel no viaja en el browser.

• Números: listar líneas, abrir la conexión (país del teléfono, QR o código de 8 caracteres), leer el estado y guardar opciones de la línea.
• Grupos: sincronizar, activar, etiquetar, crear en lote, cambiar nombre, foto y participantes, y enviar en lote.
• Envío a grupos: texto; imagen, video, GIF o archivo con la dirección del medio; nota de voz sin texto; encuesta de una opción o de varias.
• Enlaces de invitación por línea y enlaces cortos por ubicación de Lead Game.
• Plantillas de encuesta guardadas en la ubicación.
• Métricas: listado de mensajes enviados de la línea, y acuse o reacciones de uno de ellos, usando el id que devuelve ese listado.
• Cupo: la ubicación declara cuántos números entran. Comprar más pide el cupo total, desde 3.

Integración con Lead Game

Chat Game es la app de Marketplace, en marca blanca. El panel no muestra tokens.

• La app va en la agencia y en cada subcuenta que vaya a usar WhatsApp.
• El menú personalizado abre el panel en iframe. Sin ese marco no hay sesión.
• Post-conectar: si el banner dice «No numbers» o «Comprar ahora», no compres la línea.
• Chat Game es el SMS Conversation Provider, una configuración adicional. No es LC Phone ni la integración telefónica de la agencia.
• Chat Game suele quedar por defecto al instalarlo. Si no: Lead Game → Configuración → Sistema telefónico → Configuración adicional → selecciona Chat Game. Si el sistema telefónico dice que requiere configuración, no es un paso de Chat Game.
• Ruta: https://app.leadgame.co/v2/location/{locationId}/settings/phone_system?tab=advanced-settings&childtab=sms-provider.
• En el cuadro el canal es SMS (marca blanca). Ese SMS es WhatsApp vía Chat Game.
• reaction-tags y poll-tags mapean un emoji o una opción de encuesta a una etiqueta de Chat Game. Los puntos se ven en Lead Game → Gestionar puntuación: https://app.leadgame.co/v2/location/{locationId}/settings/scoring. El panel no calcula esos puntos.
• Reautorizar la app en la subcuenta renueva el acceso. No se copia el token en el panel.

Límites que el panel asume

Estos topes son los del producto. La guía pública los explica con el panel de ejemplo, sin este contrato.

• Imagen: JPEG, PNG o WebP, hasta 5 MB, con pie opcional.
• Video: mensaje de video, con pie opcional. No es un archivo adjunto.
• GIF: un archivo GIF o un video corto, con texto opcional.
• Archivo: PDF, Word, Excel, PowerPoint, TXT o ZIP, hasta 16 MB, con texto opcional.
• Nota de voz: OGG, Opus, MP3, M4A, AAC, WAV o WebM, hasta 5 MB, sin texto.
• Botones: de 1 a 3, etiqueta hasta 20 caracteres. El medio es ninguno o una imagen https.
• Lista: título y texto del botón obligatorios. Hasta 10 secciones.
• Mezclar una respuesta con un enlace, una llamada o copiar puede rechazarse. El Constructor avisa y el texto igual se copia.