- ID del canal: 1.
- Tipo de canal: Texto (mensajería tipo chat).
- Visibilidad del canal: Público.
- Complejidad de integración: Requiere contratación comercial (depende de un proveedor BSP externo — Gupshup, Twilio o Sinch — o de una implementación de FB WhatsApp Business).
- Chat general o solo Kyubo: Chat general.
- Sandbox disponible: Sí (WhatsApp vía Gupshup y WhatsApp vía Meta, según región — ver Sandbox de canales).
Definición
El canal de WhatsApp (WA) es un canal de red social orientado a mensajería de tipo chat. El proceso de integración de este canal generalmente depende de un proveedor de integración externo o de una implementación de FB WA Business. La disponibilidad de proveedores de integración puede variar según el estatus y versión de Lynn.
Siempre se deben tener en cuenta los términos y condiciones de uso de dichos proveedores, ya que estos determinan las capacidades del integrador en cuanto al manejo de datos y contenido multimedia (media).
Una vez configurados los parámetros de acceso de la numeración de WhatsApp del proveedor, Lynn estará en capacidad de transaccionar mensajería y media con la red social, siempre acorde a las limitaciones que esta establezca y a los acuerdos y términos de uso de la plataforma.
Proceso de aprobación de la red social
El proceso de aprobación de aplicaciones puede tardar hasta dos semanas, según el análisis y los tiempos que ofrece la red social. Durante esta aprobación, la red social valida que la aplicación cumpla con los requisitos de la plataforma para operar y garantizar una correcta operación.
Es importante considerar que este proceso requiere vincular la numeración asociada a la red social al modelo de gestión de aplicaciones de dicha red social. Esto implica, de forma obligatoria, tener acceso a la administración del celular o dispositivo asociado a esa numeración.
Límite de mensajes declarados por META
Los límites de mensajes determinan el número máximo de conversaciones iniciadas por la empresa que se pueden comenzar con cada número de teléfono, en un período renovable de 24 horas.
Una conversación iniciada por la empresa comienza cuando se entrega el primer mensaje de plantilla a un cliente, y finaliza 24 horas después. Este límite aumenta automáticamente en función de:
- El estado del número de teléfono.
- La calificación de calidad del número de teléfono.
- La frecuencia con la que la empresa inicia conversaciones con clientes únicos.
Para mayor información, consulta la documentación de META.
Método de integración
La integración depende del proveedor (BSP) seleccionado. Al agregar el canal WhatsApp en el diseñador, se despliegan los proveedores disponibles: Masivian, Wabiz, Twilio, Sinch, Meta, OneMarket, InfoBip, GupShup, Nexmo (Vonage).
Proceso general (común a todos los proveedores):
Hacer clic derecho en el área de diseño → "Configurar Canal" → "Agregar canal a [Ambiente]".
Seleccionar el canal WhatsApp y luego el proveedor correspondiente.
Completar los campos de configuración específicos del proveedor (ver tabla siguiente).
Presionar "Verificar" y "Actualizar". El canal aparece en gris hasta ser activado.
Activar canal: clic derecho sobre el canal → "Activar".
Proveedores de integración (BSP)
Lynn integra WhatsApp a través de distintos proveedores BSP. La configuración detallada (requisitos previos y parámetros) de cada uno con archivo dedicado se documenta por separado:
| Proveedor | ID canal (proveedor) | Detalle de configuración |
|---|---|---|
| GupShup | 1 (Proveedor Gupshup) | Ver Gupshup — incluye configuración de Carruseles y WhatsApp Flows. |
| Twilio | 1 (Proveedor Twilio) | Ver Twilio. |
| Sinch | 1 (Proveedor Sinch) | Ver Sinch. |
| Nexmo (Vonage) | 1 (Proveedor Nexmo) | Ver sección Nexmo (Vonage) más abajo. |
| Masivian | 1 (Proveedor Masivian) | — |
Nexmo (Vonage)
Requisitos previos: cuenta en Vonage; acceso a WhatsApp Business API; número de WhatsApp Business registrado.
Parámetros del canal en Lynn:
| Parámetro | Descripción |
|---|---|
WHATSAPP_TIMEOUT_SECOUNDS |
Tiempo de espera para detectar inactividad y cerrar la interacción (máximo 7200 seg / 2 horas). |
WHATSAPP_AUTORIZATION_METHOD |
Método de autorización usado para la conexión con la API de Nexmo/Vonage. |
Renovación de token META
Cuando el canal está vinculado a la app de Meta (Messenger/WhatsApp Business), el token de acceso puede caducar o bloquearse. Ver el procedimiento de verificación y renovación de token en Token de redes sociales META.
Sandbox de canales
WhatsApp está disponible en el Sandbox de Canales de Lynn (ambiente de Desarrollo) en Brasil, a través de los proveedores Gupshup y Meta. En el Sandbox de Estados Unidos, WhatsApp actualmente no se encuentra en la lista de canales disponibles (ver Acceso al Sandbox).
Probar campañas Outbound de WhatsApp a través del Sandbox
Para usar el Outbound (Lynn Proactive) a través del Sandbox, se desarrolla el flujo de Outbound normalmente, cambiando únicamente el número telefónico de origen y las plantillas asociadas por los correspondientes al número del Sandbox:
- En el módulo de extensión Outbound / Administration of the Campaign Records, sección WhatsApp campaign configuration → Whatsapp number, seleccionar el número asociado al Sandbox.
- Si se usa una plantilla MTM, debe seleccionarse una de las plantillas MTM asociadas al número del Sandbox (por ejemplo: "Agendar contacto", "Notificar deuda", "Notificar servicio afectado").
- Al importar registros de campaña por carga masiva, se debe incluir en el JSON de carga:
IsSandBoxRecord:true.WhatAppNumber: número telefónico del Sandbox.- Configuración de la plantilla HSM:
Namespace,Template,Locale.
Note
Los datos de ejemplo de números y plantillas del Sandbox pueden variar; solicitar al equipo de soporte los valores vigentes para el tenant.