Por Sojan and harishmita
Por Sojan and harishmita
Tu guía completa de WhatsApp en Chatwoot: conecta tu número, usa plantillas, campañas, encuestas CSAT y llamadas, mantén tu número en buen estado y soluciona los errores más comunes de configuración y
WhatsApp en Chatwoot
Conecta tu número de WhatsApp Business a Chatwoot y tu equipo podrá responder los chats de WhatsApp desde una bandeja de entrada compartida, junto con tus otros canales. También puedes enviar mensajes de plantilla aprobados, ejecutar campañas de difusión, recopilar calificaciones CSAT y recibir llamadas de WhatsApp. Qué puedes hacer en WhatsApp Capacidades Qué hace Más información Bandeja compartida Los mensajes de los clientes llegan como conversaciones que tu equipo puede asignar, etiquetar, responder y resolver 2. Elige cómo conectar WhatsApp Mensajes de plantilla Inicia una conversación, o responde después de 24 horas, con un mensaje aprobado por Meta 7. Plantillas y la ventana de 24 h Campañas Envía una plantilla aprobada a cada contacto con las etiquetas elegidas. Plan Business y superior. 8. Campañas de WhatsApp Encuestas CSAT Solicita una calificación cuando se resuelve una conversación, incluso después de cerrarse la ventana de 24 horas 9. Encuestas CSAT en WhatsApp Llamadas Los clientes llaman a tu empresa desde WhatsApp y los agentes responden en el navegador 10. Llamadas de WhatsApp Salud de la cuenta Consulta el estado de tu número, límite de mensajes, revisión de nombre visible y el perfil de negocio dentro de Chatwoot 11. Administra tu número de WhatsApp Plan y acceso Chatwoot Cloud Autohospedado Bandeja WhatsApp (cualquier método de conexión) Plan Startups y superiores, y la prueba gratuita. No disponible en el plan gratuito Hacker. Incluido Configuración rápida con Meta (la forma más rápida de conectar) Incluido a partir del plan Startups. Durante la prueba gratuita, haz clic en Solicitar acceso en la pantalla de configuración y envía tu caso de uso para activarlo. Solo si tu instalación tiene su propia app de Meta configurada. La mayoría de instalaciones autohospedadas usan la configuración manual. Campañas de WhatsApp : envío Plan Business y superiores. Disponible automáticamente, no es necesario solicitarlo. No es una función premium. Funciona en Community Edition y está activada por defecto. Analítica de campañas Plan Business y superiores Solo plan Enterprise . El super admin de tu instalación activa Analítica de campañas en Super Admin › Cuentas › abre la cuenta › Editar , bajo Funciones premium , luego haz clic en Guardar cambios . Llamadas Plan Business y superiores Necesita un plan autohospedado de pago con Enterprise Edition, desde v4.15.0. Instalar únicamente la Enterprise Edition build no lo habilita. Plantillas, encuestas CSAT, salud de la cuenta Todos los planes que incluyen WhatsApp Incluido Quién puede hacer qué: - Administradores conectan bandejas de entrada y cambian la configuración de la bandeja. - Agentes añadidos a la bandeja responden conversaciones y envían plantillas. Consulta Precios y Planes para ver qué incluye cada plan. Tu método de conexión decide lo que puedes usar Chatwoot se conecta a WhatsApp de tres formas. Elige antes de conectar, porque algunas funciones solo funcionan con WhatsApp Cloud API. Configuración rápida con Meta (WhatsApp Cloud API) Configuración manual (WhatsApp Cloud API) Twilio Esfuerzo de configuración Unos minutos en una ventana de Meta. Sin configuración de desarrollador. App de Meta, token de usuario del sistema y webhook Cuenta de Twilio, credenciales y webhook Seguir usando la app WhatsApp Business en tu teléfono ✅ (Coexistencia) ❌ ❌ Mensajes de plantilla ✅ ✅ ✅ Plantillas de contenido Twilio Campañas ✅ ✅ ❌ Encuestas CSAT después de 24 horas ✅ ✅ ✅ Llamadas ✅ ✅ ❌ Pestaña de salud de la cuenta ✅ ✅ ❌ Disponible en Chatwoot Cloud Cloud y autohospedado Cloud y autohospedado ¿Usas 360dialog? 360dialog ya no está disponible para nuevas bandejas de entrada. Las bandejas existentes de 360dialog siguen funcionando para conversaciones pero no pueden usar campañas, llamadas o plantillas CSAT. Cómo comprobar lo que tienes - Tipo de tu bandeja: ve a Configuración › Bandejas de entrada y abre tu bandeja de WhatsApp. Una pestaña de Salud de la cuenta significa que es una bandeja WhatsApp Cloud API. - Configuración rápida: en la pantalla de configuración de WhatsApp, una casilla de Solicitar acceso en lugar del botón de conectar significa que la Configuración rápida aún no está activa para tu cuenta. - Campañas: WhatsApp bajo Campañas en la barra lateral significa que las campañas están disponibles para tu cuenta. - Llamadas: una pestaña de Llamadas en la configuración de la bandeja significa que las llamadas están disponibles para tu cuenta. Tu recorrido por esta guía 1. Conectar: Elige cómo conectar WhatsApp, luego la página para tu método (3, 4 o 5). 2. Aprende la única regla que define WhatsApp: Plantillas y la ventana de 24 horas. 3. Agrega lo que necesitas: campañas (8), CSAT (9), llamadas (10). 4. Manténlo saludable: Administra tu número de WhatsApp. 5. Cuando algo falla: Soluciona problemas de WhatsApp.
Elige cómo conectar WhatsApp
¿Qué método es adecuado para ti? Tu situación Usar Estás en Chatwoot Cloud y conectando un número nuevo Configuración rápida con Meta (página 3) Tu número está en la app WhatsApp Business y quieres seguir usando la app en tu teléfono Configuración rápida con Meta y elige conectar tu app existente (página 3). Esto se llama Coexistencia. Tu número ya está en la Plataforma WhatsApp Business (API) , eres un proveedor tecnológico agregando tu propio número, o eres auto-hospedado Configuración manual (página 4) Ya envías SMS o WhatsApp a través de Twilio y quieres seguir facturando allí Twilio (página 5). Ten en cuenta que las campañas y llamadas no están disponibles con Twilio. ¿No estás seguro de qué funciones necesitas? Consulta Tu método de conexión decide qué puedes usar en WhatsApp en Chatwoot. Antes de empezar (todos los métodos) - Eres administrador en Chatwoot. - Para WhatsApp Cloud API: puedes iniciar sesión en Facebook con una cuenta que sea admin de la cartera empresarial de Meta que posee (o poseerá) la cuenta de WhatsApp Business. - Tu número puede recibir un SMS de verificación o llamada de voz. Los teléfonos fijos necesitan verificación por voz. Los números que responden con un menú telefónico automatizado (IVR) no son compatibles con Meta. - Tienes tus datos comerciales listos y un nombre visible que siga las directrices de nombres de Meta. Consulta Nombre visible en Gestiona tu número de WhatsApp. ¿Puedo cambiar de método más tarde? - Configuración rápida a configuración manual: posible en algunos casos, sin perder conversaciones. El soporte de Chatwoot verifica la elegibilidad primero y no está disponible para números que usan Coexistencia (la app WhatsApp Business). Consulta Mover una bandeja de configuración rápida a configuración manual. - Configuración manual a configuración rápida: no está disponible desde el panel de control. - Entre Twilio y WhatsApp Cloud API: esto implica crear una nueva bandeja. Las conversaciones permanecen en la bandeja anterior. Empezar Ve a Configuración › Bandejas de entrada › Agregar bandeja de entrada › WhatsApp. Verás dos opciones: - WhatsApp Cloud: Configuración rápida con Meta (o configuración manual, mediante el enlace en la parte inferior de esa pantalla) - Twilio
Conéctate con la configuración rápida de Meta
Configuración rápida con Meta (también llamada Registro Embebido) conecta tu número a través de una ventana de Meta. Chatwoot configura automáticamente el webhook, el token y el número de teléfono por ti. Plan y acceso - Solo Chatwoot Cloud. Incluido desde el plan Startups. Durante la prueba gratuita, haz clic en Solicitar acceso, describe cómo usarás WhatsApp y haz clic en Enviar para activarlo. WhatsApp no está disponible en el plan gratuito Hacker. Consulta Precios y Planes. - Solo Administradores. Antes de empezar - Inicia sesión en Facebook con una cuenta que sea administrador del portafolio de negocios correcto de Meta. - Permite ventanas emergentes para Chatwoot y Facebook. - Mantener la app WhatsApp Business (Coexistencia): actualiza la app a la versión más reciente y mantén el teléfono en línea. La coexistencia funciona con la app WhatsApp Business, no con la app personal de WhatsApp. Meta decide qué números son elegibles. Conecta tu número 1. Ve a Configuración › Bandejas de entrada › Agregar bandeja de entrada › WhatsApp y elige WhatsApp Cloud. 2. Haz clic en Conectar con WhatsApp Business. Se abrirá una ventana de Meta. 3. En la ventana de Meta, inicia sesión y luego elige o crea tu portafolio de negocios y la Cuenta de WhatsApp Business. 4. Elige tu número: - Un número nuevo: introdúcelo y verifícalo con el código que Meta envía por SMS o llamada de voz. - Un número en la app WhatsApp Business (Coexistencia): elige conectar tu app existente, luego: 1. Copia el código de verificación que aparece en la ventana de Meta. 2. En tu teléfono, abre el mensaje de Facebook Business, toca Conectar, luego Conectar a la Plataforma Empresarial. 3. Pulsa Confirmar y elige si deseas compartir tu historial de chats. 4. Ingresa el código copiado en la app y después termina los pasos en la ventana de Meta. 5. Cuando veas ¡Cuenta de WhatsApp Business conectada!, agrega los agentes que deban responder en esta bandeja de entrada. Pruébalo: envía un mensaje de WhatsApp a tu número de empresa desde otro teléfono. Debería aparecer como una nueva conversación. Responde desde Chatwoot y verifica que llegue. Si tienes Coexistencia, también revisa que la app en tu teléfono siga funcionando. ¿Qué sucede después? - Plantillas aprobadas en tu Cuenta de WhatsApp Business se sincronizan automáticamente con Chatwoot. Consulta Plantillas y la ventana de 24 horas. - Llamadas: si las llamadas están disponibles en tu plan, Chatwoot intentará activarlas durante la configuración. Si tu número no está inscrito en la API de Llamadas de Meta, la bandeja de entrada igual se crea y puedes activar las llamadas más tarde. Consulta Llamadas de WhatsApp. - Historial de chats (Coexistencia): Meta sincroniza el historial solo dentro de las 24 horas posteriores a la conexión. Mantén la app abierta con una conexión estable. Los historiales grandes toman más tiempo. - Revisiones de Meta: Es posible que Meta te pida verificar tu empresa (subir documentos) y revisará el nombre mostrado. Monitorea ambos en Salud de la Cuenta. Consulta Administra tu número de WhatsApp. Si la Configuración rápida no está disponible A veces Meta restringe la Configuración rápida para todos los proveedores. Chatwoot mostrará un aviso en la pantalla de configuración. Durante ese tiempo: - Los números ya en la API de WhatsApp Cloud pueden usar la configuración manual. Consulta Conectar con WhatsApp Cloud API (configuración manual). - Los números que usan Coexistencia no se pueden conectar hasta que la restricción termine. ¿Algo salió mal? Consulta Conexión en Solucionar problemas de WhatsApp. Cubre todos los códigos de error de Meta que podrías ver durante este flujo.
Conectar con la API en la nube de WhatsApp (configuración manual)
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 1. 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.) 2. 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. 3. 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. 4. 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. 5. 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. 6. 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.
Conecta WhatsApp a través de Twilio
Conecta un número de WhatsApp que administres en Twilio. Es útil si ya usas Twilio para SMS o WhatsApp y deseas mantener la facturación allí. Plan y acceso - Cualquier plan que incluya WhatsApp (Startups y superiores, y la prueba gratuita) en Chatwoot Cloud, y autoalojado. Ver Precios y Planes. - Solo Administradores. - Con Twilio puedes enviar plantillas (plantillas de contenido Twilio) y encuestas CSAT. No puedes usar campañas de WhatsApp ni llamadas de WhatsApp. Consulta la tabla en WhatsApp en Chatwoot. Antes de empezar - Una cuenta de Twilio con un remitente de WhatsApp (número) aprobado en Twilio. - Tu Account SID y Auth Token de Twilio, o un API Key SID y API Key Secret. - Opcional: un Messaging Service SID, si envías a través de un Servicio de mensajería de Twilio. Para obtener uno, en la Consola de Twilio ve a Messaging › Services › Create Messaging Service, completa los pasos y luego copia el SID del servicio. - Si usas Twilio Studio, no reemplaces tu webhook con el Callback URL de Chatwoot. Esto detendrá tu flujo de Studio. Contacta primero al soporte. Conecta tu número 1. Ve a Settings › Inboxes › Add Inbox › WhatsApp y elige Twilio. 2. Ingresa un Nombre de Bandeja. 3. Ingresa el Número de Teléfono, comenzando con + y sin espacios. Si envías a través de un Servicio de mensajería, activa Use a Twilio Messaging Service y, en su lugar, ingresa el Messaging Service SID. El campo Phone Number se oculta cuando esto está activado. Debes ingresar uno u otro, no ambos. 4. Ingresa tu Account SID y, ya sea tu Auth Token o (después de activar Use API Key Authentication) tu API Key SID y API Key Secret. 5. Verifica que hayas ingresado el Número de Teléfono o, con Use a Twilio Messaging Service activado, el Messaging Service SID (ver paso 3). 6. Haz clic en Create Twilio Channel y luego agrega agentes. 7. Copia el Callback URL que aparece en Chatwoot y configúralo como el webhook de mensajes entrantes en la Consola de Twilio: - Para un remitente de WhatsApp: ve a Messaging › Senders › WhatsApp Senders y selecciona tu remitente. En Endpoint configuration, establece la URL del webhook para mensajes entrantes con el Callback URL y guarda. - Para un Servicio de mensajería: ve a Messaging › Services, selecciona tu servicio, luego Integration, y pega allí la URL. Para encontrar el Callback URL más tarde, ve a Settings › Inboxes, abre tu bandeja y selecciona la pestaña de Configuration. Pruébalo: envía un mensaje de WhatsApp a tu número desde otro teléfono y verifica que llegue a Chatwoot. Responde y revisa si llega al teléfono. Qué sucede después - Plantillas: las plantillas de contenido aprobadas de Twilio se sincronizan con Chatwoot. Consulta Plantillas de contenido Twilio en Plantillas y la ventana de 24 horas.
Mover una bandeja de entrada de configuración rápida a configuración manual
Vuelva a conectar una bandeja de entrada creada con Configuración rápida para que use su propia aplicación de Meta. Su bandeja de entrada, conversaciones y configuraciones se mantienen tal como están. Cuándo haría esto Chatwoot muestra un banner de Configuración manual recomendada en la bandeja de entrada cuando las restricciones de Meta en la aplicación compartida de Configuración rápida podrían afectarla. Conectarse a través de su propia aplicación de Meta protege la bandeja de entrada de esas restricciones. Plan y acceso - Chatwoot Cloud Precios y planes, solo administradores. - Disponible cuando aparece el banner de Configuración manual recomendada en la configuración de la bandeja de entrada. El banner no es una configuración que pueda activar: aparece para las bandejas de entrada de WhatsApp Cloud creadas con Configuración rápida (Registro incrustado) una vez que su cuenta ha sido habilitada, el número no utiliza Coexistencia, y la conexión no tiene error de autorización. Contacte al soporte para que su bandeja de entrada sea evaluada. - No para números en Coexistencia. Si su número también se utiliza en la aplicación WhatsApp Business, contacte al soporte antes de hacer cualquier cosa. Qué cambia y qué permanece igual Permanece igual Se actualiza Conversaciones, contactos, colaboradores, enrutamiento, horario de atención, configuraciones de CSAT y bot, y el número telefónico visible para clientes ID de cuenta comercial de WhatsApp, ID de número de teléfono y token de acceso El webhook para su propia aplicación de Meta no se configura automáticamente. Contacte al soporte antes de comenzar, para que el webhook se configure para su aplicación de Meta antes de mover la bandeja de entrada. Después del traslado, pruébelo como se describe en Compruebe que funciona Antes de comenzar Tenga lista su aplicación de Meta, ID de número de teléfono, ID de cuenta comercial de WhatsApp y token de acceso permanente. Siga los pasos 2 a 4 en Conectar con WhatsApp Cloud API (configuración manual). Su token debe incluir whatsapp_business_messaging. Agregue también whatsapp_business_management o las plantillas no se sincronizarán. Mover la bandeja de entrada 1. Vaya a Configuración › Bandejas de entrada y abra la bandeja de entrada de WhatsApp. 2. En el banner Configuración manual recomendada, haga clic en Iniciar migración manual. 3. Antes de comenzar: lea lo que se conservará y se actualizará, luego continúe. 4. Detalles del negocio: ingrese el ID de WABA y el ID del número de teléfono. El Número de teléfono visible se muestra solo como referencia y no puede cambiarse. 5. Token de acceso: pegue su token de acceso permanente. 6. Revisar migración: verifique los detalles y haga clic en Reconectar bandeja de entrada de WhatsApp. Chatwoot verifica su token, cuenta y número con Meta antes de realizar cualquier cambio. Si alguna verificación falla, la bandeja de entrada mantiene su conexión actual. Compruebe que funciona - Un nuevo mensaje de cliente llega a la bandeja de entrada - Una respuesta desde Chatwoot llega al teléfono del cliente - Puede enviar una plantilla - Sincronizar plantillas en la pestaña de Configuración trae sus plantillas
Plantillas y la ventana de 24 horas
La ventana de 24 horas WhatsApp te permite enviar cualquier mensaje durante 24 horas después del último mensaje del cliente. Después de eso, solo puedes enviar una plantilla: un mensaje que Meta ha aprobado previamente. - En Chatwoot, cuando la ventana se ha cerrado, el cuadro de respuesta muestra: Solo puedes responder utilizando un mensaje de plantilla debido a la restricción de la ventana de mensajes de 24 horas - Tan pronto como el cliente responda, se abre una nueva ventana de 24 horas y puedes escribir libremente de nuevo. - Para iniciar una conversación con un cliente que no te ha escrito, también necesitas una plantilla. Plan y acceso - Todos los planes que incluyen WhatsApp (Startups y superiores, y la prueba gratuita). Funciona con bandejas de entrada de WhatsApp Cloud API (Configuración rápida o manual) y bandejas de entrada de Twilio. Consulta Precios y planes. - Los agentes en la bandeja de entrada pueden enviar plantillas. Los administradores pueden sincronizar plantillas y administrar tokens. De dónde provienen las plantillas Las plantillas se crean y aprueban fuera de Chatwoot, luego se sincronizan. Tipo de bandeja Crear plantillas en Sincronizar en Chatwoot WhatsApp Cloud API WhatsApp Manager ( Herramientas de la cuenta › Plantillas de mensajes ). Meta las revisa, usualmente en 24 horas. Automáticamente después de un tiempo o de inmediato con Sincronizar plantillas en la pestaña Configuración de la bandeja Twilio Consola de Twilio (Content Template Builder), luego enviadas a WhatsApp para su aprobación Automáticamente, o con el botón de sincronización en la configuración de la bandeja Solo las plantillas aprobadas de un tipo soportado aparecen en Chatwoot. Enviar una plantilla en una conversación 1. Abre la conversación y haz clic en el icono de plantilla en el cuadro de respuesta. 2. Se abre el selector de Plantillas de WhatsApp. Busca y selecciona una plantilla. 3. Rellena las variables, por ejemplo, el nombre del cliente o un número de pedido. Para encabezados multimedia, pega una URL pública a la imagen, video o documento. 4. Revisa el mensaje, que se actualizará a medida que completes las variables, y haz clic en Enviar mensaje. Pruébalo: envía una plantilla primero a tu propio número y revisa cómo se ve en el teléfono. De qué se compone una plantilla Las plantillas pueden incluir encabezado, cuerpo, pie de página y botones: - Encabezado: texto, imagen, video o documento - Cuerpo: tu mensaje, con variables como el nombre del cliente - Pie de página: una línea corta de texto - Botones: respuestas rápidas, enlaces a sitios web, números de teléfono y copiar código Algunos tipos de plantillas de WhatsApp aún no pueden usarse en Chatwoot: plantillas de autenticación (OTP), listas, productos y catálogo, carrusel, encabezados de ubicación, permisos de llamada, y formularios, pagos y Flows. Multimedia en un encabezado de plantilla El archivo debe estar en un enlace público al que Meta pueda acceder, sin necesidad de inicio de sesión. Límites de Meta: Tipo Formatos Tamaño máximo Imagen JPEG, PNG 5 MB Video MP4, 3GPP (video H.264, audio AAC) 16 MB Documento PDF 100 MB Otros tipos de documentos, como Word, Excel, PowerPoint y archivos de texto, pueden enviarse como mensajes normales dentro de una conversación, pero no en un encabezado de plantilla. Las plantillas de contenido Twilio soportan texto (hasta 100 variables), multimedia, respuestas rápidas y plantillas de llamada a la acción. No pueden usarse en campañas. Las plantillas de listas, catálogo y carrusel no están soportadas. - Usa variables numeradas, como 1, 2, 3, en orden y sin saltos. La cantidad de variables que completes debe coincidir con la plantilla. - Revisa el estado de aprobación de una plantilla en la Consola de Twilio, no en WhatsApp Manager. - Si la sincronización falla, verifica que el Account SID y el Auth Token (o API Key SID y API Key Secret) de la bandeja de entrada sigan siendo válidos en Twilio, luego sincroniza de nuevo. Buenas prácticas - Las plantillas de utilidad (actualizaciones de pedido, recordatorios) son para mensajes transaccionales. Las plantillas de marketing requieren el consentimiento del cliente y seguir las reglas de envío de Meta. - Mantén un conjunto pequeño de plantillas bien nombradas que tu equipo sepa usar. - Meta supervisa la calidad de los mensajes. Si muchos mensajes son bloqueados o ignorados, puede limitar tu capacidad de envío de mensajes. Consulta Límite de mensajes en Administra tu número de WhatsApp. Si las plantillas no se sincronizan (bandejas de configuración rápida) A veces los mensajes siguen funcionando pero las plantillas no se sincronizan. Esto ocurre cuando la conexión realizada durante la Configuración rápida pierde el permiso para leer tu cuenta de WhatsApp Business. Puedes solucionarlo concediendo a Chatwoot un token de administración empresarial, utilizado solo para sincronizar plantillas. Plan y acceso: Chatwoot Cloud, solo bandejas de configuración rápida (incluyendo Coexistencia). Las bandejas de configuración manual usan su propio token, así que verifica que dicho token tenga whatsapp_business_management en su lugar. Debes ser administrador tanto en Chatwoot como en la cartera empresarial de Meta. 1. En Configuración empresarial de Meta, ve a Usuarios › Usuarios del sistema y selecciona (o crea) un usuario del sistema con rol de administrador. Uno dedicado, como Chatwoot template sync, es más fácil de administrar. 2. Haz clic en Asignar activos, elige Cuentas de WhatsApp, selecciona la cuenta de WhatsApp Business conectada a Chatwoot y otorga control total. Asigna solo esa cuenta. 3. Haz clic en Generar token, elige la aplicación de Meta vinculada a esa cuenta de WhatsApp y selecciona una caducidad (60 días es más seguro; Nunca requiere menos mantenimiento). 4. Selecciona solo whatsapp_business_management y copia el token. Es posible que Meta solo lo muestre una vez. 5. En Chatwoot, ve a Configuración › Bandejas de entrada, abre la bandeja, ve a la pestaña Configuración y busca Agregar token de administración empresarial. Pega el token y haz clic en Agregar. 6. Haz clic en Sincronizar plantillas. Trata el token como una contraseña. Si lo revocas en Meta, reemplázalo en Chatwoot o la sincronización de plantillas se detendrá. - Token de 60 días: la sincronización de plantillas se detendrá cuando expire. Genera un nuevo token y reemplaza el anterior. - Token sin expiración: aún puede dejar de funcionar si cambias el usuario del sistema, la aplicación, el permiso o la asignación de activos. - Para reemplazar un token: una vez que se guarda un token, el campo mostrará Reemplazar token de administración empresarial. Pega el nuevo token y haz clic en Reemplazar.
Campañas de WhatsApp
Envía una plantilla aprobada a cada contacto con las etiquetas que elijas, en una hora programada, y ve quién la recibió y leyó. Plan & acceso - Chatwoot Cloud: Las campañas de WhatsApp están disponibles en el plan Business y superiores. Están activadas automáticamente; no necesitas solicitarlas. - Self-hosted: Funciona en todos los planes. - Analítica de campañas: Plan Business y superiores en Cloud. En self-hosted, solo plan Enterprise. El superadministrador de tu instalación activa Analítica de Campañas en Super Admin › Cuentas › abre la cuenta › Editar, bajo Funciones premium, luego hace clic en Guardar cambios. - Buzón: Solo API de WhatsApp Cloud (configuración rápida o manual). Los buzones de Twilio y 360dialog no pueden enviar campañas. - Quién: administradores. Consulta Precios & Planes. Cómo comprobar si lo tienes: abre Campañas en la barra lateral. Si WhatsApp aparece debajo, las campañas están disponibles en tu cuenta. Antes de comenzar Al menos una plantilla aprobada en tu buzón de WhatsApp Cloud API. Consulta Plantillas y la ventana de 24 horas. Crear una campaña 1. Ve a Campañas › WhatsApp y haz clic en Crear campaña. 2. Configuración básica: ingresa un Título y elige tu Buzón de WhatsApp. El panel de Información de la cuenta muestra el nivel de mensajería del número, estado de la cuenta y calificación de calidad de Meta. 3. Audiencia: elige una o más Etiquetas. Se incluyen los contactos con cualquiera de las etiquetas. Haz clic en Ver para saber exactamente quién está incluido. El panel muestra cuántos clientes puede contactar tu cuenta de WhatsApp. 4. Plantilla: elige una plantilla aprobada y completa el encabezado, variables y botones. Revisa la Vista previa del mensaje. 5. Haz clic en Programar campaña, elige una hora y haz clic en Crear. Pruébalo: envía la primera campaña a una etiqueta de prueba que contenga solo tu propio número. El botón Prueba en vivo en la parte superior del formulario aún no está disponible (su tooltip dice La prueba en vivo estará disponible pronto). Qué esperar - La campaña se envía una vez, en la hora programada. Su estado pasa de Programada a En proceso a Completada. - Puedes editarla mientras está Programada. Una vez que comienza el envío, ya no se puede modificar. - Los contactos sin número de teléfono se omiten. - Solo se pueden enviar plantillas aprobadas. No es posible enviar mensajes sin plantilla en WhatsApp. - La cantidad de clientes a los que puedes enviar mensajes en un día la establece el límite de mensajería de Meta, compartido entre todos los números de tu portafolio empresarial. Consulta Gestiona tu número de WhatsApp. - Cuando los clientes responden, se abre una nueva conversación en el buzón y comienza la ventana de 24 horas. - Los mensajes de campaña enviados a un contacto aparecen en su conversación de WhatsApp, marcados como Campaña. Ver resultados La analítica está disponible en el plan Business y superiores (Cloud), o un plan de pago self-hosted. Haz clic en Ver analítica en la campaña para ver: - Audiencia, Enviado a WhatsApp, Entregado, Leído, Fallido y Omitido - La tabla de Entregas: estado de cada contacto y, en caso de fallos u omisiones, el Motivo. Filtra por estado. - Mientras una campaña está enviándose, los números son parciales. Las campañas enviadas antes de la introducción de la analítica de campañas no tienen análisis. Puede que no haya analítica para campañas enviadas antes de la introducción del seguimiento de entregas. Buenas prácticas - Crea una etiqueta dedicada para cada campaña en lugar de reutilizar una general. - Utiliza plantillas de Utilidad para notificaciones y plantillas de Marketing solo para contactos que dieron su consentimiento. - Observa la calificación de calidad después de cada campaña. Muchos bloqueos o reportes pueden reducir tu límite de mensajería. Solucionar problemas Síntoma Causa probable Qué hacer No aparece WhatsApp bajo Campañas Tu plan no incluye campañas, o no eres administrador En Chatwoot Cloud, comprueba que tienes el plan Business o superior. Verifica que has iniciado sesión como administrador. Si ambas son ciertas y la pestaña sigue sin aparecer, contacta al soporte de Chatwoot. Mi buzón no está en la lista Es un buzón de Twilio o 360dialog Las campañas requieren un buzón de WhatsApp Cloud API. Consulta Elige cómo conectar WhatsApp Este buzón no tiene plantillas aprobadas que se puedan usar en una campaña No hay plantillas aprobadas, o no se han sincronizado Haz clic en Sincronizar plantillas . Consulta Plantillas y la ventana de 24 horas Algunos contactos no la recibieron Sin número de teléfono, etiqueta ausente, o Meta rechazó el mensaje Abre Ver analítica , filtra por Fallido u Omitido , y lee el motivo. Para los códigos de error consulta No puedo editar la campaña Ya ha empezado el envío Crea una nueva campaña Solucionar problemas de WhatsApp
Encuestas CSAT en WhatsApp
Pida a los clientes que califiquen su soporte cuando se resuelva una conversación, incluso después de que haya pasado la ventana de 24 horas. Chatwoot crea la plantilla de WhatsApp por usted, la envía a Meta y la manda una vez que está aprobada. Plan y acceso - Cualquier plan que incluya WhatsApp (Startups y superiores, y la prueba gratuita). Funciona con las bandejas de entrada de WhatsApp Cloud API y Twilio. Consulte Precios y Planes . - Los administradores lo configuran. Configúrelo 1. Vaya a Configuración › Bandejas de entrada, abra su bandeja de entrada de WhatsApp y vaya a la pestaña CSAT. 2. Active Habilitar CSAT. 3. Rellene el Mensaje, el Texto del botón y el Idioma. La vista previa muestra cómo se verá en WhatsApp. 4. Guarde. Chatwoot crea la plantilla y la envía a Meta para su revisión. 5. Espere a que el estado muestre Aprobado por WhatsApp. Opcional: haga clic en Verificar utilidad para ver si es probable que Meta trate su mensaje como de Utilidad, junto con una sugerencia de reescritura. Es una orientación, no una garantía. Opcional: elija qué conversaciones recibirán una encuesta utilizando reglas de etiquetas. Pruébelo: resuelva una conversación de prueba con su propio número. Debería recibir la encuesta con un botón que abre la página de calificación. Estados de la plantilla Estado Significado Pendiente de aprobación de WhatsApp Meta está revisando la plantilla Aprobado por WhatsApp Las encuestas se envían automáticamente cuando se resuelven las conversaciones Meta rechazó la plantilla Meta la rechazó. Modifique el mensaje y guarde para reenviarla. Qué esperar - Una encuesta por conversación. - Hasta que la plantilla sea aprobada, la encuesta se envía como un mensaje normal solo mientras la ventana de 24 horas está abierta. Si la ventana está cerrada, no se envía la encuesta y la conversación muestra Encuesta CSAT no enviada debido a restricciones de mensajes salientes. - Meta no permite la edición de plantillas aprobadas. Cuando cambie el mensaje, el texto del botón o el idioma, Chatwoot le pedirá confirmación, eliminará la plantilla actual y enviará una nueva para su aprobación. Hasta que Meta la apruebe, las encuestas seguirán la regla anterior. Si el guardado falla, guarde de nuevo, ya que la plantilla anterior puede ya estar eliminada. Buenas prácticas - Mantenga el mensaje corto y amable, con un texto de botón claro como "Calificar ahora". - Use reglas de etiquetas para que solo las conversaciones significativas reciban una encuesta. - Cambie la plantilla solo ocasionalmente. Cada cambio pausa las encuestas de la plantilla hasta que Meta apruebe la nueva.
Llamadas de WhatsApp
Los clientes pueden llamar a tu empresa desde WhatsApp, y los agentes responden en su navegador. Los agentes también pueden llamar a los clientes que han aceptado recibir llamadas. Plan y acceso - Chatwoot Cloud: plan Business y superiores. Autohospedado: un plan de pago con la Enterprise Edition, desde la v4.15.0. Instalar simplemente la Enterprise Edition no lo habilita. Consulta Precios y Planes. - Buzón: solo API de WhatsApp Cloud. Ambos métodos de conexión funcionan, configuración rápida y configuración manual. No disponible para buzones de Twilio o 360dialog WhatsApp. - Tu número debe estar inscrito en la API de Llamadas de WhatsApp Business de Meta. - Los administradores lo activan. Los agentes en el buzón reciben y realizan llamadas. Cómo comprobar si lo tienes: abre la configuración del buzón. Una pestaña de Llamadas significa que las llamadas están disponibles para tu cuenta. Activar las llamadas Nuevo buzón: ve a Configuración › Buzones › Agregar buzón › Llamada de WhatsApp y completa la configuración rápida. Chatwoot activa las llamadas durante la configuración. Buzón existente: 1. Ve a Configuración › Buzones, abre tu buzón de WhatsApp y ve a la pestaña Llamadas. 2. Activa Habilitar llamadas de WhatsApp. 3. Opcional: edita el mensaje de solicitud de permiso de llamada que los clientes ven cuando les pides llamarles. 4. Opcional: ajusta los otros interruptores en la pestaña Llamadas: - Permitir llamadas entrantes: si está desactivado, las llamadas entrantes se rechazan automáticamente, los agentes no reciben notificación y no se crea ninguna conversación. Las llamadas salientes siguen funcionando. - Grabar llamadas: adjunta la grabación de cada llamada a la conversación. - Transcribir grabaciones: se muestra cuando la grabación está activada. Añade una transcripción usando Captain y necesita que la transcripción de audio esté activada en tu cuenta. Si ves No se pudo habilitar la llamada de voz para este número, tu número aún no está inscrito en la API de Llamadas de Meta. Pídele a Meta o a tu Proveedor de Soluciones de WhatsApp Business que lo inscriba y vuelve a intentarlo. Antes de tu primera llamada: cada agente debe permitir el acceso al micrófono para Chatwoot en su navegador. Pruébalo: desde otro teléfono, abre WhatsApp, encuentra tu empresa y toca llamar. Debería aparecer una notificación de llamada en Chatwoot. Recibir y realizar llamadas - Entrante: una ventana de llamada muestra el nombre del llamante, número y el buzón. Los agentes pueden unirse o rechazar la llamada. - Saliente: en una conversación, haz clic en Iniciar llamada de WhatsApp. Si el cliente no ha aceptado recibir llamadas, Chatwoot le envía una solicitud de permiso para llamada: Se envió una solicitud de permiso de llamada al contacto. Intenta de nuevo cuando acepte. Una vez que acepte, llama de nuevo. - Estados de llamada mostrados en la conversación: Llamada entrante, Llamada saliente, Llamada en curso, Llamada finalizada, Llamada perdida, Sin respuesta. - Grabaciones se adjuntan a la conversación cuando están disponibles. Transcripciones se añaden si tu cuenta tiene la transcripción de audio de Captain activada. Quién recibe la llamada - Conversación asignada: solo suena la ventana de llamada del asignado, sin importar su estado de disponibilidad. - Conversación no asignada: suenan los agentes del buzón que estén en En línea. - Nadie en línea: suenan todos los agentes del buzón y todos los administradores. El primer agente en unirse atiende la llamada. Si la conversación no tiene asignado, el agente que se une se asigna a ella. Cuando un agente inicia una llamada, la conversación se le asigna si aún no tiene asignado. Buenas prácticas - Pide el permiso para llamar al inicio de la conversación, no en el momento en que lo necesitas. - Asegúrate de que los agentes que reciben llamadas estén en línea, para que no se pierdan llamadas. Solución de problemas Síntoma Causa probable Qué hacer No hay pestaña Llamadas Tu plan no incluye llamadas (Business o superior), o el buzón no es WhatsApp Cloud API Revisa tu plan en Precios y Planes y tu método de conexión en WhatsApp en Chatwoot No se pudo habilitar la llamada de voz El número no está inscrito en la API de llamadas de Meta Pídele a Meta o a tu proveedor que lo inscriba y vuelve a intentarlo El agente no puede oír ni ser oído El navegador no tiene permiso para el micrófono Permite el acceso al micrófono para Chatwoot en la configuración del navegador Ya se envió una solicitud de permiso de llamada recientemente El cliente no ha respondido a la última solicitud Espera a que el cliente acepte antes de intentarlo de nuevo
Administra tu número de WhatsApp
Vea la salud de su número, el límite de mensajes y el perfil empresarial sin salir de Chatwoot. Plan y acceso - Todos los planes que incluyen WhatsApp (Startups y superiores, y la prueba gratuita), para los buzones de WhatsApp Cloud API (configuración rápida o manual). Los buzones de Twilio no tienen esta pestaña. consulte Precios y Planes - Administradores. Abrir salud de la cuenta Vaya a Ajustes › Buzones, abra su buzón de WhatsApp y elija la pestaña Salud de la cuenta. Haga clic en Ir a Meta Business Manager para cambiar cualquier cosa que sea gestionada por Meta. Lo que verá Sección Qué le indica Perfil empresarial La descripción, dirección, correo electrónico y sitios web que los clientes ven en su perfil de WhatsApp. Aquí son solo de lectura: cámbielos en las herramientas de administración de WhatsApp de Meta. Número de teléfono Número mostrado, nombre de pantalla de WhatsApp y su estado de revisión, estado del número, si la Convivencia está activada, y el ID del número Salud y capacidad Calificación de calidad (Verde, Amarillo, Rojo), Límite de mensajes empresariales , modo de la cuenta (Sandbox o Activa) y capacidad de envío Cuenta empresarial Nombre e ID de la Cuenta de WhatsApp Business, y el portafolio empresarial que la posee Configuración de Webhook Si la URL de callback de Meta para este número apunta a este buzón de Chatwoot. Webhook configurado correctamente solo confirma la configuración, no la llegada de mensajes. Si muestra Webhook no configurado o Diferencia de URL de Webhook , haga clic en Registrar Webhook , luego envíe un mensaje de prueba a su número y responda desde Chatwoot. Límite de mensajes El límite de mensajes empresariales lo establece Meta: cuántos clientes únicos puede contactar fuera de la ventana de 24 horas (usando plantillas) en un periodo continuo de 24 horas. Es compartido por todos los números en su portafolio empresarial. Meta lo aumenta mientras envía mensajes de buena calidad, y puede reducirlo si la calidad baja. Nombre de pantalla Su nombre de pantalla es el nombre de la empresa que ven los clientes. Meta lo revisa. Estado en Chatwoot Significado Aprobado Mostrado en la parte superior de los chats (puede mostrarse un nombre guardado por el cliente en su lugar) Aún no revisado Guardado, pero los clientes pueden ver su número hasta que Meta lo revise. Meta inicia la revisión cuando alcanza un mayor límite de mensajes. En revisión Meta lo está revisando. No lo cambie de nuevo hasta que finalice la revisión. No aprobado Meta lo rechazó. Cámbielo en Meta Business Manager y vuelva a enviarlo. Para que se apruebe la primera vez: use su nombre real de empresa o marca, coincide con su sitio web y Meta Business Manager. Evite palabras genéricas ("Soporte", "Oficial"), emojis, símbolos, slogans y exceso de mayúsculas. Después de un cambio de nombre de pantalla, es posible que Meta requiera que el número sea registrado nuevamente antes de que los mensajes fluyan normalmente. Vea Dejaron de llegar mensajes en vTroubleshoot WhatsApp. Si la conexión necesita atención - La conexión de WhatsApp necesita ser actualizada (buzones de configuración rápida): haga clic en Reconectar WhatsApp en el buzón, o vaya a Configuración y haga clic en Reconfigurar. Necesita acceso de administrador a la Cuenta de WhatsApp Business. - El token de acceso de WhatsApp necesita atención (buzones de configuración manual): vaya a Configuración y reemplace el token de acceso por un token permanente válido.
Solucionar problemas de WhatsApp
Antes de cambiar nada: no elimines tu cuenta de WhatsApp, no elimines tu Cuenta de WhatsApp Business ni desconectes un proveedor como solución general. La forma correcta de recuperar depende de cómo se encuentra configurado tu número hoy. Toma nota del mensaje completo de error, cualquier código y la pantalla donde apareció. Conexión Primero, conoce cómo se utiliza tu número hoy: un número nuevo, un número en la aplicación de WhatsApp Business (utiliza la Coexistencia para conservar la app), o un número en otro proveedor de API (estos utilizan diferentes rutas). Consulta Elegir cómo conectar WhatsApp. Lo que ves Código de Meta Lo que significa y qué hacer Número no elegible, necesita más actividad en la app de WhatsApp Business 3441045 Una verificación de elegibilidad para la Coexistencia. Sigue usando la app normalmente con clientes reales y vuelve a intentarlo más tarde. Meta no publica un mínimo. No generes actividad falsa ni recrees la cuenta. Número no registrado con la app de WhatsApp Business 2655095, 2655048 Verifica el número y el código de país, y que esté en la app Business (no en WhatsApp personal). Para un número nuevo solo para API, usa la ruta de número nuevo. Actualiza la aplicación 4563015 Instala la versión más reciente de la app de WhatsApp Business y vuelve a intentarlo. El negocio ya comparte esta cuenta con un socio 2655093 Meta informa que esta Cuenta de WhatsApp Business ya está asociada a un socio. Esto no confirma que el otro proveedor siga activo. No es posible cambiar de socio en este flujo. Contacta soporte antes de desconectar nada. Ya registrado con el producto, o desconecta tu plataforma de negocio 3441049, 2655094 Se debe manejar primero una conexión de plataforma existente. Si decides desconectar a propósito, Meta requiere esperar 15 minutos antes de intentarlo de nuevo. Número no asociado al negocio que seleccionaste 3441041 Elige el portafolio de negocio que posee el número. Número vinculado a una página de Facebook 2655082 Consulta Meta Business Suite › Configuración › Cuentas › Páginas . Elimina el vínculo con la página (después de confirmar con el administrador de la página) o utiliza otro número. La cuenta utiliza mensajes de marketing 3441047 Selecciona una Cuenta de WhatsApp Business diferente. Volver a intentarlo no lo soluciona. Negocio o cuenta restringida 2655089, 3441040, 2388107 Abre Meta Business Support Home , revisa la restricción y apela. No crees nuevas cuentas para evitarla. Verificación iniciada con otro socio 2494143 Continúa con ese socio, o solicita la Verificación de Negocio de Meta directamente. Funcionalidad no disponible en tu región 3441042 Verifica el código de país. Si es correcto, esta ruta aún no está disponible para ese número. Código no pudo ser enviado o verificado 2388091, 2388093 Verifica de nuevo el número y usa un método que pueda recibir (las líneas fijas requieren voz). Los números IVR no son compatibles. Otros problemas de conexión - Cuenta o portafolio ausente: inicia sesión con la cuenta de Facebook que sea administradora del portafolio correcto. "El usuario no tiene permiso" significa que un administrador existente debe conceder acceso. - Cuenta de Facebook demasiado nueva: espera algunas horas, o utiliza una cuenta establecida con acceso de negocio. - Verificación de empresa en proceso: verifica Meta Business Suite › Centro de Seguridad. - Nombre para mostrar rechazado: consulta Nombre para mostrar en Gestionar tu número de WhatsApp. - Se alcanzó el límite de números de teléfono: elige el número existente si ya está listado, o solicita a Meta un límite superior. No borres un número que funcione. - "Has adivinado demasiadas veces": espera unas 12 horas. "Solicitaste tu código demasiadas veces": sigue el tiempo de espera que muestre Meta. - La pantalla de Coexistencia o el código QR no funcionan: utiliza la última app de Business, mantén el teléfono en línea, deja la ventana de registro abierta y revisa el permiso de cámara para QR. - La ventana de Meta no abre o se detiene: permite ventanas emergentes, deshabilita extensiones de bloqueo, completa cualquier verificación de seguridad de Meta, y espera unos minutos tras un error temporal. - Meta terminó, pero no hay bandeja de entrada en Chatwoot: actualiza y revisa Configuración › Bandejas de entrada antes de volver a intentar. No crees bandejas duplicadas. - Historial de chat de Coexistencia incompleto: mantén la app abierta y conectada. Meta sincroniza el historial solo dentro de 24 horas de la conexión. Contacta soporte rápidamente en lugar de reconectar. Recepción y envío de mensajes Síntoma Causa probable Qué hacer Dejaron de llegar mensajes , pero el número muestra Conectado y calidad en Verde Algo en la conexión necesita atención: registro, permisos o el webhook. Usualmente ocurre tras un cambio de nombre o perfil. Tras la corrección, envía un mensaje de prueba a tu número y responde desde Chatwoot para verificar ambos sentidos. Contacta soporte primero para que podamos revisar el registro, permisos y webhook de tu bandeja existente. Si el número sí necesita registrarse de nuevo, debes hacerlo en Meta, siguiendo el proceso de registro de Meta. No elimines el número ni crees una nueva bandeja. Los números en Coexistencia requieren un proceso distinto, así que contacta soporte antes de hacer cambios. No llegan mensajes tras la configuración Una posible causa: el webhook no está registrado o está apuntando a otro lugar Abre Salud de la Cuenta . Si en Configuración del Webhook aparece Webhook no configurado o URL de Webhook no coincide , haz clic en Registrar Webhook . Luego pruébalo: envía un mensaje a tu número desde otro teléfono, revisa si llega a Chatwoot y responde desde Chatwoot. Si el webhook está configurado pero siguen sin llegar mensajes, contacta soporte. Para Twilio, revisa el Callback URL en Twilio (página 5). Sólo puedes responder usando un mensaje plantilla Han pasado más de 24 horas desde el último mensaje del cliente Envía una plantilla. Consulta Plantillas y la ventana de 24 horas Un mensaje falla con error 131049 Meta no entregó esta plantilla de marketing para proteger la participación. WhatsApp limita cuántos mensajes de marketing recibe cada persona de todos los negocios. No reenvíes ni hagas clic en Reintentar inmediatamente. Espera al menos 24 horas antes de enviar a esta persona otra plantilla de marketing. Las plantillas utilitarias no se ven afectadas. Si el cliente responde, los mensajes de marketing dentro de la ventana de 24 horas no cuentan para el límite. La conexión de WhatsApp necesita ser actualizada / Reconectar WhatsApp La conexión de Configuración rápida expiró Haz clic en Reconectar WhatsApp . Consulta Gestionar tu número de WhatsApp El token de acceso de WhatsApp necesita atención El token de configuración manual expiró o fue revocado Reemplázalo en la pestaña Configuración de la bandeja Plantillas Síntoma Causa probable Qué hacer Falta una plantilla en Chatwoot No ha sido aprobada aún, no está sincronizada, o es un tipo que Chatwoot no admite Revisa su estado en WhatsApp Manager y haz clic en Sincronizar Plantillas . Consulta los tipos compatibles en la página 7. Los mensajes funcionan pero las plantillas nunca se sincronizan (Configuración rápida) Se perdió el permiso de la conexión para leer tu Cuenta de WhatsApp Business Añade un token de administración empresarial (página 7) Token de administración empresarial: El token debe otorgar el permiso whatsapp_business_management No se seleccionó whatsapp_business_management Genera un nuevo token con ese permiso Token de administración empresarial: sin permiso de acceso o token inválido El usuario del sistema no tiene la cuenta de WhatsApp, el token expiró o pertenece a otra app Revisa los activos y la app asignados al usuario del sistema, y luego genera un nuevo token Token aceptado, pero siguen faltando plantillas El token accede a una Cuenta de WhatsApp Business diferente Confirma que el usuario del sistema tiene la cuenta exacta de la bandeja y que ahí existen las plantillas Una plantilla falla al enviar, o un archivo multimedia no se muestra Variables vacías, enlace de archivo privado o roto, o archivo excede los límites de Meta Rellena todas las variables, usa un enlace público, revisa formato y tamaño (página 7) Un botón de URL dinámica no funciona Problema conocido con algunos botones de URL dinámica Usa una URL estática en la plantilla Contactos y números de teléfono Los números se ven diferentes en WhatsApp y Chatwoot (Brasil, México, Argentina). Estos países cambiaron sus formatos de números móviles, y WhatsApp puede seguir usando el anterior: - Brasil: se añadió un 9 después del código de área (+55 11 9 8765-4321 vs +55 11 8765-4321). - Argentina: un 9 después del código de país puede estar presente o no (+54 9 11 ... vs +54 11 ...). - México: WhatsApp puede añadir un 1 después del código de país (+52 1 ... vs +52 ...). Chatwoot empareja automáticamente ambos formatos al mismo contacto, así que no deberías tener duplicados. El número puede simplemente verse diferente en los dos lugares. Contactar soporte Si sigues atascado, contacta al soporte de Chatwoot con: - El mensaje completo de error y código, y una captura de pantalla - El paso donde falló y si el error apareció en Meta o Chatwoot - El enlace a tu bandeja, el número de teléfono de empresa con código de país y la hora del intento con zona horaria - Cómo se utiliza el número: nuevo, app de WhatsApp Business u otro proveedor - Para Coexistencia: versión de la app, tiempo de uso y si sigue funcionando en el teléfono - Tu ID de portafolio de negocio, ID de Cuenta de WhatsApp Business y ID de Número de Teléfono, identificados Nunca compartas tu contraseña, token de acceso, código de verificación o PIN de dos pasos. Ocúltalos en capturas de pantalla. Chatwoot no puede anular las decisiones de Meta sobre restricciones o revisiones.