🔵 ¿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.
