API de número virtual para WhatsApp: o fluxo completo
Para pegar um número de WhatsApp pela API do Flash SMS, você chama getNumber com service=wa, espera o código com getStatus e encerra com setStatus. O código wa é o mesmo do padrão sms-activate, e country=73 é o Brasil.
- Confira preço e estoque.
- Compre o número.
- Leia o código.
- Finalize ou cancele.
Passo a passo
API de número virtual para WhatsApp: o fluxo completo
Confira preço e estoque
Chame action=getPrices com service=wa e country=73. A resposta em JSON traz cost (o que você paga) e count (números disponíveis).
Compre o número
Chame action=getNumber com service=wa e country=73. A resposta vem como ACCESS_NUMBER:id:número, por exemplo ACCESS_NUMBER:933749378:5511987654321.
Leia o código
Chame action=getStatus com o id a cada 5 a 10 segundos. Enquanto aguarda, vem STATUS_WAIT_CODE; quando chega, STATUS_OK seguido do código.
Finalize ou cancele
Com o código em mãos, setStatus status=6 finaliza. Sem código depois de 2 minutos, setStatus status=8 cancela e devolve o valor ao saldo.
O número vem com o 55 na frente
O número retornado inclui o código do país, como 5511987654321. No WhatsApp, o usuário escolhe Brasil (+55) e digita só o DDD e o número. Se o seu sistema mostrar o número para alguém digitar, separe o 55 para evitar erro de digitação, que é uma das causas mais comuns de código que nunca chega.
Quando o WhatsApp pede outro código
Às vezes o código expira ou é digitado errado. Dentro dos 20 minutos, depois do primeiro código, chame setStatus status=3. A resposta ACCESS_RETRY_GET indica que o pedido foi aceito, e getStatus passa a devolver STATUS_WAIT_RETRY com o código anterior até o novo STATUS_OK chegar. Não há custo. Se a operadora não liberar, a resposta é BAD_STATUS.
Ligação não funciona
O WhatsApp pode oferecer verificação por ligação. Números virtuais recebem só SMS, então o seu sistema deve orientar o usuário a pedir o código por SMS. Se aparecer só a opção de ligação, é melhor cancelar a partir de 2 minutos e tentar outro número.
Respostas que o seu código precisa tratar
- NO_NUMBERS: sem estoque naquele país e servidor. Nada foi cobrado; tente server=2 ou 3.
- NO_BALANCE: seu saldo no Flash SMS acabou.
- EARLY_CANCEL_DENIED: tentativa de cancelar antes de 2 minutos.
- BAD_STATUS no status=6: o código ainda não chegou; use status=8 para cancelar.
- STATUS_CANCEL: a ativação acabou sem SMS e o valor já voltou.
Dúvidas
Perguntas frequentes
Por que o WhatsApp é mais caro que outros serviços?
O WhatsApp recusa números reciclados, então os números aceitos são mais disputados. No painel, o brasileiro sai por R$ 14,54; números de outros países costumam sair mais baratos, mas variam.
Como pego número de WhatsApp de outro país?
Troque country pelo código do país. A lista completa vem de getCountries, e getPrices mostra custo e estoque por país.
Posso escolher o DDD do número de WhatsApp?
No server=2, para country=73, use ddd (com 30% a mais no preço) e operator (sem custo extra). Sem número com esse filtro, a resposta é NO_NUMBERS.
O que o usuário deve fazer depois de verificar?
Ativar a confirmação em duas etapas do WhatsApp e cadastrar um e-mail. O número volta para o estoque, então o PIN é o que protege a conta numa nova verificação.
API e integrações
Continue lendo
Como precificar a revenda de números virtuais
Custo do getPrices, margem em percentual e regras para quando o custo muda.
Bot do Telegram para vender números virtuais: como estruturar
Comandos, servidor, banco de dados e a rotina que entrega o código.
Como testar o envio de OTP por SMS em homologação
Números reais de operadoras brasileiras para validar o SMS do seu produto.
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.
Receba o código do WhatsApp em segundos
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