Um número para teste de SMS permite validar cadastro e login com código de verificação no seu próprio aplicativo sem usar o celular pessoal da equipe. Neste guia você vê quando usar números fictícios, quando precisa de um número real e como automatizar os testes com API.
Todo aplicativo que manda código por SMS tem um ponto frágil: o fluxo de verificação. Ele depende de operadora, provedor de envio, formato do número e tempo de entrega. E, mesmo assim, muita equipe testa isso com o celular do desenvolvedor, na mão, antes de cada versão. Dá para fazer melhor.
Por que testar a verificação por SMS
O SMS de verificação costuma estar na porta de entrada do produto. Se ele falha, o usuário não consegue criar a conta nem entrar. Alguns problemas comuns que só aparecem em teste real:
- Máscara do campo que não aceita certos formatos ou códigos de país.
- Número salvo sem o código do país e SMS que nunca é entregue.
- Código que expira rápido demais ou que não é invalidado depois do uso.
- Limite de reenvio mal configurado, que bloqueia usuários legítimos.
- Texto do SMS cortado, sem o nome do app ou sem o código no começo.
- Mudança de provedor de envio que quebra a entrega para alguns países.
Tipos de número para testes
Números fictícios do provedor de autenticação
Muitos provedores de autenticação e de envio de SMS permitem cadastrar números fictícios de teste com um código fixo. Nenhuma mensagem é enviada de verdade: o sistema aceita aquele número e aquele código. É ótimo para testes unitários e de interface, porque é rápido, grátis e previsível.
A limitação é clara: esse teste não passa pela operadora. Ele não mostra se o SMS chega de verdade, quanto tempo demora nem como o texto aparece no aparelho.
Chips físicos da equipe
Alguns times mantêm uma gaveta de chips pré-pagos para testes. Funciona, mas dá trabalho: é preciso manter os chips ativos, ter aparelhos ligados, controlar quem está usando qual número e ainda copiar o código na mão. Não escala para testes automatizados.
Números temporários reais
Um número temporário recebe SMS de verdade, pela rede, e mostra o código em uma tela ou por API. É o meio-termo entre o número fictício e o chip físico: teste de ponta a ponta, sem aparelho, sem expor o celular de ninguém. No 11SMS, da Eleven Host, você escolhe o serviço e o país, vê o preço antes de comprar e recebe o número na hora. Para entender o conceito em detalhes, veja o guia sobre número temporário para SMS.
Como montar o teste em homologação
O ambiente de homologação deve ser o mais parecido possível com a produção, inclusive no envio de SMS. Uma rotina simples:
- Separe as credenciais. Use chaves e contas de envio de SMS específicas para homologação, com limite de gastos próprio.
- Cubra os casos com números fictícios. Validação de campo, código errado, código expirado e reenvio podem ser testados sem SMS real.
- Reserve o SMS real para os fluxos críticos. Cadastro, login e troca de número, antes de cada versão importante.
- Teste os países que importam. Se o app atende outros mercados, verifique a entrega com números daqueles países. O 11SMS tem mais de 150 países e números do Brasil (+55) quando há estoque.
- Registre os resultados. Tempo até o SMS chegar, texto recebido e falhas, para comparar entre versões e provedores.
Teste o seu fluxo de SMS de ponta a ponta. Comprar número de teste
Automatizando os testes com a API
Para testes automatizados, a API REST do 11SMS faz o que um testador faria no painel. O fluxo típico em um teste de ponta a ponta:
- O teste compra um número pela API, informando o serviço, o país, uma referência (como o nome do teste ou o número da build) e um preço máximo.
- O teste digita o número no cadastro do seu app, pelo navegador automatizado ou pelo emulador.
- O código chega. O teste consulta o número pela API ou recebe o aviso do webhook assinado com o evento de código recebido.
- O teste digita o código e confere se o cadastro foi concluído.
- O teste marca a compra como concluída ou cancela o número se o SMS não veio.
A chave da API é gerada na Área do Cliente e enviada no cabeçalho X-Api-Key. Os endpoints, o endereço base e os exemplos completos estão na documentação da API do 11SMS. Se você quer entender a diferença entre APIs de envio e de recebimento, leia o artigo sobre API SMS Brasil.
Boas práticas para testes com SMS
Nunca use números de clientes
Em homologação, dados reais de clientes não devem aparecer, e isso inclui o telefone, que é dado pessoal pela LGPD. Copiar a base de produção para teste e disparar SMS para clientes reais é um erro caro e constrangedor.
Não dependa do número depois do teste
O número temporário fica ativo por 20 minutos e depois é reciclado: volta para o fornecedor e pode ir para outra pessoa. Contas de teste criadas com ele não devem depender desse número para recuperação. Para contas de teste permanentes, use números fictícios do provedor ou um chip próprio da empresa.
Controle os custos
O pagamento é feito com o saldo pré-pago da conta Eleven Host, sem mensalidade. O preço varia por serviço e país, de centavos a poucos reais, e aparece antes da compra. Na API, o campo de preço máximo evita que um teste compre um número acima do orçamento. Se nenhum SMS chegar em 20 minutos, o valor volta sozinho para o saldo, então um teste que falha por falta de entrega não gera custo.
Trate falhas e tempos de espera
Defina um tempo máximo de espera pelo código no teste. Se ele não vier, cancele o número (possível a partir de 2 minutos após a compra, com estorno) e marque o teste como falho por entrega, não por erro do app. Isso ajuda a separar problema do seu código de problema de operadora.
Não guarde códigos além do necessário
Registre no log se o código chegou e em quanto tempo, mas evite guardar o código em si por muito tempo. No 11SMS, o conteúdo dos SMS fica guardado por até 30 dias e depois é apagado.
Rode a automação em um lugar estável
Pipelines de CI e robôs de teste que dependem de webhook precisam de um endereço acessível e sempre ligado. Uma VPS resolve isso sem depender da máquina de ninguém.
O que não é teste
Teste é verificar o seu aplicativo, ou uma ferramenta que a sua empresa usa legitimamente. Criar contas em massa ou falsas em aplicativos de terceiros, burlar limites, bloqueios ou banimentos, abusar de promoções ou enviar spam não é QA, e é proibido pelos termos do 11SMS, com bloqueio da conta. Respeite também os termos de cada serviço.
Automatize os testes de SMS da sua equipe. Criar conta grátis
Se a sua equipe também faz cadastros em ferramentas de terceiros, veja o guia de número virtual para empresa.
Perguntas frequentes
Posso usar o mesmo número em vários testes?
Dentro dos 20 minutos, em muitos serviços dá para pedir outro SMS no mesmo número. Depois disso, o número é reciclado e você compra outro.
Números fictícios não bastam?
Para testes de interface e regras, sim. Para saber se o SMS chega de verdade pela operadora, é preciso um número real.
O teste paga se o SMS não chegar?
Não. Se nenhum SMS chegar em 20 minutos, o valor volta sozinho para o saldo.
Funciona com qualquer aplicativo?
Não há garantia. Alguns serviços recusam números virtuais. Para o seu próprio app, você controla essa regra no provedor de envio.
