Guia · API de SMS no Brasil
Como avaliar uma API de SMS transacional no Brasil
Uma API de SMS transacional deve permitir que a equipe responda não apenas se a requisição retornou sucesso, mas qual tentativa ocorreu, qual evidência existe e como o custo foi produzido.
Separe aceitação, transmissão e entrega
HTTP 202 normalmente comprova que o comando foi aceito e persistido. O acknowledgment do provedor comprova outra etapa. O delivery receipt, quando disponível, comprova um resultado posterior. Uma API confiável não resume esses fatos em um único booleano.
Exija idempotência no comando
Timeouts e quedas de conexão fazem parte de sistemas distribuídos. A mesma chave de idempotência deve recuperar o resultado original para o mesmo comando e rejeitar conteúdo incompatível.
Teste antes de contratar Produção
Uma Sandbox útil preserva schemas e estados de Produção, mas não alcança operadoras nem gera cobrança. Resultados determinísticos tornam testes de integração repetíveis e permitem validar casos adversos.
Compare custo e evidência na mesma unidade
Caracteres fora do alfabeto GSM-7 podem reduzir a capacidade de cada segmento. Avalie se o provedor oferece preview autoritativo e se cada lançamento financeiro aponta para a tentativa que o originou.
- Contrato OpenAPI e SDK derivado do mesmo contrato.
- Chaves e webhooks separados por ambiente.
- Estados explícitos, inclusive resultado inconclusivo.
- Rate limits e códigos de erro documentados.
- Políticas públicas de privacidade e uso aceitável.