Para qué sirve#
Registra una línea de WhatsApp Business para que tu equipo envíe y reciba mensajes desde Connecto. Cada línea (número) es un canal.
Quién puede usarlo: administradores. Si otro rol intenta registrar una línea, el sistema responde «Solo un administrador puede registrar líneas.»
Cómo llegar: Ajustes de sistema → Canales de mensajería → Agregar canal → WhatsApp Business.
En la ventana de selección verás: «Conecta tu número de WhatsApp Business para enviar y recibir mensajes directamente desde Connecto GG.» y el requisito «Requiere cuenta de WhatsApp Business API (WABA) verificada por Meta.»
Antes de empezar#
Necesitas, desde tu cuenta de Meta (WhatsApp Business):
- El Phone Number ID de la línea (se ve en Meta, en WhatsApp → Configuración de la API).
- Opcionalmente, el WABA ID (identificador de la cuenta de WhatsApp Business).
- Opcionalmente, un Access Token propio.
En el formulario se muestra la URL del webhook que debes registrar en Meta (tiene la forma https://tu-dominio/webhook/meta). Cópiala tal como aparece en pantalla: es la dirección a la que Meta enviará los mensajes de tus contactos.
El formulario «Configurar canal»#
| Campo | Qué hace | Obligatorio | Notas |
|---|---|---|---|
| Nombre del canal | Nombre con el que verás la línea en Connecto | Sí | Ejemplo: «WhatsApp Ventas» |
| Phone Number ID | Identifica la línea. Es el código que llega en cada mensaje del webhook y le dice al sistema por qué canal entró | Sí | Solo se guardan los dígitos; cualquier otro carácter se ignora |
| WABA ID (opcional) | Cuenta de WhatsApp Business | No | Solo hace falta para leer y crear plantillas. Si no lo escribes, el sistema intenta deducirlo del token |
| Access Token propio (opcional) | Token de acceso de esta línea | No | Vacío = se usa el token global de la aplicación de Meta de tu empresa |
Botones: Cancelar y Guardar.
Paso a paso#
- Pulsa Agregar canal y elige WhatsApp Business.
- Escribe el Nombre del canal y el Phone Number ID.
- Si lo necesitas, completa el WABA ID y el Access Token propio.
- Pulsa Guardar.
- Si todo sale bien verás el aviso «Línea registrada correctamente.» y la línea aparecerá en la lista como Conectado.
- En Meta, registra la URL del webhook que mostró el formulario (si aún no lo hiciste).
Mensajes posibles:
| Mensaje | Cuándo aparece |
|---|---|
| «Línea registrada correctamente.» | La línea quedó guardada |
| «No se pudo registrar la línea.» | No se pudo guardar |
| «El nombre y el Phone Number ID son obligatorios.» | Falta alguno de los dos |
| «Solo un administrador puede registrar líneas.» | El usuario no es administrador |
Reglas y comportamientos#
- Si registras un Phone Number ID que ya existe, no se crea otro canal: se actualiza el existente (nombre, token y WABA ID) y se vuelve a dejar Conectado. Los datos que ya tenía y no se mencionan en el formulario no se pierden.
- Si escribes un token propio, el canal queda marcado internamente como «de token propio»; si lo dejas vacío, usa el token global de la aplicación de Meta de tu empresa.
- Al guardar, el sistema no comprueba el token ni el Phone Number ID contra Meta. Un dato equivocado se nota después, cuando no llegan mensajes o fallan los envíos.
- Los mensajes recibidos pueden ser texto, imágenes, audios, videos, documentos, ubicaciones, tarjetas de contacto, reacciones y respuestas a botones o listas. Un tipo de mensaje que Connecto no maneja se guarda como texto con el aviso «[Mensaje de WhatsApp de un tipo no compatible: …]».
- WhatsApp solo permite mensajes libres durante 24 horas desde el último mensaje del contacto. Fuera de esa ventana hay que usar una plantilla.
- Cuando la línea quedó sin token (ni propio ni global), las pantallas de plantillas, perfil y facturación muestran un aviso de error, por ejemplo «El canal no tiene access_token configurado.»
Qué sigue#
- Ver cómo va la línea: Estadísticas de canal.
- Crear mensajes para iniciar conversaciones: Plantillas de canal.
- Revisar el costo: Facturación de WhatsApp.
<!-- Fuente: tenant-app/public/configuracion/index.php (formulario addChannelModal, acción channel_save), shared/src/Core/MetaChannelClient.php, shared/i18n/es.php, node/src/channels/whatsapp.js, node/src/metaHandler.js -->