Uma API de SMS é uma interface de programação que permite ao seu software enviar e receber mensagens de texto por meio de um provedor: você faz uma requisição HTTP (ou abre uma conexão SMPP) com o número, o remetente e o texto, e o provedor entrega a mensagem e devolve o status. É assim que os apps enviam códigos OTP, alertas e notificações sem nenhuma infraestrutura de telecom própria.
O que é uma API de SMS?
Uma API de SMS expõe o gateway de SMS de um provedor aos desenvolvedores. A maioria é API REST sobre HTTPS: você se autentica com uma chave de API ou token, faz um POST da mensagem e recebe de volta um ID de mensagem. O provedor cuida do roteamento até as operadoras, da codificação, da divisão de mensagens longas e dos relatórios de entrega. Muitos provedores também oferecem SMPP para remetentes de alto volume. O sistema por trás da API é explicado em o que é um gateway de SMS.
Como funciona uma API de SMS?
- Autenticação. Cada requisição leva uma chave de API, um bearer token ou credenciais básicas.
- Envio da requisição. Normalmente um POST com o número de destino no formato E.164, um sender ID ou número, o texto da mensagem e, opcionalmente, uma URL de callback.
- Recebimento de um ID. A API devolve um ID de mensagem (ou um erro, como número inválido ou saldo insuficiente).
- O provedor roteia a mensagem até a operadora de destino, diretamente ou por meio de um agregador.
- Recebimento do status. Os relatórios de entrega chegam ao seu webhook conforme o status muda: na fila, enviada, entregue, falhou, com um código de erro.
- Recebimento de respostas. SMS recebidos no seu número ou short code são enviados para outro webhook.
Uma requisição de envio típica, em termos simples: to = +447700900123, from = SuaMarca, text = "Seu código é 482917", callback = sua URL de status. Os nomes dos campos variam conforme o provedor. Armazene os números no formato internacional descrito em formato de número E.164.
Integração de API de SMS: passo a passo
- Escolha o protocolo. HTTP para a maioria dos apps; SMPP se você envia alto volume ou revende. Veja SMPP vs HTTP para SMS.
- Registre os remetentes. Antes de entrar em produção, registre sender IDs, números ou modelos nos países que exigem. Veja registro de sender ID de SMS.
- Mantenha as chaves em segredo. Chame a API pelo seu servidor, nunca por um app móvel ou navegador, para que a chave não possa ser extraída.
- Trate os webhooks. Verifique as assinaturas se o provedor oferecer, responda rápido e processe de forma assíncrona.
- Trate erros e novas tentativas. Tente de novo em erros de rede e temporários, com intervalo crescente; não repita erros permanentes, como número inválido.
- Controle codificação e tamanho. Mantenha as mensagens em GSM-7 sempre que possível. Veja GSM-7 vs Unicode.
- Proteja os gatilhos. Limite a taxa de qualquer formulário público que envie SMS, para impedir o SMS pumping.
- Teste em aparelhos reais em cada país de destino antes do lançamento. Veja como testar uma rota de SMS.
O que é uma chave de API de SMS?
A chave de API de SMS é a credencial secreta que identifica a sua conta em cada requisição. Quem tiver essa chave pode enviar mensagens cobradas de você, então trate-a como uma senha: guarde em variáveis de ambiente ou em um gerenciador de segredos, restrinja por IP quando o provedor permitir, troque periodicamente e revogue imediatamente se vazar.
O que buscar em uma API de SMS para desenvolvedores
| Área | O que verificar |
|---|---|
| Qualidade das rotas | Quais rotas estão por trás da API nos seus países, e se os relatórios de entrega vêm das operadoras |
| Relatórios de entrega | Webhooks com status e códigos de erro claros. Veja códigos de status DLR de SMS |
| Documentação e SDKs | Exemplos claros, sandbox ou modo de teste, bibliotecas para a sua linguagem |
| Limites | Requisições por segundo, tamanho da mensagem, endpoints de envio em massa |
| Apoio à conformidade | Ajuda com registro de sender ID, 10DLC, DLT e modelos |
| Controles antifraude | Listas de países permitidos, limites de taxa, alertas de gasto |
| Modelo de preço | Por parte de mensagem por país, cobrado por mensagem enviada ou entregue |
Mais critérios em como escolher um provedor de SMS A2P.
Quanto custa uma API de SMS?
O preço de uma API de SMS é quase sempre por parte de mensagem, definido por país de destino, porque as tarifas de terminação das operadoras são a maior parte do custo. Alguns provedores cobram também mensalidades por números ou sender IDs. A API mais barata nem sempre é a mais barata por mensagem entregue: veja preço de SMS explicado.
Rotas por trás da sua API de SMS
Se você opera sua própria plataforma ou API e precisa de rotas de fornecimento, a VoIPMatcher busca rotas de SMS A2P via HTTP e SMPP junto às suas carriers e as gerencia. Solicite uma rota de SMS para a sua API.
Perguntas frequentes
Qual é a diferença entre uma API de SMS e um gateway de SMS?
O gateway de SMS é o sistema que encaminha as mensagens para as redes móveis; a API de SMS é a interface que os desenvolvedores usam para acessá-lo. Quando se comparam APIs de SMS, na verdade se compara o gateway, as rotas e o suporte por trás de cada API, além da qualidade da documentação e das ferramentas.
Posso enviar SMS pelo meu site com uma API?
Sim. O backend do seu site chama a API de SMS para enviar mensagens como confirmações de pedido, lembretes ou códigos de verificação. Faça a chamada pelo servidor, nunca pelo código do navegador, para que a chave de API continue secreta. Proteja qualquer formulário público que dispare SMS com detecção de bots e limites de taxa para evitar abuso.
Existe API de SMS grátis?
Alguns provedores oferecem crédito de teste grátis ou modo sandbox para testes, mas enviar SMS reais sempre custa dinheiro, porque as operadoras móveis cobram por cada mensagem entregue. Serviços que prometem envio de SMS grátis para sempre normalmente dependem de rotas não autorizadas ou de publicidade, o que torna a entrega instável e inadequada para uso empresarial.
Uma API de SMS pode receber mensagens?
Sim, se você tiver um número ou short code que aceite SMS de entrada. O provedor encaminha cada mensagem recebida para a URL do seu webhook com o remetente, o texto e o horário. Isso permite usos bidirecionais, como respostas, descadastro por palavra-chave como STOP e conversas de suporte. Sender IDs alfanuméricos não podem receber respostas.
Quanto tempo leva a integração de uma API de SMS?
Uma integração básica que envia uma mensagem e trata os relatórios de entrega pode levar algumas horas para um desenvolvedor, com uma API REST bem documentada. Deixar tudo pronto para produção leva mais tempo: registro de sender ID e de modelos em cada país, tratamento de erros, novas tentativas, descadastros, monitoramento e controles antifraude podem acrescentar de dias a semanas, conforme os países.
Precisa de uma rota?
Envie o destino, o tipo de rota e a tarifa alvo. Respondemos com o que podemos entregar.