Solucionar problemas de WhatsApp | Guía del usuario

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.