> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sofiachat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Códigos de error

> La lista completa de códigos de error estables (code) de la API v1, con su HTTP y descripción.

| 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 |