Solución de problemas
Número restringido o bloqueado
Cómo reconocer y tratar un número restringido, bloqueado o baneado por Meta.
Cada síntoma de abajo sigue el mismo formato: qué ves, la causa y qué hacer.
Dónde mirar
Sección titulada «Dónde mirar»En la página de la conexión, pestaña Resumen, la tarjeta Estado muestra:
- Calidad, Nivel de envío y Velocidad;
- Envío: Disponible, Limitado o Bloqueado;
- Restricción, con el plazo (
Hasta {fecha}) o “Sin fecha de fin”; - la lista Qué está bloqueado o limitado, agrupada por Número, Cuenta de WhatsApp, Empresa y App, cada ítem con el código de Meta, la descripción y la solución sugerida;
- Qué sigue funcionando.
Messajo lee el estado cada 15 minutos. Actualizar estado lo lee en el momento.
La conexión aparece como Restringida o Desactivada
Sección titulada «La conexión aparece como Restringida o Desactivada»| Estado | Motivo (reason) |
Qué hacer |
|---|---|---|
| Restringida | account_restriction: Meta restringió la cuenta por un plazo |
Esperar el plazo y corregir la causa en el Administrador de WhatsApp |
| Restringida | policy_blocked: Meta bloqueó un envío por política (368 o 131031) |
Igual |
| Desactivada | violation:<tipo> o banned |
Apelar en Meta. Si Meta la reactiva (reinstated), la conexión vuelve a Activa sola |
| Activa | restriction_lifted: la restricción terminó |
Nada |
scheduled_for_disable avisa antes: Meta programó la desactivación de la cuenta, sin cambio de estado.
Mientras la conexión está restringida, los envíos devuelven 403 policy_blocked o 409 connection_restricted. Desactivada, 409 connection_disabled.
Envío Limitado o Bloqueado, sin cambio de estado
Sección titulada «Envío Limitado o Bloqueado, sin cambio de estado»La conexión sigue Activa, pero el Envío cambió. Messajo emite connection.updated con reason can_send_changed. Los casos que el panel explica:
- Sin método de pago (código
141006): la empresa no puede iniciar conversaciones (plantillas). Las respuestas a clientes que escribieron en las últimas 24 h siguen funcionando. Acción: Agregar método de pago en Meta Business. - Empresa no verificada (código
141010): límites de envío menores. Los envíos dentro del límite actual siguen funcionando. Acción: verificar la empresa.
Para el error de envío por falta de pago, consulta también meta_payment_required.
Cambió la calidad o el nivel de envío
Sección titulada «Cambió la calidad o el nivel de envío»Messajo emite connection.updated con reason quality_changed (calidad) o limit_changed (nivel de envío o capacidad). Entiende el nivel en Límite de mensajes de Meta.
Señales de spam en los envíos
Sección titulada «Señales de spam en los envíos»429meta_spam_rate_limited(Meta131048): muchos mensajes del número fueron denunciados o bloqueados. No reenvíes. Las campañas se pausan solas. Revisa la lista (solo quien dio opt-in), el contenido de la plantilla y la frecuencia, y espera a que la calidad se recupere.422marketing_limit_reached(Meta131049): Meta retuvo la plantilla de marketing para cuidar el engagement del contacto. No reenvíes de inmediato.
Qué hace Messajo solo
Sección titulada «Qué hace Messajo solo»- Envía un correo a dueños y admins en cada cambio de estado (como máximo uno por motivo cada 6 h).
- Emite eventos
connection.*con el motivo enreason.
Qué no hace Messajo
Sección titulada «Qué no hace Messajo»No levanta una restricción ni revierte un baneo. Las apelaciones y los recursos se hacen en las herramientas de Meta, en el Administrador de WhatsApp.
Recibir el aviso en tu sistema
Sección titulada «Recibir el aviso en tu sistema»Crea un destino global que se suscriba a los eventos de conexión:
{ "connection_id": null, "event_types": ["connection.*", "org.*"] }Cada evento trae data.connection.status, previous_status y reason. La tabla completa está en Motivos de la conexión.