Definição
Uma API de SMS é uma interface web, geralmente REST sobre HTTPS com JSON, que permite a um software enviar SMS, receber respostas e consultar status de entrega de forma programática, sem precisar gerenciar conexões de telecom diretamente.
Uma chamada típica envia a um endpoint, com um token de API, o destinatário no formato E.164, o ID de remetente (Sender ID) e o texto, e recebe de volta um ID de mensagem. Os status de entrega e as respostas recebidas chegam depois, via webhooks.
Em comparação com o SMPP, uma API HTTP é mais fácil de integrar, passa por firewalls convencionais e se adapta bem a aplicações web e serverless. O SMPP é mais eficiente para volumes muito altos e contínuos.
Boas práticas: mantenha os tokens no servidor, torne os envios idempotentes para que novas tentativas não dupliquem mensagens, trate as respostas 429 de limite de taxa e verifique as requisições de webhook.
A API REST da OmniChannels.ai, em api.broadnet.me, usa autenticação por bearer token e cobre SMS junto com WhatsApp, RCS e outros canais.
Exemplo
POST /sms {"to":"+971501234567","from":"AcmeBank","text":"Seu código é 482913"}