Ir al contenido
Documentación de Connecto
connecto.lat
Guía de usuarioConfiguración: canales y sesiones de chat

Conectar WhatsApp

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»#

CampoQué haceObligatorioNotas
Nombre del canalNombre con el que verás la línea en ConnectoSíEjemplo: «WhatsApp Ventas»
Phone Number IDIdentifica 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 BusinessNoSolo 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íneaNoVacío = se usa el token global de la aplicación de Meta de tu empresa

Botones: Cancelar y Guardar.

Paso a paso#

  1. Pulsa Agregar canal y elige WhatsApp Business.
  2. Escribe el Nombre del canal y el Phone Number ID.
  3. Si lo necesitas, completa el WABA ID y el Access Token propio.
  4. Pulsa Guardar.
  5. Si todo sale bien verás el aviso «Línea registrada correctamente.» y la línea aparecerá en la lista como Conectado.
  6. En Meta, registra la URL del webhook que mostró el formulario (si aún no lo hiciste).

Mensajes posibles:

MensajeCuá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.»
La calidad de la línea (verde, amarilla o roja) y el estado del nombre para mostrar vienen de Meta y se ven en la pestaña Configuración del detalle de la línea. Mira Perfil de WhatsApp.

Qué sigue#

<!-- 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 -->

¿Te fue útil esta página?
Última actualización: 14/11/2026