Erros e limites
Interprete códigos estáveis e decida quando repetir uma chamada.
Erros usam um envelope consistente:
{
"code": "VALIDATION_ERROR",
"error": "Invalid send API payload",
"details": {
"issues": []
}
}| HTTP | Categoria | Ação recomendada |
|---|---|---|
400 | Payload inválido | Corrija os campos; não repita sem alteração |
401 | API key inválida | Corrija ou rotacione a credencial |
403 | Acesso ou entitlement | Verifique workspace, assinatura e limites |
404 | Mensagem não encontrada | Confirme o ID e o workspace da chave |
409 | Conflito de estado | Reavalie canal ou estado do contato |
422 | Destino/conteúdo recusado | Corrija telefone, mídia ou template |
429 | Rate limit | Respeite Retry-After e aplique jitter |
500 | Falha interna | Repita com backoff e a mesma idempotency key |
502 | Falha do provedor | Repita com backoff e a mesma idempotency key |
503 | Dependência indisponível | Aguarde e repita com backoff |
Rate limit
O limite de envio é aplicado por API key; a consulta de status tem orçamento separado. Os valores podem variar por ambiente e configuração operacional.
Ao receber 429, não faça retry imediato em paralelo. Aguarde Retry-After, aplique jitter e reduza a concorrência. O limite de volume do plano continua sendo controlado pelos entitlements do workspace.