Erros e códigos HTTP

Envelope de erro

{
  "error": {
    "code": "validation",
    "message": "Missing required field: phone"
  }
}

Status	Significado
`200`	OK
`201`	Criado
`202`	Aceito (na fila / assíncrono)
`400`	Validação / solicitação incorreta
`401`	Chave de API ausente ou inválida
`403`	Scope / IP / parceiro não permitido
`404`	Recurso não encontrado
`422`	Validação semântica (por exemplo, campos de formulário)
`429`	Limite de solicitações
`500`	Erro do servidor

Código	Descrição
`unauthorized`	Chave de API ou token inválido
`forbidden`	Scope ausente, IP rejeitado ou parceiro incorreto
`validation`	Corpo da solicitação inválido
`not_found`	id / phone / template desconhecido
`blocked`	Conta descadastrada
`bot_error`	Erro do mecanismo de fluxo / bot

Status	Significado
`queued`	Aceito, ainda não totalmente entregue
`sending`	Em processo de envio
`delivered`	Entregue ao canal / in-app
`read`	Lido pelo usuário (quando rastreado)
`failed`	Todos os canais falharam
`expired`	Expirado

A reutilização da idempotency_key retorna a mensagem original com 200, em vez de criar uma duplicata.