API SMS Brasil: enviar ou receber códigos por API?

Antes de contratar uma API SMS Brasil, separe enviar de receber códigos. Veja critérios para avaliar o provedor, boas práticas de segurança e um fluxo de exemplo.

Por Redação Eleven Host · @robson.direitodigital · Atualizado em 18 de outubro de 2026 · 8 min de leitura

Quem procura uma API SMS Brasil precisa, antes de tudo, saber qual problema quer resolver: enviar mensagens para clientes ou receber um código num cadastro. São tarefas diferentes, com serviços diferentes. Este guia ajuda a escolher o provedor e a integrar com segurança.

Escolher errado custa tempo e dinheiro. Uma equipe contrata um provedor de envio achando que ele resolve o teste de um cadastro externo, ou o contrário. Primeiro, a diferença entre os dois casos. Depois vêm os critérios de avaliação, as boas práticas de integração e um fluxo de exemplo.

API de envio ou serviço para receber códigos

A API de envio é o que a sua aplicação usa para mandar SMS a outras pessoas: código de verificação do seu próprio sistema, aviso de pedido, lembrete de cobrança, confirmação de agendamento. Quem contrata é a empresa dona do sistema, e a cobrança segue o número de mensagens enviadas. Vale também o remetente: confira com o provedor como o nome ou número que aparece para o destinatário é cadastrado.

O serviço para receber códigos faz o caminho oposto. Você precisa de um número para concluir o cadastro de uma conta em outro sistema, ou para um teste manual. Quem usa é uma pessoa: ela pede o número, usa o código no cadastro e segue em frente.

Mensagem de aviso e mensagem de marketing

Mesmo dentro do envio há uma diferença que pesa. Uma mensagem de serviço, como o código de verificação que o usuário acabou de pedir, responde a uma ação dele. Já uma mensagem de marketing, como promoção ou novidade, exige que o cliente tenha dado consentimento e que exista uma forma clara de sair da lista. Misturar os dois tipos na mesma campanha traz problema, porque o cliente que pede para sair não deve parar de receber o aviso do pedido dele sem entender o motivo.

Guarde o registro de quando e como cada pessoa aceitou receber mensagens. Essa prática protege a empresa e ajuda no atendimento quando alguém reclama.

Como avaliar um provedor de envio

Sem citar nomes, estes são os critérios que valem comparar lado a lado antes de assinar. Peça cada resposta por escrito ao provedor:

• Rotas e taxa de entrega informada: pergunte por quais rotas as mensagens passam e qual taxa de entrega o provedor informa. Trate o número como informação dele, não como prova, e confirme com um teste seu.
• Relatório de entrega (DLR) por mensagem: o status de cada SMS, como entregue, falhou ou pendente, permite saber o que aconteceu sem depender do usuário reclamar.
• Preço por mensagem: veja se o valor é claro, se muda conforme o volume e o que acontece com mensagens que falham.
• Suporte em português: quando um código para de chegar, a conversa precisa ser clara e em português. Veja os canais e o horário de atendimento informados.
• Limite de envio: descubra quantas mensagens por segundo e por dia a conta aceita, e como pedir aumento.
• Documentação: exemplos claros, descrição dos erros e das respostas, e SDK para a sua linguagem.
• Ambiente de teste: um modo que não envia SMS de verdade, para validar a integração antes da produção; confirme com o provedor se ele cobra nesse modo.

Imagine uma loja virtual que vai avisar o cliente quando o pedido sair para entrega. A equipe monta uma planilha com três provedores e preenche cada linha com a resposta recebida. A comparação deixa de ser opinião e vira dado. No fim, o time faz um piloto pequeno com o finalista e confere o relatório de entrega antes de migrar todo o tráfego.

Boas práticas ao integrar o código de verificação

Enviar o SMS é a parte simples. A segurança está no que o seu sistema faz em volta dele. Estas práticas são conhecimento de desenvolvimento e valem para qualquer provedor:

• Código de uso único e validade curta: depois de usado ou vencido, o código não vale mais.
• Limite de tentativas: bloqueie ou atrase a verificação após algumas tentativas erradas, para ninguém adivinhar o código no escuro.
• Limite de reenvio por número e por IP: evita que alguém use o seu formulário para disparar SMS em massa e gerar custo.
• Não grave o código em log: ele é uma credencial temporária. Registre o evento, não o valor.
• Compare o código de forma segura: use a função de comparação em tempo constante da sua linguagem, em vez de um simples teste de igualdade.
• Chave da API fora do código-fonte: guarde em variável de ambiente ou cofre de segredos, e troque a chave se ela vazar.
• Assinatura no webhook: se o provedor oferecer um aviso de status por webhook, valide a assinatura antes de confiar no conteúdo.
• Fila e nova tentativa com espera: mande o envio por uma fila e, se falhar, tente de novo aumentando o intervalo entre as tentativas.
• Alternativa ao SMS: ofereça aplicativo autenticador ou e-mail para quem não recebe a mensagem.

Exemplo de fluxo em pseudocódigo

O fluxo abaixo mostra a ordem das etapas num cadastro de uma loja virtual. Não é código de nenhum provedor: troque pelos nomes da documentação do que você escolher.

1. receber o telefone e conferir o formato com código do país e DDD
2. se o limite de reenvio do número ou do IP foi atingido, recusar e avisar o usuário
3. gerar código aleatório de uso único e guardar só o resumo (hash, de preferência com chave secreta) com a hora de validade
4. colocar o envio na fila, lendo a chave da API de uma variável de ambiente
5. receber o código digitado e comparar de forma segura com o resumo guardado
6. se estiver certo e dentro da validade, invalidar o código e liberar a conta
7. se estiver errado, somar uma tentativa e bloquear ao chegar no limite

Repare que o código não aparece em log e que o limite de reenvio vem antes de gastar uma mensagem. Os dois cuidados reduzem o risco de custo e de abuso.

Quando o que você precisa é receber um código

Se você vai criar uma conta pontual numa ferramenta de terceiros, ou conferir manualmente um cadastro, não precisa de provedor de envio. O 11SMS é da Eleven Host e fica na área do cliente, com login. Oferece números temporários para receber SMS de verificação, de cadastros de pouco risco e de testes manuais.

O pagamento sai do saldo pré-pago que você recarrega em Adicionar fundos. O preço é a partir de R$ 0,49 por número, conforme o serviço e o país. Para conta que você precisa manter, como a do banco, do governo ou do e-mail principal, use um número próprio e definitivo.

Para um cadastro pontual, peça só o número de que precisa. Conhecer o 11SMS

Como pedir o número na área do cliente

1. Entre na área do cliente da Eleven Host ou crie sua conta.
2. Recarregue o saldo em Adicionar fundos.
3. Peça o número no 11SMS para o cadastro que você vai fazer.
4. Use o código recebido para concluir o cadastro.

Confira na área do 11SMS se há número para o serviço e o país de que você precisa. Se a dúvida for entre os tipos de número, o guia Número virtual é confiável? Entrega, riscos e roteiro ajuda a decidir, e o Número temporário ou número virtual: qual a diferença? explica cada categoria.

SMS ainda é um bom canal de verificação?

O SMS não exige que o usuário instale nada, e isso facilita o cadastro. O ponto fraco é a troca de chip indevida: alguém convence a operadora a passar a linha de outra pessoa para um chip novo e passa a receber os códigos dela. Por isso, para contas de valor, vale oferecer outra opção, como um aplicativo autenticador. Se o seu usuário receber um código que não pediu, o guia Recebi código de verificação sem pedir: o que fazer orienta a resposta.

Para os testes manuais do seu cadastro, veja como pedir um número. Acessar o 11SMS

Perguntas frequentes

Preciso de API para receber um código só?

Não. Para um cadastro pontual, basta ter um número que receba o SMS. A API de envio é para o seu sistema mandar mensagens a outras pessoas.

Quanto custa enviar SMS por API?

Depende do provedor e do volume. Compare o preço por mensagem de cada um, e veja o que é cobrado quando o envio falha.

SMS ainda vale para verificação?

Vale como opção, com cuidado. A troca de chip indevida é um risco, então ofereça um aplicativo autenticador como alternativa nas contas de maior valor.

Posso mandar promoção por SMS?

Só para quem deu consentimento, e com uma forma clara de sair da lista. Guarde o registro de quando cada pessoa aceitou e separe essas mensagens dos avisos do pedido.