| Código | HTTP | Descripción |
|---|---|---|
API_KEY_MISSING | 401 | Falta el header X-API-Key |
API_KEY_INVALID | 401 | Key inexistente, revocada o expirada |
API_KEY_SCOPE | 403 | La key no tiene el scope requerido (read/write) |
PLAN_FEATURE_REQUIRED | 403 | El plan no incluye la función (p. ej. campañas) |
PLAN_LIMIT_REACHED | 403 | Límite del plan alcanzado (conversaciones) |
NOT_FOUND | 404 | Recurso inexistente en la organización |
CHANNEL_NOT_FOUND | 404 | Canal de WhatsApp inexistente en la organización |
TEMPLATE_NOT_FOUND | 404 | Plantilla inexistente para ese canal/idioma |
BAD_REQUEST | 400 | Validación de campos; el message detalla |
RECIPIENT_REQUIRED | 422 | Destinatario ausente o ambiguo |
WHATSAPP_WINDOW_CLOSED | 422 | Mensaje libre fuera de la ventana de 24 h |
TEMPLATE_PARAMS_MISSING | 422 | Faltan parámetros de plantilla |
CHANNEL_BILLING_LIMITED | 402 | Meta 131042: método de pago del WABA |
CHANNEL_ERROR | 502 | Error de WhatsApp/Meta al enviar |
TOO_MANY_REQUESTS | 429 | Rate limit por key |
INTERNAL_ERROR | 500 | Error inesperado; reintenta y contacta soporte si persiste |
Referencia
Códigos de error
La lista completa de códigos de error estables (code) de la API v1, con su HTTP y descripción.

