La API sigue un contrato REST puro: el status code HTTP es la señal de éxito o error.Documentation Index
Fetch the complete documentation index at: https://docs.1to1ai.com/llms.txt
Use this file to discover all available pages before exploring further.
Forma de la respuesta
{ code, message? }.
Familias de status
| HTTP | Significado | ¿Reintentar? |
|---|---|---|
2xx | Éxito — 200 lectura, 201 creación, 202 aceptado (async), 207 multi-status. | — |
4xx | Error del request — auth, validación o recurso inexistente. | No, corrígelo primero. |
429 | Rate limit excedido. | Sí, tras el Retry-After. |
5xx | Error del servidor. | Sí, con backoff. |
Códigos comunes
INVALID_REQUEST — 400
INVALID_REQUEST — 400
El body no pasó la validación de schema (campo faltante, tipo incorrecto,
valor fuera de rango). El
message indica qué campo falló.CONVERSATION_NOT_FOUND — 404
CONVERSATION_NOT_FOUND — 404
El identificador de
conversation (uuid, whatsapp_user_id o phone) no
resuelve a ninguna conversación del negocio.WINDOW_CLOSED — 422
WINDOW_CLOSED — 422
La ventana de 24h está cerrada: no se puede enviar texto, media ni quick
reply. Envía una plantilla para reabrirla.
RATE_LIMIT_EXCEEDED — 429
RATE_LIMIT_EXCEEDED — 429
Superaste las 60 requests por minuto. Espera los segundos del header
Retry-After. Ver Rate limits.SEND_FAILED — 502
SEND_FAILED — 502
Meta rechazó el envío. El mensaje queda persistido como
failed. El request
puede reintentarse.FETCH_FAILED — 500
FETCH_FAILED — 500
Error del servidor al leer datos. Reintentable con backoff.
Cada endpoint documenta en la Referencia de API el conjunto completo de
códigos que puede emitir.