Solução · API de SMS transacional
API SMS no Brasil: gateway para SMS transacional
Conecte seu sistema ao gateway SMS do Mandaí para enviar confirmações, alertas e códigos de acesso no Brasil. Integre pela API HTTP, teste na Sandbox gratuita e acompanhe cada mensagem do pedido ao resultado pelo mesmo message_id.
Quando usar SMS transacional
SMS transacional comunica um evento esperado pelo destinatário: confirmação de pedido, alerta de segurança, atualização logística ou mudança relevante em uma conta. O envio nasce de uma ação do usuário ou de um evento operacional, não de uma campanha.
O Mandaí foi desenhado para times de software que precisam integrar esse fluxo ao backend e investigar o que ocorreu depois da requisição.
- Confirmações de cadastro, pagamento, pedido ou agendamento.
- Alertas de segurança e alterações importantes de conta.
- Atualizações de entrega, serviço ou operação.
- Códigos de autenticação em fluxos adequadamente protegidos.
Como funciona um gateway SMS com API
O gateway conecta o backend da sua aplicação à infraestrutura de envio de SMS. Você envia uma requisição HTTP autenticada, recebe um identificador e acompanha os estados pela API ou por webhooks.
No Mandaí, a Sandbox simula resultados sem entregar mensagens a telefones reais. Em Produção, o envio depende de capacidade mensal ativa. HTTP 202 confirma a aceitação do comando; a entrega depende de evidência posterior.
Quanto custa integrar a API SMS
A Sandbox é gratuita. Produção custa R$ 49,00 por mês mais R$ 0,13 por SMS contratado, com mínimo de 250 SMS: R$ 81,50 mensais. Mensagens longas ou com determinados caracteres podem usar mais de um segmento; confira o preview antes de enviar.
Uma intenção, uma chave de idempotência
Uma interrupção de rede não informa se o servidor recebeu ou não o comando. Por isso, o cliente preserva o mesmo corpo e a mesma Idempotency-Key ao repetir a requisição. O Mandaí devolve o resultado original ou rejeita uma reutilização incompatível.
Esse contrato reduz duplicidade sem transformar atraso de confirmação em autorização para enviar novamente.
Resultado e custo ligados à evidência
queued, provider_acknowledged, delivered, failed e unknown respondem a perguntas diferentes. A ausência de um recibo positivo não é convertida artificialmente em falha, e unknown não dispara outro SMS.
A Produção exige capacidade mensal contratada. A Sandbox permanece isolada, simulada e sem cobrança.
Comece sem alcançar um telefone real
Use destinos determinísticos da Sandbox para exercitar entrega, falha, atraso e resultado inconclusivo. Depois valide assinatura de webhook, idempotência e tratamento de estados antes de contratar e usar Produção.
curl https://sandbox.api.mandaionline.com/v1/messages \
-H "Authorization: Bearer $MANDAI_API_KEY" \
-H "Idempotency-Key: order-123-confirmation" \
-H "Content-Type: application/json" \
-d '{"to":"+5511000000001","body":"Pedido confirmado"}'Perguntas frequentes
O Mandaí envia campanhas de SMS?
Não. O produto é dedicado à comunicação operacional e transacional de empresas de software, não a campanhas, CRM, prospecção ou disparo em massa.
A Sandbox consome capacidade contratada?
Não. Ela é gratuita, isolada de Produção, não alcança operadoras nem destinatários reais e usa resultados determinísticos.