¿Cómo identificar el error?
Si acabas de configurar tu API y al enviar una plantilla de mensaje aparece un error, es importante revisar el detalle que muestra la plataforma.
Coloca el cursor sobre el segundo ícono rojo (error) que aparece en el mensaje.
Ahí podrás ver el código y la descripción del error que devuelve Meta.
Ícono de error donde se muestra el detalle del problema de envío.
Meta siempre indica el motivo exacto por el cual no se pudo enviar el mensaje. Identificar este error es fundamental para poder aplicar la solución correcta.
Errores principales (causa y solución)
200 — Error genérico de solicitud
Causa:
- Error en la estructura de la solicitud enviada
Datos incompletos o inválidos en la API
Problemas en el formato del request - Solución:
- Revisar la estructura del request enviado
Validar que todos los campos obligatorios estén completos
Confirmar que los datos estén en el formato correcto
Revisar logs o respuesta detallada de la API
100 — Invalid parameter
Causa:
- Parámetros incorrectos en la solicitud
Campos mal enviados en la plantilla
Error en variables o estructura del mensaje - Solución:
- Validar los parámetros enviados en la API
Revisar que las variables coincidan con la plantilla
Confirmar nombres de campos y estructura del JSON
Comparar con la documentación oficial de Meta
131026 — Message Undeliverable
Causa:
- El número no tiene WhatsApp
El cliente bloqueó tu número
El cliente está en un país restringido
Aplicación desactualizada o términos no aceptados - Solución:
- Verificar que el número tenga WhatsApp
Pedir al cliente que desbloquee el número
Solicitar actualización de la app
Probar envío manual
131031 — Account has been locked
Causa:
- Cuenta bloqueada por políticas
Problema con verificación (PIN 2FA incorrecto) - Solución:
- Desactivar 2FA
Registrar nuevamente el número
Activar 2FA nuevamente
Si continúa → solicitar revisión a Meta
131042 — Payment / billing issue
Causa:
- Falta de método de pago
Línea de crédito inválida
Cuenta mal configurada - Solución:
- Configurar método de pago en Meta
Revisar cuenta en Business Manager
Validar moneda y configuración
131047 — Fuera de ventana de 24h
Causa:
- Intento de envío fuera de la ventana de 24 horas sin plantilla
- Solución:
- Enviar mensaje con plantilla aprobada
O esperar respuesta del cliente
131049 — Envío bloqueado por Meta
Causa:
- Envíos masivos muy rápidos
Baja calidad del número
Usuarios no interactúan o reportan - Solución:
- Esperar al menos 24 horas
Reducir volumen de envíos
Usar contactos con consentimiento (opt-in)
Escalar envíos progresivamente
130497 — País restringido
Causa:
- Cuenta no habilitada para enviar a ese país
- Solución:
- Subir nivel de cuenta (tier)
Esperar liberación
Validar país permitido
131037 — Display name no aprobado
Causa:
- Nombre del número no aprobado por Meta
- Solución:
- Solicitar aprobación del nombre
Ajustar configuración en Meta
130472 — Usuario en experimento
Causa:
- Meta está realizando pruebas internas
- Solución:
- No hay acción directa
Intentar nuevamente más tarde
Evitar reintentos masivos
132000 — Variables incorrectas
Causa:
- Variables mal configuradas
Parámetros incompletos - Solución:
- Revisar estructura del template
Validar orden y cantidad de variables
132001 — Template no aprobado
Causa:
- Plantilla no aprobada
Idioma incorrecto - Solución:
- Verificar estado en Meta
Confirmar nombre e idioma
131021 — Envío al mismo número
Causa:
- Intento de enviar mensaje al mismo número
- Solución:
- Usar un número diferente como destino
Resumen rápido para soporte
- Problemas de entrega
131026 → número / cliente
131049 → bloqueo por comportamiento
130497 → país restringido - Problemas de cuenta
131031 → cuenta bloqueada
131042 → pago - Problemas de plantilla
132000 / 132001 → variables o aprobación - Otros importantes
131047 → fuera de ventana
130472 → experimento
Documentación oficial de Meta
Puedes consultar todos los errores directamente en la documentación oficial:
https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/
Importante
Identificar correctamente el error mostrado por Meta es clave para resolver el problema.
Cada código indica una causa específica, por lo que siempre debes validar el mensaje antes de intentar reenviar.
¿Tienes dudas adicionales? No te preocupes, estamos aquí para ayudarte.
Entra en contacto con nuestro equipo presionando el botón de "Soporte" ubicado en el menú izquierdo de nuestra plataforma.
