Skip to content

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! SuiteCódigoQué significaSolució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.131042Meta no logró cobrar la cuenta.Ver solución
Ventana de 24 h cerrada (Requiere nueva interacción mediante template).131047Mensaje 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.131062El 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.131049El 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.130472El contacto forma parte de un experimento de Meta.Ver solución
El usuario bloqueó la recepción de mensajes de marketing.131050El contacto pidió no recibir marketing.Ver solución
Mensaje no enviado. El cliente no tiene cuenta de WhatsApp.131026El número no tiene WhatsApp o no recibe el mensaje.Ver solución
El remitente y el destinatario no pueden ser el mismo.131021Envío al propio número de la empresa.Ver solución
Incompatibilidad en el conteo de parámetros de la plantilla.132000Faltan o sobran variables.Ver solución
Parámetro obligatorio ausente.131008Faltó completar una información obligatoria, como una variable.Ver solución
El valor del parámetro no es válido.131009Una información se completó con un valor no válido.Ver solución
La plantilla no existe o no fue aprobada.132001Plantilla eliminada, pendiente o en otro idioma.Ver solución
El texto traducido de la plantilla es demasiado largo.132005El texto con las variables superó el límite.Ver solución
El contenido de la plantilla viola una política.132007El texto incumple una política de WhatsApp.Ver solución
Formato del parámetro de la plantilla incorrecto.132012Variable en formato diferente del esperado.Ver solución
Plantilla pausada por baja calidad.132015La plantilla se pausó por baja calidad.Ver solución
Plantilla deshabilitada permanentemente.132016La plantilla se pausó varias veces.Ver solución
La plantilla todavía se está sincronizando (Espera 10 min).134101Plantilla recién aprobada.Ver solución
Parámetro no válido (Debe ser un mensaje de template).100La solicitud tiene un parámetro no admitido o incorrecto.Ver solución
Tipo de mensaje no compatible.131051Formato de mensaje no admitido.Ver solución
Error de descarga de multimedia enviada por el usuario.131052Archivo del cliente en formato no admitido.Ver solución
Error de carga de multimedia en el mensaje.131053Archivo enviado en formato no admitido.Ver solución
Demasiadas llamadas de API (Límite de la App).4Límite de solicitudes alcanzado.Ver solución
Límite de volumen de la cuenta de WhatsApp Business alcanzado.80007La cuenta alcanzó el límite de volumen.Ver solución
Límite de tasa de transferencia de datos alcanzado.130429Demasiados mensajes por segundo.Ver solución
Límite de tasa de spam alcanzado.131048Demasiados mensajes bloqueados o denunciados.Ver solución
Límite de volumen de emparejamiento alcanzado (Demasiados mensajes en un período corto).131056Demasiados mensajes al mismo contacto en poco tiempo.Ver solución
Bloqueado temporalmente por violaciones de políticas.368Cuenta restringida por violación de política.Ver solución
Cuenta bloqueada (Violación de política o datos incorrectos).131031Cuenta bloqueada o datos no verificados.Ver solución
Cuenta impedida de enviar mensajes a usuarios de este país.130497Restricción de envío al país del contacto.Ver solución
Cuenta en modo de mantenimiento.131057Mantenimiento temporal en la cuenta.Ver solución
AuthException. No fue posible autenticar al usuario.0Falla en la autenticación con Meta.Ver solución
Método de API. Problema de recursos o permisos.3Recurso o permiso no disponible.Ver solución
Permiso denegado o eliminado.10Permiso de la integración eliminado.Ver solución
El token de acceso expiró.190La conexión con Meta expiró.Ver solución
Error de permiso de la API.200Falta el permiso de la integración.Ver solución
Acceso denegado131005Permiso denegado por Meta.Ver solución
Número de teléfono comercial no válido o eliminado.33El número de la empresa no está activo en Meta.Ver solución
Número de teléfono no registrado.133010El número de la empresa no fue registrado.Ver solución
Certificado incorrecto (Falla al enviar el mensaje).131045Error en el registro del número.Ver solución
El nombre visible debe ser aprobado.131037El nombre visible no fue aprobado.Ver solución
API desconocida. Solicitud no válida o error del servidor.1Error del lado de Meta.Ver solución
Servicio de API temporalmente no disponible (Sobrecarga).2Inestabilidad en Meta.Ver solución
Servicio temporalmente no disponible.131016Inestabilidad en Meta.Ver solución
Ocurrió un error desconocido.131000Falla sin motivo informado.Ver solución
Error genérico del usuario.135000Falla 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

  1. 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.
  2. Si el canal es por 360dialog, agrega saldo a la cuenta. Consulta Agregar saldo en el hub de 360Dialog.
  3. 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

  1. Envía una plantilla de mensaje aprobada desde el ícono de plantillas de la atención.
  2. Espera a que el contacto responda. La respuesta abre una nueva ventana de 24 horas.
  3. 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

  1. Si el contenido es informativo (factura, aviso, confirmación), envía una plantilla de la categoría Utilidad.
  2. Para marketing, intenta de nuevo más tarde. No reenvíes en secuencia al mismo contacto.
  3. Si tu WhatsApp es del Broker ¡Hola! Suite, activa la entrega optimizada de marketing. Consulta Activar la entrega optimizada de mensajes de marketing.
  4. 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

  1. Corrige el número en el registro del contacto.
  2. Confirma con el contacto, por otro canal, si usa WhatsApp en ese número.
  3. 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

  1. Revisa el estado de la plantilla en la lista de plantillas de mensaje del canal en ¡Hola! Suite.
  2. Completa todas las variables, con valores en el formato esperado y sin dejar campos vacíos.
  3. Si la plantilla fue rechazada, pausada o deshabilitada, ajusta el texto y crea una nueva plantilla. Consulta Crear una plantilla de mensaje de WhatsApp.
  4. 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

  1. 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.
  2. 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

  1. Espera algunos minutos y envía de nuevo.
  2. Divide los envíos masivos en lotes más pequeños y espaciados.
  3. 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

  1. Lee el aviso de Meta para saber qué política se incumplió. Consulta Políticas de uso de WhatsApp Business.
  2. 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.
  3. Para mantenimiento (131057), espera e intenta más tarde.
  4. 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

  1. Verifica, en el portafolio empresarial, si la cuenta de WhatsApp sigue con acceso habilitado para la integración.
  2. 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

  1. Revisa el estado del número y del nombre visible en el Administrador de WhatsApp.
  2. 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

  1. Consulta la página de estado de los productos empresariales de Meta.
  2. Espera algunos minutos y envía de nuevo.
  3. 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 ​