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

# Errores

> Formato de respuesta de error y los códigos devueltos por la API de GOWA.

Errores usan el sobre estándar con un código no `SUCCESS`:

```json theme={null}
{
  "code": "VALIDATION_ERROR",
  "message": "phone: cannot be blank."
}
```

Branch on the HTTP status and `code`, not on `message`.

| HTTP | Códigos |
| - | - |
| 400 | `VALIDATION_ERROR`, `INVALID_JID`, `ALREADY_LOGGED_IN`, `DEVICE_ID_REQUIRED` |
| 401 | `AUTHENTICATION_ERROR` (dispositivo no conectado); también fallos de autenticación básica (sin `code`) |
| 403 | `AVATAR_HIDDEN`, `CROSS_SITE_REQUEST_BLOCKED` |
| 404 | `NOT_FOUND`, `DEVICE_NOT_FOUND`, `AVATAR_NOT_SET` |
| 408 | `CONTEXT_ERROR` |
| 429 | `WA_REACHOUT_TIMELOCK` |
| 500 | `INTERNAL_SERVER_ERROR`, `QR_CHANNEL_ERROR`, `SESSION_SAVED_ERROR`, `UPLOAD_MEDIA_ERROR`, `WEBHOOK_ERROR`, `INVALID_WA_CLI` |
| 503 | `DEVICE_MANAGER_UNAVAILABLE` |
| 504 | `GATEWAY_TIMEOUT` |

Guías de reintento, correcciones y reintento: [Gestión de error](https://gowa-docs.mintlify.site/es/advanced/error-handling.md).

Para `GET /user/avatar`, `AVATAR_NOT_SET` significa que el contacto no tiene una imagen de perfil. `AVATAR_HIDDEN` significa que los ajustes de privacidad niegan el acceso. Conservar una imagen en caché sobre una denegación de privacidad y distinguir estos códigos de los errores de selección de dispositivos.


## Related topics

- [Manejo de errores](https://gowa-docs.mintlify.site/es/advanced/error-handling.md)
- [Selección de dispositivo y dispositivo múltiple](https://gowa-docs.mintlify.site/es/concepts/multidevice.md)
- [Enviando mensajes](https://gowa-docs.mintlify.site/es/examples/sending-messages.md)
- [Integración de Chatwoot](https://gowa-docs.mintlify.site/es/integrations/chatwoot.md)
- [Envíos programados](https://gowa-docs.mintlify.site/es/examples/scheduled-sends.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.