Usa la configuración manual si tu número ya está en la Plataforma WhatsApp Business (API), eres un proveedor tecnológico configurando tu propio número, eres autohospedado o la Configuración rápida no está disponible. Conectas Chatwoot a tu propia app de Meta.
Plan y acceso
-
Todos los planes que incluyen WhatsApp (Startups y superiores, y la prueba gratuita) en Chatwoot Cloud y autohospedado. Ver Precios y planes.
-
Solo administradores.
-
La coexistencia (mantener la app WhatsApp Business) no es compatible con la configuración manual. Si tu número está activo en la app WhatsApp Business, no lo registres con este flujo. Usa la Configuración rápida (página 3) o contacta con soporte.
Antes de comenzar
Necesitas tres cosas de Meta. La configuración guiada en Chatwoot te guía por cada una y enlaza a la pantalla correcta de Meta:
-
Una app de Meta con el caso de uso de WhatsApp
-
ID del número de teléfono y ID de la cuenta de WhatsApp Business de tu número
-
Un token de acceso permanente de un usuario de sistema de Meta
Conecta tu número
-
Ve a Configuración › Bandejas de entrada › Añadir bandeja de entrada › WhatsApp y elige WhatsApp Cloud. En la pantalla de Configuración rápida, haz clic en flujo de configuración manual en la parte inferior. (Si la Configuración rápida no está disponible, irás directamente a la configuración manual.)
-
Crea o selecciona una app de Meta. En Meta Developers, crea una app (o elige la que ya usas para este número), selecciona conectar con clientes a través de WhatsApp y elige el portafolio de negocio que posee el número. Haz clic en Mi app de Meta está lista.
-
Agrega tu número de teléfono y obtén sus IDs. En tu app de Meta, abre el caso de uso de WhatsApp y elige Configuración de API. En Enviar y recibir mensajes, abre el selector De y elige tu número, o selecciona Añadir número de teléfono, completa el perfil de negocio y verifica con el código que envía Meta. Copia el ID del número de teléfono y el ID de la cuenta de WhatsApp Business, introdúcelos en Chatwoot y haz clic en Siguiente.
-
Genera un token de acceso permanente. En Configuración de negocio de Meta, ve a Usuarios › Usuarios de sistema, crea un usuario de sistema administrador (o elige uno), asígnale tu app de Meta y la cuenta de WhatsApp Business con control total, luego haz clic en Generar token. Establece la caducidad en Nunca, selecciona whatsapp_business_management y whatsapp_business_messaging, y copia el token. Meta lo muestra solo una vez. En Chatwoot, pégalo como Token de acceso permanente y haz clic en Verificar detalles.
-
Revisa el nombre del negocio, el número e IDs, cambia el Nombre de la bandeja de entrada si lo deseas, y haz clic en Crear bandeja de entrada.
-
Chatwoot comprueba Acceso al número, Acceso a plantillas, Callback del Webhook y Suscripción al Webhook, y configura el webhook en Meta por ti. Cuando los cuatro muestren Verificado, haz clic en Continuar para añadir agentes.
Pruébalo: envía un mensaje de WhatsApp a tu número de negocio desde otro teléfono. Debería aparecer en Chatwoot. Responde y comprueba que llega.
Mantén tu token privado. Cualquiera que lo tenga puede usar tu conexión de WhatsApp. Si lo reemplazas o revocas en Meta, actualízalo en la pestaña Configuración de la bandeja de entrada.
Si falla un paso de verificación
| Mensaje | Qué hacer |
|---|---|
| Este token de acceso no es válido o ha expirado | Genera un nuevo token permanente (caducidad Nunca) e inténtalo de nuevo |
| Acceso a plantillas no verificado | Al token le falta whatsapp_business_management. Los mensajes funcionarán, pero las plantillas no se sincronizarán. Genera un token con ambos permisos. |
| Callback del webhook o Suscripción al webhook no verificados | Haz clic en Reintentar configuración del webhook. Si aún falla, comprueba que el usuario de sistema tenga control total de la cuenta de WhatsApp Business. |
| Introduce el ID del número de teléfono y el ID de la cuenta de WhatsApp Business | Cópialos ambos de Configuración de API en tu app de Meta. Son números diferentes. |
Para cualquier otra cosa, consulta Solución de problemas de WhatsApp.
Qué sucede después
-
Las plantillas aprobadas en tu cuenta de WhatsApp Business se sincronizan automáticamente. Consulta Plantillas y la ventana de 24 horas.
-
Las llamadas funcionan también con la configuración manual, una vez que tu número está inscrito en la API de llamadas de Meta. Consulta Llamadas por WhatsApp.
Conectando más de un número
Sí, puedes. Crea una bandeja de entrada de Chatwoot separada por cada número. La configuración guiada configura el enrutamiento del webhook para cada uno, así que no hay nada que configurar manualmente.