Conecta números de WhatsApp Business y gestiona conversaciones en tiempo real.
Recomendado: conecta tu número directamente con Meta Cloud API (sin intermediarios) siguiendo la guía paso a paso de configuración con Meta con capturas.
Objetivo
Conectar números de WhatsApp Business y gestionar conversaciones en tiempo real.
Acceso
Sidebar -> WhatsApp Ruta: /app/{tenant}/whatsapp
Roles
- owner, admin, agent
Requisitos previos
- Integrations: Twilio conectado (recomendado) o Meta Cloud API.
- Agent con canal WhatsApp habilitado.
Conectar un número (Connect New Number)
Paso a paso:
- En WhatsApp, pulsa Conectar nuevo número.
- Completa los campos del modal.
- Pulsa Conectar número.
Campos:
| Campo | Obligatorio | Formato | Ejemplo | Nota |
|---|---|---|---|---|
| Display Name | Sí | texto | Sales Support | Nombre visible |
| Assigned Agent | Si (si Active) | selección | Support Agent | Debe tener WhatsApp habilitado |
| Active | No | checkbox | ON | Si está activo, requiere agent |
Twilio (recomendado)
- Requiere Twilio conectado en Integrations.
- Selecciona el número desde el dropdown de Twilio.
- Si no aparece, usa entrada manual con formato: whatsapp:+1234567890.
Meta Cloud API (legacy)
Campos:
| Campo | Obligatorio | Formato | Ejemplo | Nota |
|---|---|---|---|---|
| Phone Number ID | Sí | texto | 123456789 | Desde Meta Business |
| Business Account ID | No | texto | 987654321 | Opcional |
| Access Token | Sí | token | EAAG... | Token permanente |
Gestionar números conectados
En cada card puedes:
- Toggle Active/Inactive.
- Edit (abre modal de edición).
- Delete (requiere confirmación).
Conversaciones recientes
En la tabla de conversaciones:
- Haz clic en Ver chat para abrir la conversación.
- Se muestran status, último mensaje y sentimiento si existe.
Vista de conversación (WhatsApp chat)
Ruta: /app/{tenant}/whatsapp/{id}
Acciones:
- Enviar mensaje (textarea + Send).
- Close / Archive / Reopen según estado.
- Alterna IA activa / IA desactivada.
- Delete (solo admin/owner).
- Generar insights (sentimiento + resumen).
Campos clave en la barra lateral (AI Insights):
- Sentiment Analysis
- Conversation Summary
Notificaciones de WhatsApp
Ruta: /app/{tenant}/whatsapp/notifications
Funciones:
- Ver alertas de escalación o nuevos mensajes.
- Marcar como leída individual o Marcar todas como leídas.
- Abrir la conversación desde el link.
Buenas prácticas
- Asigna un agent antes de activar el número.
- Usa Twilio como proveedor principal.
- Si desactivas AI, la conversación queda solo para humanos.
Errores comunes
- No aparecen números: revisa Twilio en Integrations.
- Error al enviar: revisa formato del número y credenciales.