Como testar o envio de OTP por SMS em homologação
Para testar se o código OTP do seu sistema chega de verdade, você precisa de números reais de operadoras, não de simuladores. Com a API do Flash SMS, o teste vira um script: pede um número, dispara o código do seu sistema para ele e lê o SMS com getStatus.
- Escolha o código de serviço.
- Peça um número.
- Dispare o OTP.
- Leia e meça.
Passo a passo
Como testar o envio de OTP por SMS em homologação
Escolha o código de serviço
O seu aplicativo provavelmente não está na lista. Use o código de Outros (ot), confirmando em getServicesList, ou o serviço do provedor que envia o SMS, se ele estiver listado.
Peça um número
Chame getNumber com o serviço escolhido e country=73. No server=2, use operator para testar uma operadora específica.
Dispare o OTP
No seu ambiente de homologação, peça o código para o número recebido, no formato que o seu sistema espera.
Leia e meça
Consulte getStatus a cada 5 segundos, registre o tempo até o STATUS_OK e compare o texto com o esperado.
O que vale a pena medir
- Se o SMS chega, em cada operadora (claro, vivo, tim, oi e outras aceitas em operator).
- Tempo entre o disparo e o STATUS_OK.
- Se o código extraído bate com o gerado pelo seu sistema.
- Se o reenvio funciona: setStatus status=3 libera o mesmo número para outro SMS, e o seu sistema dispara de novo.
- Como o seu sistema se comporta com número que já foi usado por outra pessoa no passado.
Custos do teste
Cada número é cobrado do saldo da conta, pelo preço de revendedor. A opção Outros sai por R$ 1,05 no painel. Se o seu sistema não enviar nada e o número expirar, o valor volta para o saldo, então um teste que falha por bug do seu lado não custa nada. Escolher DDD (server=2) soma 30%; só use quando o DDD for parte do teste.
Limites do teste com número virtual
O número fica ativo 20 minutos e recebe só SMS. Testes de ligação de voz, de mensagens longas por vários dias ou de entrega em massa não cabem aqui. O objetivo é validar o fluxo de verificação, com poucos números por rodada.
Não use números de teste para criar contas reais em serviços de terceiros. O teste é do seu próprio produto.
Automatize no seu pipeline
Um job agendado que roda o teste algumas vezes por dia avisa quando o seu provedor de SMS começa a falhar numa operadora, antes que os usuários reclamem. Guarde o resultado de cada rodada e use getBalance para acompanhar o gasto.
Dúvidas
Perguntas frequentes
Posso receber o SMS de um remetente curto (short code)?
Depende da rota da operadora e do provedor. O teste existe justamente para descobrir isso; se não chegar, o valor volta.
O texto completo do SMS aparece?
Pela API, getStatus devolve o código no formato STATUS_OK:código. A documentação não descreve retorno do texto completo, então o teste automático deve comparar o código.
Quantas vezes posso pedir outro SMS no mesmo número?
Enquanto a ativação estiver dentro dos 20 minutos e a operadora liberar. Quando não libera, a resposta é BAD_STATUS.
API e integrações
Continue lendo
Como automatizar o recebimento do código SMS pela API
Consulta periódica com getStatus, os estados possíveis e quando parar.
Erros comuns da API do Flash SMS e como resolver
Cada resposta de erro da documentação, com a causa e a correção.
API de SMS em Python: comprar número e ler o código
Um script curto com requests, do getNumber ao código na tela.
API de SMS em Node.js: exemplo com fetch
fetch nativo, URLSearchParams e um laço com await.
API de SMS em PHP: comprar número e receber o código
http_build_query, file_get_contents e um laço com sleep.
Saldo para revendedores: como funciona o saldo usado pela API
Um saldo só para painel e API, debitado por número comprado.
Receba seu primeiro código hoje
Cadastro em menos de um minuto, recarga por Pix, cartão ou cripto e o SMS no painel. Se não chegar, o valor volta.
Criar conta grátis