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.