A API segue um contrato REST puro: o status code HTTP é o sinal de sucesso ou erro.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.
Formato da resposta
{ code, message? }.
Famílias de status
| HTTP | Significado | Repetir? |
|---|---|---|
2xx | Sucesso — 200 leitura, 201 criação, 202 aceito (async), 207 multi-status. | — |
4xx | Erro da requisição — auth, validação ou recurso inexistente. | Não, corrija antes. |
429 | Rate limit excedido. | Sim, após o Retry-After. |
5xx | Erro do servidor. | Sim, com backoff. |
Códigos comuns
INVALID_REQUEST — 400
INVALID_REQUEST — 400
O body não passou na validação de schema (campo faltante, tipo incorreto,
valor fora do intervalo). O
message indica qual campo falhou.CONVERSATION_NOT_FOUND — 404
CONVERSATION_NOT_FOUND — 404
O identificador de
conversation (uuid, whatsapp_user_id ou phone) não
resolve para nenhuma conversa do negócio.WINDOW_CLOSED — 422
WINDOW_CLOSED — 422
A janela de 24h está fechada: não é possível enviar texto, mídia nem quick
reply. Envie um template para reabri-la.
RATE_LIMIT_EXCEEDED — 429
RATE_LIMIT_EXCEEDED — 429
Você excedeu as 60 requisições por minuto. Espere os segundos do header
Retry-After. Ver Rate limits.SEND_FAILED — 502
SEND_FAILED — 502
A Meta rejeitou o envio. A mensagem fica persistida como
failed. A requisição
pode ser repetida.FETCH_FAILED — 500
FETCH_FAILED — 500
Erro do servidor ao ler dados. Pode ser repetida com backoff.
Cada endpoint documenta na Referência da API o conjunto completo de
códigos que pode retornar.