Replynivo
es
Idioma
en English pt_BR Portuguese (Brazil) es Spanish de German fr French ar Arabic

Solucionar problemas de WhatsApp

Abrir en
Ver como Markdown Abrir en ChatGPT Abrir en Claude
Sojan

Sojan

Última actualización el Oct 28, 2026

Antes de cambiar nada: no elimines tu cuenta de WhatsApp, ni elimines tu cuenta de WhatsApp Business, ni desconectes un proveedor como solución general. La recuperación correcta depende de cómo está configurado tu número hoy. Anota el mensaje de error completo, cualquier código y la pantalla donde apareció.

Conexión

Primero, conoce cómo se usa tu número hoy: un número nuevo, un número en la aplicación WhatsApp Business (usa Coexistencia para conservar la app), o un número con otro proveedor de API (estos usan rutas diferentes). Consulta Elige cómo conectar WhatsApp.

Lo que ves Código de Meta Qué significa y qué hacer
El número no es elegible, necesita más actividad en la aplicación WhatsApp Business 3441045 Una verificación de elegibilidad para 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 aplicación 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 app 4563015 Instala la última versión de WhatsApp Business y vuelve a intentarlo.
La empresa ya comparte esta cuenta con un socio 2655093 Meta informa que esta cuenta de WhatsApp Business ya está asociada con un socio. Esto no confirma que el otro proveedor siga activo. No es posible cambiar de socio en este flujo. Si el número proviene de otro proveedor, consulta Error 2655093 después de cambiar de proveedor abajo. Contacta con soporte antes de desconectar nada.
Ya registrado con el producto, o desconecta tu plataforma empresarial 3441049, 2655094 Debe gestionarse primero una conexión existente de la plataforma. Para ver el socio conectado actualmente, revisa WhatsApp Business app › Configuración › Cuenta › Plataforma Empresarial, o Configuración de Negocios de Meta › Cuentas › Cuentas de WhatsApp › Socios. Si decides desconectarlo, Meta requiere esperar 15 minutos antes de reintentarlo.
Este número ya está registrado en una cuenta de WhatsApp existente El número está activo en la aplicación WhatsApp Business. Para seguir usando la app, conéctalo usando Coexistencia (consulta Conectar con configuración rápida con Meta). No uses la ruta de número nuevo, que elimina el número de la app.
Este número de teléfono ya existe en tu lista de números de teléfono Regresa y selecciona el número existente en la cuenta de WhatsApp Business correcta en lugar de agregarlo nuevamente.
Número no asociado a la empresa seleccionada 3441041 Elige la cartera empresarial que posee el número.
Número vinculado a una página de Facebook 2655082 Verifica Meta Business Suite › Configuración › Cuentas › Páginas. Elimina el enlace de la Página (después de confirmar con el administrador de la Página) o usa otro número.
La cuenta utiliza mensajes de marketing 3441047 Selecciona otra cuenta de WhatsApp Business. Reintentar no lo solucionará.
Empresa o cuenta restringida 2655089, 3441040, 2388107 Abre Meta Business Support Home, revisa la restricción y apela. No crees cuentas nuevas para evitarla.
La verificación se inició con otro socio 2494143 Continúa con ese socio o solicita la verificación empresarial de Meta directamente.
Función no disponible en tu región 3441042 Verifica el código de país. Si es correcto, este flujo aún no está disponible para ese número.
No se pudo enviar o verificar el código 2388091, 2388093 Revisa el número y usa un método que pueda recibir (las líneas fijas necesitan voz). Los números IVR no son compatibles.

Otros problemas de conexión

  • Falta cuenta o cartera: inicia sesión con la cuenta de Facebook que sea administradora de la cartera correcta. "El usuario no tiene permiso" significa que un administrador existente debe conceder acceso.

  • Cuenta de Facebook demasiado nueva: espera unas horas, o usa una cuenta establecida con acceso empresarial.

  • Verificación empresarial en progreso: revisa Meta Business Suite › Centro de seguridad.

  • Nombre visible rechazado: consulta Nombre visible en Gestiona tu número de WhatsApp.

  • Límite de números de teléfono alcanzado: selecciona el número existente si ya está listado, o pide a Meta un límite mayor. No elimines un número que funcione.

  • "Has adivinado demasiadas veces": espera unas 12 horas. "Has solicitado tu código demasiadas veces": sigue el tiempo de espera que muestra Meta.

  • Error 2655093 después de cambiar de proveedor: la línea de crédito del proveedor anterior aún puede estar adjunta a tu cuenta de WhatsApp Business. Eliminar el acceso del proveedor en tu propia Configuración de Negocios no siempre la libera. Para verificar, abre los Detalles de línea de crédito en WhatsApp Manager: Asignado por muestra el proveedor. Solicita a ese proveedor que libere la línea de crédito y luego intenta la Configuración rápida nuevamente. Si el error persiste, contacta soporte con el ID de tu cuenta de WhatsApp Business y los detalles del error.

    • No vuelvas a registrar el número en otra aplicación de WhatsApp para corregir este error. Volver a registrarlo interrumpe la mensajería; los mensajes que lleguen después de tu copia de seguridad pueden perderse y el historial restaurado en el teléfono no se importa a Chatwoot.

  • Conectando Coexistencia con un código QR: en lugar de un código de verificación para ingresar en la app, el flujo puede ofrecer Escanear código QR en su lugar. Si es así, usa el escáner y el código que el flujo indique, y mantén la ventana de Meta abierta hasta que termine. Si falla el escaneo, revisa permisos de cámara y usa el código actual. Si el flujo te pide un código enviado por SMS o llamada, detente: esa es la ruta de número nuevo, que elimina el número de la app.

  • El aviso de Coexistencia o el código QR no funcionan: usa la última app de Negocios, mantén el teléfono en línea, mantén abierta la ventana de registro y revisa el permiso de cámara para QR. No cambies a la ruta manual de registro de teléfono para saltar un paso fallido de Coexistencia.

  • La ventana de Meta no se abre o se detiene: permite ventanas emergentes, desactiva 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: recarga y revisa Configuración › Bandejas de entrada antes de intentarlo de nuevo. No crees bandejas duplicadas.

  • Faltan chats antiguos tras Coexistencia: esto es esperado. Chatwoot no importa chats previos a la conexión, incluso si elegiste compartir tu historial con Meta. Desde el momento en que conectas, los nuevos mensajes de clientes y respuestas enviadas desde WhatsApp Business aparecen en Chatwoot. No vuelvas a conectar para intentar importar chats antiguos.

Recibir y enviar mensajes

Síntoma Causa probable Qué hacer
Los mensajes dejaron de llegar, pero el número aparece Conectado y la calidad es Verde Algo en la conexión necesita atención: registro, permisos o el webhook. Suele pasar después de cambiar nombre visible o perfil. Después de cualquier corrección, envía un mensaje de prueba a tu número y responde desde Chatwoot para confirmar ambos sentidos. Contacta con soporte primero para que podamos revisar el registro, permisos y webhook en tu bandeja actual. Si el número realmente necesita ser registrado de nuevo, lo haces tú mismo en Meta, siguiendo su proceso. No elimines el número ni crees una bandeja nueva. Los números con Coexistencia requieren una recuperación diferente, así que contacta soporte antes de cambiar nada.
No llegan mensajes tras la configuración Una posible causa: el webhook no está registrado o apunta a otro sitio Abre Account Health. Si la Configuración de Webhook muestra Webhook not configured o Webhook URL mismatch, haz clic en Register Webhook. Luego pruébalo: envía un mensaje a tu número desde otro teléfono, verifica que llegue a Chatwoot y responde desde Chatwoot. Si el webhook se muestra configurado pero los mensajes no llegan, contacta soporte. Para Twilio, revisa la Callback URL en Conectar WhatsApp con Twilio.
Solo puedes responder con un mensaje de 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 131026 (Mensaje no entregable) WhatsApp no pudo entregar el mensaje. Causas comunes: el número no usa WhatsApp, el receptor no ha aceptado los últimos términos de WhatsApp, o su app está obsoleta. Solicita al receptor, por otro canal, que verifique el número y código de país, que no te haya bloqueado, que actualice la app y que acepte los términos; y que te envíe primero un mensaje de WhatsApp. No reconectes la bandeja ni registres de nuevo el número por este error.
Un mensaje falla con error 131049 Meta no entregó esta plantilla de marketing para proteger el engagement. WhatsApp limita cuántos mensajes de marketing recibe cada persona de todas las empresas. No reenvíes ni hagas clic en Retry de inmediato. Espera al menos 24 horas antes de enviar otra plantilla de marketing a esa persona. Si el cliente responde, los mensajes de marketing dentro de las 24h no cuentan para el límite.
La conexión de WhatsApp necesita ser actualizada / Tu bandeja está desconectada La conexión de Configuración rápida expiró Haz clic en Click here to reconnect en la barra. Consulta Gestiona tu número de WhatsApp
El token de acceso de WhatsApp necesita atención El token 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 soporta Verifica su estado en WhatsApp Manager (para bandejas Twilio, en la Consola de Twilio) y haz clic en Sync Templates. Revisa los tipos compatibles en Plantillas y la ventana de 24 horas.
Los mensajes funcionan pero las plantillas nunca se sincronizan (Configuración rápida) La conexión perdió permiso para leer tu cuenta de WhatsApp Business Agrega un token de gestión empresarial
Token de gestión empresarial: Business management token must grant the whatsapp_business_management permission No fue seleccionada la whatsapp_business_management Genera un token nuevo con ese permiso
Token de gestión empresarial: sin permiso de acceso, o token inválido El usuario del sistema no tiene la cuenta de WhatsApp, o el token expiró o pertenece a otra app Verifica los activos y la app asignados al usuario del sistema y luego genera un token nuevo
Token aceptado, pero siguen faltando plantillas El token puede acceder a otra cuenta de WhatsApp Business Confirma que el usuario del sistema tiene exactamente la cuenta usada por la bandeja, y que las plantillas existen allí
Una plantilla falla al enviarse, o el medio no se muestra Variables vacías, un enlace de medio privado o roto, o un archivo sobre los límites de Meta Llena todas las variables, usa un enlace público, revisa formato y tamaño en Plantillas y la ventana de 24 horas
Un botón de URL abre la página equivocada, o la plantilla falla al enviarse La variable del botón está vacía o errónea Para un botón de URL con variable, ingresa el valor en Parámetros del botón al enviar la plantilla. WhatsApp añade esto al final de la URL base establecida en la plantilla, así que introduce solo la parte variable, no el enlace completo. Si falla el envío, lee el error exacto en el mensaje fallido y corrige lo que se indica.

Contactos y números de teléfono

Los números lucen diferentes en WhatsApp y Chatwoot (Brasil, México, Argentina). Estos países cambiaron sus formatos móviles, y WhatsApp aún puede usar el antiguo:

  • 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 o no (+54 9 11 ... vs +54 11 ...).

  • México: WhatsApp puede añadir un 1 tras el código de país (+52 1 ... vs +52 ...).

Esto viene de WhatsApp y no hay ajuste para cambiarlo. Para Brasil y México, Chatwoot empareja ambos formatos al mismo contacto, así que el número puede verse distinto en cada lado. Para Argentina, Chatwoot empareja un mensaje con formato +54 9 a un contacto guardado sin el 9, pero no al revés. Un contacto guardado con el 9 puede generar un duplicado. Esto suele aparecer cuando inicias una conversación con el formato actual y WhatsApp responde desde el número antiguo. Puedes seguir escribiendo a estos clientes normalmente.

Un contacto no tiene número de teléfono. Esto puede ser normal. WhatsApp permite a algunas personas escribir a empresas usando un nombre de usuario, sin compartir su número. Chatwoot entonces identifica el contacto mediante el Business-Scoped User ID (BSUID) y muestra el nombre de usuario si lo provee WhatsApp. Igual puedes recibir y responder estas conversaciones. Consulta Nombres de usuario de WhatsApp y Business-Scoped User IDs en Chatwoot.

Contactar soporte

Si aún así tienes problemas, contacta el soporte de Chatwoot con:

  • El mensaje de error completo y el código, y una captura de pantalla

  • El paso fallido y si el error apareció en Meta o Chatwoot

  • El enlace de 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 usa el número: nuevo, aplicación WhatsApp Business, u otro proveedor

  • Para Coexistencia: versión de la app, tiempo de uso, y si aún funciona en el teléfono

  • Tu ID de cartera de empresa, ID de cuenta de WhatsApp Business y ID de número, etiquetados

Nunca compartas tu contraseña, token de acceso, código de verificación ni PIN de dos pasos. Ocúltalos en las capturas. Chatwoot no puede anular decisiones de Meta sobre restricciones o revisiones.