Mandaí · Desenvolvedores
Mandaí para desenvolvedores e agentes
Integre SMS transacional no Brasil com um contrato HTTP público, credenciais por ambiente e uma Sandbox gratuita que não envia mensagens reais.
Quando usar o Mandaí
Use o Mandaí para códigos de autenticação, confirmações de pedidos, alertas de segurança e atualizações operacionais esperadas pelo destinatário. Agentes podem consultar documentação, estimar contratos e calcular segmentos antes de propor uma integração.
A API pública é REST/JSON, descrita em OpenAPI 3.1. Não existe endpoint GraphQL. Chamadas com efeitos exigem credencial, escopo e autorização do responsável; a documentação pública não concede permissão para enviar mensagens.
1. Crie uma conta e uma chave Sandbox
Entre pelo login, conclua a criação do workspace e selecione Sandbox. Na página Chaves de API, crie uma chave com os escopos necessários. A credencial é exibida uma única vez: guarde-a no gerenciador de segredos do seu backend.
A Sandbox é gratuita, isolada de Produção e usa resultados determinísticos. Não precisa de conversa comercial e não alcança operadoras, telefones reais ou cobrança. O login e o consentimento pertencem ao titular da conta; não automatize a aceitação de termos em nome de terceiros.
2. Faça uma prévia antes de enviar
Configure MANDAI_API_KEY no ambiente do terminal e use o destino determinístico abaixo. O preview calcula encoding e segmentos sem criar uma mensagem. O envio exige messages:send e uma Idempotency-Key estável por intenção; HTTP 202 confirma aceitação, não entrega.
curl --fail-with-body https://sandbox.api.mandaionline.com/v1/messages/preview \
-H "Authorization: Bearer $MANDAI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"to":"+5511000000001","body":"Pedido confirmado"}'SDK e CLI oficiais
O pacote público @mandai/sdk oferece o cliente JavaScript/TypeScript e o executável mandai. A CLI usa Sandbox por padrão, retorna JSON para automação e exige seleção explícita de Produção. Nunca coloque a chave em argumentos de linha de comando, prompts ou código público.
npm install -g @mandai/sdk
mandai --help
mandai preview --to +5511000000001 --body "Pedido confirmado"MCP e OAuth para agentes
Conecte um cliente MCP ao endpoint HTTPS abaixo. A inicialização, a listagem de ferramentas e os recursos públicos podem ser consultados sem credencial. O envio send_sms exige autenticação; OAuth com DPoP permite delegar acesso com escopos e vínculo ao recurso.
Para Produção, configure uma chave própria do ambiente e capacidade mensal ativa após pagamento conciliado e cobertura operacional saudável. Não reutilize uma chave Sandbox nem interprete unknown como autorização para reenviar.
https://mcp.mandaionline.com/mcp