Códigos de error de WhatsApp Cloud API
Busca tu código de error y encuentra la causa probable y la solución, directo de la documentación oficial de Meta.
Autorización
0
No se pudo autenticar al usuario de la app. Normalmente el token caducó o se invalidó. Solución: genera un token nuevo.
190
Tu token de acceso ha caducado. Solución: genera uno nuevo — ver la guía de tokens.
200
No se incluyó ningún identificador de acceso en la solicitud (distinto del 190, que es un token caducado). Solución: revisa que el header Authorization esté presente.
10
No se ha concedido o se ha suprimido un permiso necesario. Solución: revisa los permisos de la app con el depurador de identificadores de acceso.
Cuenta e integridad
368
La cuenta de WhatsApp Business se restringió o deshabilitó por infringir una política. Ver políticas de WhatsApp Business.
130497
La cuenta está restringida para enviar mensajes a usuarios de ciertos países según tu categoría de empresa.
131031
Cuenta restringida por política, o el PIN de verificación en dos pasos incluido no coincide con el configurado.
Plantillas
132000
El número de valores de variable enviados no coincide con los definidos en la plantilla.
132001
La plantilla no existe en el idioma especificado o no está aprobada. Revisa nombre e idioma exactos.
132007
El contenido de la plantilla infringe una política de WhatsApp. Ver diagnóstico de plantilla rechazada.
132012
Los valores de las variables no usan el formato que define la plantilla (named vs. positional).
132015
La plantilla está en pausa por baja calidad. Ver calificación de calidad.
132016
La plantilla se pausó demasiadas veces por baja calidad y se desactivó de forma permanente. Crea una plantilla nueva con contenido distinto.
2388019
Superaste el máximo de plantillas de mensaje de tu cuenta (250 sin portafolio verificado, 6.000 verificado).
2388299
La plantilla empieza o termina con una variable — no está permitido (parámetros "colgantes").
Restricciones y límites de frecuencia
130429
Se alcanzó el límite de rendimiento (throughput) de la Cloud API. Reduce la frecuencia de envío o espera.
131048
Restricción por cantidad de mensajes bloqueados o marcados como spam. Revisa el estado de calidad en el Administrador de WhatsApp.
131049
No se entregó para mantener buena interacción del ecosistema — es el límite adaptativo de marketing por usuario. Espera al menos 24h antes de reintentar. Ver frecuencia de campañas.
131050
El destinatario se dio de baja de mensajes de marketing de tu empresa. No reintentes con este usuario. Suscríbete al webhook user_preferences para saber cuándo cambia.
131056
Enviaste demasiados mensajes al mismo destinatario en poco tiempo. Espera antes de reintentar con ese número (a otros números puedes escribir sin esperar).
131064
La cuenta alcanzó su límite de mensajes por infracciones de clasificación de plantillas. Se retira automáticamente al terminar el periodo de cumplimiento.
Envío de mensajes
131047
Pasaron más de 24 horas desde la última respuesta del destinatario. Envía un mensaje de plantilla en su lugar. Ver ventana de 24h.
130403
El usuario final bloqueó a tu empresa en WhatsApp. No reintentes hasta que te desbloquee.
131026
No se pudo entregar: el número no es de WhatsApp, no aceptó las condiciones más recientes, o usa una versión muy antigua de la app.
131042
Problema con el método de pago: línea de crédito no configurada, superada, o cuenta suspendida. Ver cómo leer tu factura.
131045
Error de registro del número de teléfono. Regístralo antes de reintentar.
131053
No se pudo subir el archivo multimedia (tipo no admitido u otro motivo). Verifica el tipo MIME con file -I.
131052
No se pudo descargar el archivo multimedia que envió el usuario. Pídele que lo reenvíe por otro medio.
100
La solicitud incluye uno o más parámetros mal escritos o no admitidos. Revisa la referencia del endpoint.
33
El número de teléfono de empresa se eliminó. Verifica que el número sea correcto.
133005
El PIN de verificación en dos pasos incluido es incorrecto.
No se encontró ningún código o palabra clave que coincida.
La forma correcta de manejar errores
Meta recomienda construir la lógica de tu aplicación alrededor del campo code (entero) y del texto de details, no del título incluido en message (que puede cambiar) ni del error_subcode (retirado desde la versión 16.0). Los errores llegan de forma síncrona en la respuesta de la API Graph, y de forma asíncrona por el webhook messages — conviene escuchar ambos.
Fuente: documentación oficial de Meta sobre códigos de error (verificado el 31 de agosto de 2026). Esta página no reproduce la lista completa (~80 códigos): cubre los que con más frecuencia bloquean una integración.