Pular para conteúdo

Erros

Toda resposta de erro da API tem o formato:

{ "error": { "code": "invalid_destination", "message": "..." } }

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.