Erros¶
Toda resposta de erro da API tem o formato:
Mensagens recusadas também trazem id, to e status: "rejected" e ficam registradas: dá para consultar pelo id depois.
| HTTP | code |
Significado | O que fazer |
|---|---|---|---|
| 400 | invalid_request |
JSON malformado ou campo obrigatório ausente | Corrija a requisição |
| 400 | customer_required |
Chave de integração sem customer_ref ou customer_id |
Informe o cliente |
| 401 | unauthorized |
Chave ausente ou inválida | Confira o cabeçalho Authorization |
| 403 | account_disabled |
Conta desativada | Fale com seu provedor |
| 403 | ip_not_allowed |
IP de origem fora da lista liberada | Cadastre o IP no portal |
| 404 | not_found |
Mensagem não encontrada | Confira o id |
| 422 | invalid_destination |
Número de destino inválido | Use formato internacional |
| 422 | invalid_sender |
Remetente inválido | Até 11 letras e números, ou até 15 dígitos |
| 422 | too_many_parts |
Texto excede o máximo de partes da conta | Encurte o texto (não é cobrado) |
| 422 | forbidden_content |
Texto contém termo bloqueado | Revise o texto |
| 422 | blocked_domain |
Texto contém domínio bloqueado | Remova ou troque o link |
| 422 | no_route |
Sem rota para o país de destino | Fale com seu provedor |
| 422 | insufficient_balance |
Saldo insuficiente | Recarregue |
| 422 | credential_not_synced |
Credencial recém-criada | Tente de novo em alguns segundos |
| 422 | no_api_credential |
Cliente sem credencial de API ativa | Crie uma no portal |
| 422 | invalid_schedule |
schedule_at no passado ou a mais de 30 dias |
Ajuste a data |
| 429 | throughput_exceeded |
Acima do limite de mensagens por segundo | Aguarde e reenvie |
| 503 | gateway_error |
Falha temporária | Reenvie |
Erros 429 e 503 são temporários: reenvie com espera crescente (1 s, 2 s, 4 s...). Os demais não mudam com nova tentativa.