Canales
Cómo configurar WhatsApp
Guía paso a paso para configurar el canal de WhatsApp en Omnifly
Objetivo
Conectar tu cuenta de WhatsApp Business para recibir y enviar mensajes desde Omnifly.
Requisitos previos
- Tener rol de Owner o Admin
- Tener una cuenta de WhatsApp Business configurada en Meta
- Contar con acceso a Meta Business Suite
Pasos
1. Obtener las credenciales de WhatsApp Cloud API
Desde Meta Business Suite, necesitas obtener:
- WhatsApp Business Account ID
- Phone Number ID del número que usarás
- Access Token con los permisos necesarios
- Webhook Verification Token (lo defines tú)
2. Crear el canal en Omnifly
- Ve a Configuración → Canales
- Haz clic en Agregar canal
- Selecciona WhatsApp
- Ingresa las credenciales obtenidas en el paso anterior
- Haz clic en Conectar
3. Verificar la conexión
- El sistema validará las credenciales
- Se registrarán los webhooks automáticamente
- El canal quedará en estado Connected
- Ya puedes recibir y enviar mensajes
Resultado esperado
Tu canal de WhatsApp está conectado y activo. Los mensajes que recibas aparecerán en tu bandeja de conversaciones.
Capacidades de WhatsApp
| Característica | Soportado |
|---|---|
| Mensajes de texto | ✓ |
| Plantillas HSM | ✓ |
| Imágenes | ✓ |
| Documentos | ✓ |
| Audio | ✓ |
| Video | ✓ |
Ventana de mensajería (24 horas)
WhatsApp tiene una restricción de 24 horas para mensajes libres:
| Situación | Qué puedes hacer |
|---|---|
| Dentro de la ventana (24h desde último mensaje del cliente) | Enviar cualquier tipo de mensaje |
| Fuera de la ventana | Solo enviar plantillas HSM aprobadas |
El sistema te indicará automáticamente el estado de la ventana.
Plantillas de mensajes (HSM)
Para enviar mensajes fuera de la ventana de 24 horas:
- Las plantillas deben estar aprobadas en Meta Business Suite
- En Omnifly, se sincronizan automáticamente (caché de 5 minutos)
- Al enviar, selecciona la plantilla y completa los parámetros dinámicos
Solución de problemas
| Problema | Causa | Solución |
|---|---|---|
| No se conecta | Credenciales incorrectas | Verifica el Account ID, Phone Number ID y Access Token |
| No recibo mensajes | Webhook no configurado | Verifica la URL del webhook en Meta Business Suite |
| Ventana expirada | Más de 24h sin mensaje del cliente | Envía una plantilla HSM |
| Plantilla no encontrada | Plantilla no aprobada o eliminada | Verifica el estado en Meta Business Suite |
| Número no válido | Formato incorrecto | Usa formato internacional con código de país |