Comece · 5 minutosAbrir para IA

Envie e acompanhe seu primeiro SMS de teste

Use a Sandbox para validar autenticação, idempotência, estados e webhooks sem alcançar uma operadora ou gerar cobrança.

Antes de começar

Sandbox

Nenhuma

Determinístico

1. Crie uma chave da Sandbox

No console, selecione Sandbox, abra Chaves de API e crie uma chave com messages:send e messages:read. O segredo aparece uma única vez.

2. Envie a mensagem

Use uma Idempotency-Key estável para a mesma intenção. O HTTP 202 prova que a mensagem e o outbox foram persistidos; não prova entrega no aparelho.

curl https://sandbox.api.mandaionline.com/v1/messages \
  --request POST \
  --header "Authorization: Bearer $MANDAI_SANDBOX_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: quickstart-message-0001" \
  --data '{"to":"+5511000000001","body":"Mandai sandbox ready"}'

3. Acompanhe a evidência

Guarde o message_id retornado.
Abra Mensagens e confirme a sequência queued → provider_acknowledged → delivered.
Configure um endpoint e valide ao menos uma assinatura de webhook.
Abra o detalhe da mensagem para inspecionar o recibo.