Como receber SMS com um número virtual
Equipe AltiviaCloud · September 1, 2026 · 4 min read
O que acontece entre comprar o número e o código chegar, como escolher o país certo e por que consultar em laço é a pior das três formas de esperar o SMS.
Toda vez que um serviço pede "confirme seu telefone", ele está resolvendo um problema que não é o seu: provar que existe uma pessoa por trás do cadastro. O custo cai no seu colo — você entrega o número pessoal e passa a receber o que vier depois.
Número virtual resolve isso separando as duas coisas. Você recebe o código, o serviço fica satisfeito, e o seu número continua sendo seu.
O que acontece quando você compra um número
O fluxo tem quatro passos, e entender cada um evita quase todo erro de integração:
- Você escolhe país e serviço. Não é só o país: o número precisa estar habilitado para aquele serviço específico. Um número que recebe SMS do Google pode não receber do WhatsApp, porque a operadora e o destino tratam as faixas de numeração de forma diferente.
- O número é reservado para você. Enquanto o pedido está aberto, aquele número não vai para mais ninguém. É o que garante que o código que chegar seja o do seu cadastro.
- O SMS chega. O código aparece no painel e na API.
- O pedido termina. O número volta para o estoque e fica disponível para outra pessoa.
O passo 4 é o que costuma surpreender quem começa. O número não é seu para sempre. Ele é uma linha emprestada pelo tempo de uma verificação. Se o serviço mandar um segundo SMS uma semana depois, você não vai receber.
Escolhendo o país certo
A escolha do país não é uma preferência estética. Ela muda se o cadastro funciona.
Serviços olham o prefixo do número e tiram conclusões. Alguns só aceitam número do país onde você diz morar. Outros bloqueiam faixas inteiras que já foram usadas demais. E alguns oferecem preço, conteúdo ou até funcionalidade diferente conforme o país da linha.
Na prática: se o cadastro é em um serviço brasileiro, use número do Brasil. Se você está testando como o seu próprio produto se comporta para um cliente na Alemanha, use um número alemão. Escolher o país "mais barato da lista" é a forma mais comum de gastar dinheiro em um pedido que nunca vai receber o código.
Recebendo o código pela API
Se for uma vez só, o painel resolve. Se for parte de um processo, a API v1 é o caminho.
Primeiro, o pedido:
curl -X POST https://api.altiviacloud.com.br/api/v1/orders \
-H "Authorization: Bearer ac_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{"countryId": "id_do_pais", "serviceId": "id_do_servico"}'