Errores de envío de mensajes de WhatsApp
Visión general
Cuando Meta rechaza un mensaje enviado por ¡Hola! Suite en la API de WhatsApp, el mensaje aparece en la conversación con un ícono rojo de alerta junto al globo. Para ver el motivo, pasa el mouse sobre el ícono.
El motivo viene de Meta y ¡Hola! Suite lo traduce. Cuando el código no se reconoce, aparece Mensaje no enviado al cliente. En canales por 360dialog, el motivo aparece en inglés, con el texto original de Meta. El mensaje con falla no se reenvía automáticamente: después de corregir la causa, envíalo de nuevo.
Busca en la tabla siguiente el texto que se muestra en el tooltip (usa la búsqueda del navegador, Ctrl+F, con el comienzo de la frase) y haz clic en Ver solución.
Encuentra el error
| Motivo que se muestra en ¡Hola! Suite | Código | Qué significa | Solución |
|---|---|---|---|
| Mensaje no enviado por falla en el pago. Accede a Facebook > Administrador comercial > Cuentas de WhatsApp, verifica los pendientes y recarga el saldo de tu cuenta para retomar los envíos. | 131042 | Meta no logró cobrar la cuenta. | Ver solución |
| Ventana de 24 h cerrada (Requiere nueva interacción mediante template). | 131047 | Mensaje libre fuera de la ventana de 24 horas. | Ver solución |
| El contacto aún no ha iniciado una conversación con tu empresa por el WhatsApp seleccionado. | 131062 | El contacto nunca conversó con ese número. | Ver solución |
| Mensaje no enviado. Meta suspendió la recepción de templates de marketing para este cliente. Por favor, intenta de nuevo usando un template de utilidad. | 131049 | El contacto alcanzó el límite de marketing de Meta. | Ver solución |
| Mensaje no enviado. El número al que intentaste llamar no puede recibir templates de Marketing en este momento. Por favor, intenta de nuevo usando un template de utilidad. | 130472 | El contacto forma parte de un experimento de Meta. | Ver solución |
| El usuario bloqueó la recepción de mensajes de marketing. | 131050 | El contacto pidió no recibir marketing. | Ver solución |
| Mensaje no enviado. El cliente no tiene cuenta de WhatsApp. | 131026 | El número no tiene WhatsApp o no recibe el mensaje. | Ver solución |
| El remitente y el destinatario no pueden ser el mismo. | 131021 | Envío al propio número de la empresa. | Ver solución |
| Incompatibilidad en el conteo de parámetros de la plantilla. | 132000 | Faltan o sobran variables. | Ver solución |
| Parámetro obligatorio ausente. | 131008 | Faltó completar una información obligatoria, como una variable. | Ver solución |
| El valor del parámetro no es válido. | 131009 | Una información se completó con un valor no válido. | Ver solución |
| La plantilla no existe o no fue aprobada. | 132001 | Plantilla eliminada, pendiente o en otro idioma. | Ver solución |
| El texto traducido de la plantilla es demasiado largo. | 132005 | El texto con las variables superó el límite. | Ver solución |
| El contenido de la plantilla viola una política. | 132007 | El texto incumple una política de WhatsApp. | Ver solución |
| Formato del parámetro de la plantilla incorrecto. | 132012 | Variable en formato diferente del esperado. | Ver solución |
| Plantilla pausada por baja calidad. | 132015 | La plantilla se pausó por baja calidad. | Ver solución |
| Plantilla deshabilitada permanentemente. | 132016 | La plantilla se pausó varias veces. | Ver solución |
| La plantilla todavía se está sincronizando (Espera 10 min). | 134101 | Plantilla recién aprobada. | Ver solución |
| Parámetro no válido (Debe ser un mensaje de template). | 100 | La solicitud tiene un parámetro no admitido o incorrecto. | Ver solución |
| Tipo de mensaje no compatible. | 131051 | Formato de mensaje no admitido. | Ver solución |
| Error de descarga de multimedia enviada por el usuario. | 131052 | Archivo del cliente en formato no admitido. | Ver solución |
| Error de carga de multimedia en el mensaje. | 131053 | Archivo enviado en formato no admitido. | Ver solución |
| Demasiadas llamadas de API (Límite de la App). | 4 | Límite de solicitudes alcanzado. | Ver solución |
| Límite de volumen de la cuenta de WhatsApp Business alcanzado. | 80007 | La cuenta alcanzó el límite de volumen. | Ver solución |
| Límite de tasa de transferencia de datos alcanzado. | 130429 | Demasiados mensajes por segundo. | Ver solución |
| Límite de tasa de spam alcanzado. | 131048 | Demasiados mensajes bloqueados o denunciados. | Ver solución |
| Límite de volumen de emparejamiento alcanzado (Demasiados mensajes en un período corto). | 131056 | Demasiados mensajes al mismo contacto en poco tiempo. | Ver solución |
| Bloqueado temporalmente por violaciones de políticas. | 368 | Cuenta restringida por violación de política. | Ver solución |
| Cuenta bloqueada (Violación de política o datos incorrectos). | 131031 | Cuenta bloqueada o datos no verificados. | Ver solución |
| Cuenta impedida de enviar mensajes a usuarios de este país. | 130497 | Restricción de envío al país del contacto. | Ver solución |
| Cuenta en modo de mantenimiento. | 131057 | Mantenimiento temporal en la cuenta. | Ver solución |
| AuthException. No fue posible autenticar al usuario. | 0 | Falla en la autenticación con Meta. | Ver solución |
| Método de API. Problema de recursos o permisos. | 3 | Recurso o permiso no disponible. | Ver solución |
| Permiso denegado o eliminado. | 10 | Permiso de la integración eliminado. | Ver solución |
| El token de acceso expiró. | 190 | La conexión con Meta expiró. | Ver solución |
| Error de permiso de la API. | 200 | Falta el permiso de la integración. | Ver solución |
| Acceso denegado | 131005 | Permiso denegado por Meta. | Ver solución |
| Número de teléfono comercial no válido o eliminado. | 33 | El número de la empresa no está activo en Meta. | Ver solución |
| Número de teléfono no registrado. | 133010 | El número de la empresa no fue registrado. | Ver solución |
| Certificado incorrecto (Falla al enviar el mensaje). | 131045 | Error en el registro del número. | Ver solución |
| El nombre visible debe ser aprobado. | 131037 | El nombre visible no fue aprobado. | Ver solución |
| API desconocida. Solicitud no válida o error del servidor. | 1 | Error del lado de Meta. | Ver solución |
| Servicio de API temporalmente no disponible (Sobrecarga). | 2 | Inestabilidad en Meta. | Ver solución |
| Servicio temporalmente no disponible. | 131016 | Inestabilidad en Meta. | Ver solución |
| Ocurrió un error desconocido. | 131000 | Falla sin motivo informado. | Ver solución |
| Error genérico del usuario. | 135000 | Falla sin motivo informado. | Ver solución |
| Mensaje no enviado al cliente | — | Motivo no identificado por ¡Hola! Suite. | Ver solución |
Falla en el pago
En inglés: Business eligibility - Payment issue (131042).
Causa
Meta no logró cobrar los envíos de la cuenta de WhatsApp: tarjeta sin límite, bloqueada, vencida, rechazada o con pago pendiente. Mientras haya pendientes, Meta no acepta nuevos mensajes.
Cómo resolver
- Si tu cuenta se paga directamente a Meta, accede al portafolio empresarial de Meta (antiguo Administrador comercial), abre Cuentas de WhatsApp → Configuración de pago, revisa los pendientes y registra o actualiza la tarjeta. El paso a paso está en Agregar una forma de pago en la cuenta de WhatsApp en Meta.
- Si el canal es por 360dialog, agrega saldo a la cuenta. Consulta Agregar saldo en el hub de 360Dialog.
- Después de regularizar, envía de nuevo los mensajes que fallaron.
Ventana de 24 horas cerrada
En inglés: Re-engagement message (131047).
Causa
La empresa intentó enviar un mensaje libre (texto, audio, archivo) a un contacto que no envía mensajes hace más de 24 horas, o que nunca conversó con ese número. Fuera de la ventana de atención, Meta solo acepta plantillas de mensaje.
Cómo resolver
- Envía una plantilla de mensaje aprobada desde el ícono de plantillas de la atención.
- Espera a que el contacto responda. La respuesta abre una nueva ventana de 24 horas.
- Continúa la conversación normalmente.
Más detalles en Ventana de atención de WhatsApp.
Límite de mensajes de marketing
Causa
Meta limita cuántas plantillas de Marketing recibe cada contacto, considerando los mensajes promocionales de todas las empresas y cuánto interactúa el contacto con ellos (131049). El envío también falla cuando el contacto forma parte de un experimento de Meta que suspende el marketing (130472, en inglés Failed to send a message because this user's phone number is part of an experiment) o cuando él mismo bloqueó los mensajes de marketing de tu empresa (131050).
Cómo resolver
- Si el contenido es informativo (factura, aviso, confirmación), envía una plantilla de la categoría Utilidad.
- Para marketing, intenta de nuevo más tarde. No reenvíes en secuencia al mismo contacto.
- Si tu WhatsApp es del Broker ¡Hola! Suite, activa la entrega optimizada de marketing. Consulta Activar la entrega optimizada de mensajes de marketing.
- Para el error 131050, respeta la elección del contacto y no le envíes más marketing.
Contacto sin WhatsApp
Causa
El número del contacto no tiene cuenta en WhatsApp, es incorrecto o no puede recibir el mensaje (131026, en inglés Message undeliverable). También ocurre cuando el destinatario es el propio número de la empresa (131021, Recipient cannot be sender).
Verificaciones
- ¿El número tiene el código de país y el código de área correctos?
- ¿El contacto usa una versión actualizada de WhatsApp?
Cómo resolver
- Corrige el número en el registro del contacto.
- Confirma con el contacto, por otro canal, si usa WhatsApp en ese número.
- Pide al contacto que actualice la aplicación, si es el caso.
Problemas en la plantilla de mensaje
Causa
La plantilla de mensaje enviada no está lista para usar o se completó de forma diferente a lo que fue aprobado:
- 132000 (Template Param Count Mismatch): la cantidad de variables enviadas es diferente de la de la plantilla.
- 131008 y 131009: faltó una información obligatoria o se completó con un valor no válido.
- 132001 (Template does not exist): la plantilla fue eliminada, todavía no fue aprobada o no existe en el idioma elegido.
- 132005 (Template Hydrated Text Too Long): el texto, con las variables completadas, quedó demasiado largo.
- 132007 (Template Format Character Policy Violated): el contenido incumple una política de WhatsApp.
- 132012 (Template Parameter Format Mismatch): una variable se completó en un formato diferente del esperado.
- 132015 y 132016: la plantilla se pausó por baja calidad o se deshabilitó definitivamente, después de pausarse varias veces.
- 134101: la plantilla acaba de ser aprobada y todavía se está sincronizando.
- 100: la solicitud enviada a Meta tiene un parámetro no admitido o incorrecto.
Cómo resolver
- Revisa el estado de la plantilla en la lista de plantillas de mensaje del canal en ¡Hola! Suite.
- Completa todas las variables, con valores en el formato esperado y sin dejar campos vacíos.
- Si la plantilla fue rechazada, pausada o deshabilitada, ajusta el texto y crea una nueva plantilla. Consulta Crear una plantilla de mensaje de WhatsApp.
- Para el error 134101, espera unos 10 minutos y envía de nuevo.
Multimedia o tipo de mensaje no admitido
Causa
WhatsApp no acepta el archivo o el tipo de mensaje: 131051 (Unsupported message type), 131052 (Media download error, archivo enviado por el cliente) o 131053 (Media upload error, archivo enviado por la empresa).
Cómo resolver
- Envía el archivo en un formato común (JPG o PNG para imagen, MP4 para video, PDF para documento) y dentro del tamaño permitido por WhatsApp.
- Si el archivo vino del cliente, pídele que lo reenvíe en otro formato.
Límite de envío alcanzado
Causa
La cuenta envió más mensajes de los que Meta permite en un intervalo: exceso de solicitudes (4, API Too Many Calls), límite de volumen de la cuenta (80007, Rate limit issues), demasiados mensajes por segundo (130429, Rate limit hit), demasiados mensajes al mismo contacto en poco tiempo (131056, pair rate limit hit) o exceso de mensajes bloqueados y denunciados (131048, Spam rate limit hit).
Cómo resolver
- Espera algunos minutos y envía de nuevo.
- Divide los envíos masivos en lotes más pequeños y espaciados.
- Para el error 131048, revisa la calidad del número en el Administrador de WhatsApp y revisa las plantillas con muchos bloqueos. Consulta Guía de buenas prácticas de la API de WhatsApp.
Cuenta bloqueada o restringida
Causa
Meta restringió la cuenta de WhatsApp por violación de política (368, Temporarily blocked for policies violations), bloqueó la cuenta por violación o por no lograr verificar los datos de la empresa (131031, Account has been locked), impidió los envíos al país del contacto (130497) o puso la cuenta en mantenimiento temporal (131057).
Verificaciones
- ¿Hay un aviso de Meta en el correo registrado en el portafolio empresarial?
- ¿El Administrador de WhatsApp muestra restricción o calidad baja en el número?
Cómo resolver
- Lee el aviso de Meta para saber qué política se incumplió. Consulta Políticas de uso de WhatsApp Business.
- Si no estás de acuerdo con la decisión, pide una revisión a Meta. Consulta Abrir un ticket con el soporte de Meta.
- Para mantenimiento (131057), espera e intenta más tarde.
- Si necesitas ayuda, habla con el soporte de ¡Hola! Suite.
Permiso o autenticación
Causa
La conexión entre ¡Hola! Suite y Meta perdió el permiso o expiró: 0 (AuthException), 3 (API Method), 10 (Permission Denied), 190 (Access token has expired), 200 (API Permission) o 131005 (Access denied). Suele ocurrir cuando se elimina el permiso de la aplicación en el portafolio empresarial.
Cómo resolver
- Verifica, en el portafolio empresarial, si la cuenta de WhatsApp sigue con acceso habilitado para la integración.
- Habla con el soporte de ¡Hola! Suite para rehacer la conexión del canal.
Número de la empresa no registrado
Causa
El número de la empresa no está activo en la plataforma de WhatsApp: número no válido o eliminado (33), número no registrado (133010, Phone number Not Registered), error en el registro (131045, Incorrect certificate) o nombre visible todavía no aprobado (131037).
Cómo resolver
- Revisa el estado del número y del nombre visible en el Administrador de WhatsApp.
- Habla con el soporte de ¡Hola! Suite para concluir o rehacer el registro del número.
Inestabilidad o error desconocido
Causa
Meta no logró procesar el mensaje por inestabilidad o error interno: 1 (API Unknown), 2 (API Service), 131016 (Service unavailable), 131000 (Something went wrong) o 135000 (Generic user error). El mensaje Mensaje no enviado al cliente aparece cuando Meta no informó un motivo que ¡Hola! Suite reconozca.
Cómo resolver
- Consulta la página de estado de los productos empresariales de Meta.
- Espera algunos minutos y envía de nuevo.
- Si el error continúa, habla con el soporte de ¡Hola! Suite informando el horario del envío y el contacto.
Buenas prácticas
- Revisa la forma de pago o el saldo antes de envíos masivos.
- Usa plantillas de mensaje aprobadas y específicas, completando todas las variables.
- Envía marketing solo a quien lo aceptó y espacia los envíos.
- Sigue el correo del portafolio empresarial y la calidad del número en el Administrador de WhatsApp.
Contenidos relacionados
- Ventana de atención de WhatsApp
- Precios de los mensajes de la API de WhatsApp
- Agregar una forma de pago en la cuenta de WhatsApp en Meta
- Activar la entrega optimizada de mensajes de marketing
- Políticas de uso de WhatsApp Business
- Crear una plantilla de mensaje de WhatsApp
- Códigos de error de la API de la nube de WhatsApp (Meta)