Como enviar SMS via API: guia prático em 2024

Enviar SMS via API é hoje a forma mais rápida e confiável de incluir mensagens de texto em qualquer aplicação — de códigos de verificação (OTP) a alertas transacionais. Neste guia você vai do zero ao primeiro SMS entregue em poucos minutos.

O que você precisa antes de começar

Para disparar a primeira mensagem você precisa apenas de três coisas: uma conta ativa, um token de API e créditos. Na SMSGo o token fica disponível no painel logo após o cadastro, e os créditos são pré-pagos — sem mensalidade.

Autenticação por token

A autenticação é feita via header Authorization: Bearer <token>. Guarde o token como um segredo (variável de ambiente), nunca no código versionado.

Sua primeira requisição

O endpoint de envio recebe o número de destino no formato internacional e a mensagem. Em cURL:

curl https://api.SMSGo.io/v1/sms/send \
  -H "Authorization: Bearer <token>" \
  -d '{"to":"+5511999990000","message":"Seu código: 4821"}'

Os mesmos parâmetros valem para os SDKs oficiais de Node.js, Python e PHP — todos tipados e com retry embutido.

Tratando a resposta

A API responde em poucas centenas de milissegundos com um id e um status. Para acompanhar o ciclo de vida completo da mensagem (entregue, falhou, respondido) o ideal é configurar um webhook de SMS em vez de ficar consultando o status.

Próximos passos

Se o seu caso de uso é verificação de cadastro ou login, vale entender o que é o OTP e como funciona. Para acelerar, copie um modelo pronto de SMS. Pronto para disparar? Crie sua conta e comece com créditos de teste.