Receber códigos de verificação do WhatsApp sem ocupar o celular de um funcionário

Por que uma equipe acaba precisando de um número de WhatsApp que não pertence a ninguém?

A situação é conhecida. Uma equipe de produto está montando um fluxo de atendimento no WhatsApp, ou testando como o aplicativo encaminha usuários para uma conversa, e alguém precisa registrar uma conta. O caminho mais rápido é usar o celular de um colega. Isso prende uma configuração da empresa ao chip de um único funcionário, mistura o tráfego de teste com as conversas particulares dele e deixa de funcionar no dia em que ele sair.

Agências que configuram o WhatsApp para clientes esbarram no mesmo problema, assim como engenheiros de QA que precisam de uma conta de teste em um mercado específico para ver como um onboarding regional se comporta. Um número de WhatsApp do OTP Gateway mantém esse trabalho longe da linha pessoal de qualquer pessoa: você escolhe o país, recebe o código de cadastro e segue em frente.

Quando o WhatsApp pede um código de verificação por telefone?

O WhatsApp identifica cada conta pelo número de telefone e, por isso, confirma o controle desse número com um código de uso único em alguns momentos:

• Cadastro: uma conta nova recebe um código de seis dígitos por SMS, e o WhatsApp pode oferecer uma chamada de voz como alternativa.
• Novo aparelho: reinstalar o app ou trocar de celular repete a verificação, e o aparelho anterior é desconectado.
• Contas comerciais: configurar o app WhatsApp Business em um número passa pela mesma etapa.
• Verificação em duas etapas: um PIN opcional escolhido pelo usuário. Ele nunca é enviado por SMS, mas é solicitado junto com o código quando está ativado.

Para quem testa, o ponto é simples: o SMS prova que você tem o número naquele momento, então um número que você já não controla não consegue verificar a conta mais tarde.

Como funciona o fluxo da API de código de verificação do WhatsApp?

Use o id de serviço whatsapp junto com o id do país do mercado em teste, como in, br ou us. Com uma chave Bearer criada no console do desenvolvedor:

1. GET /api/v1/prices?country=<id>&service=whatsapp retorna o preço atual e se essa rota está aberta agora.
2. POST /api/v1/activations com {"service": "whatsapp", "country": "<id>"} reserva um número e inicia a janela de 20 minutos.
3. Digite o número na tela de cadastro do WhatsApp e peça o SMS.
4. O código chega como evento de webhook activation.sms_received, ou você consulta GET /api/v1/activations/{id} a cada poucos segundos.
5. Se a execução for abandonada, POST /api/v1/activations/{id}/cancel devolve o valor para a carteira.

Verifique X-OTPRoute-Signature antes de confiar no corpo da requisição: calcule o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, compare com v1 e recuse timestamps antigos demais. Depois registre o evento pelo id da ativação, para que uma entrega repetida não altere nada. A consulta periódica (polling) é a opção mais simples quando um executor de testes não consegue expor uma URL pública; a documentação para desenvolvedores descreve os dois caminhos.

Em quais países há números de WhatsApp, e a escolha importa?

As rotas do WhatsApp estão disponíveis hoje em 198 países, entre eles Índia, Brasil, Indonésia, Nigéria, Alemanha, México, Reino Unido, Estados Unidos, Paquistão, Filipinas, Egito, Quênia, Espanha, Turquia e África do Sul. O conjunto completo está na página de países.

Escolha o país de propósito. Se o seu fluxo de onboarding é voltado a usuários brasileiros, um número +55 mostra como o seu app formata, valida e exibe um número local. Se a conta comercial vai atender um único mercado, use o mesmo mercado. Um país aleatório não economiza nada e pode tornar o resultado do teste inútil.

Por que o código do WhatsApp pode não chegar?

O WhatsApp decide para quais números envia mensagens e pode recusar de vez um número virtual no cadastro. Quando isso acontece, nada chega à ativação, a janela se encerra e o valor integral volta para a sua carteira; você só paga quando um código realmente chega. Outras causas são mais comuns: uma rota ocupada, o WhatsApp pedindo que você espere antes de solicitar outro código, ou um código pedido por chamada de voz em vez de SMS.

O que fazer:

• Deixe a ativação aberta durante toda a janela, em vez de cancelar depois de um minuto.
• Confira se a tela de cadastro pediu SMS e não uma ligação.
• Tente de novo mais tarde, ou use a rota de outro país, se o mercado da conta permitir.
• Espace as tentativas. Pedir código atrás de código em um laço rápido costuma piorar a situação.

Uma conta de WhatsApp de longa duração deve usar um número dedicado?

Na maioria dos casos, sim. Um número do OTP Gateway serve para um único código e, se a conta precisar ser verificada de novo depois de uma troca de aparelho ou reinstalação, você precisará desse mesmo número de volta. Para uma linha de atendimento, uma conta comercial compartilhada ou uma conta de QA que os testadores reutilizam por meses, um Número Virtual Dedicado é a melhor opção. Eles são vendidos de forma instantânea nos Estados Unidos e no Canadá a partir de $1.95/mês, renovam pela carteira, encaminham os SMS recebidos ao seu webhook como number.sms_received e podem ser liberados a qualquer momento. Fora desses dois países não há linha de longo prazo por autoatendimento; escreva para [email protected] para perguntar. Os detalhes estão na página de números virtuais.

Quem não tem acesso à API consegue fazer isso pelo painel?

Sim. Entre na conta, recarregue a carteira por cartão ou com USDT/USDC, escolha WhatsApp e um país, confirme o preço exibido e faça o pedido. Digite o número no WhatsApp e o código aparece na página da ativação assim que for recebido. Não há mensalidade nem plano, cada recarga vem com uma fatura em PDF por e-mail e vale a mesma regra de reembolso da API. Desenvolvedores que queiram ensaiar uma integração antes podem pedir ao suporte que coloque uma conta de desenvolvimento em sandbox, onde números e códigos simulados exercitam o webhook sem gastar saldo.

O que é uso responsável de números para WhatsApp?

A OTP Route existe para testar e operar seus próprios produtos e contas legítimos. Siga os termos de serviço do WhatsApp, mantenha uma conta por pessoa ou empresa real e não use as rotas para cadastrar contas em massa, enviar mensagens não solicitadas ou voltar à plataforma depois de um banimento. A Política de Uso Aceitável da OTP Route vale para cada ativação. WhatsApp é marca registrada de seu titular, e a OTP Route não tem afiliação com ele.

Perguntas frequentes

Posso receber um OTP do WhatsApp sem chip?

Sim. Um número do OTP Gateway recebe o SMS de cadastro do WhatsApp e mostra o código no seu painel ou o envia ao seu webhook, sem nenhum chip físico envolvido.

Qual é o id de serviço do WhatsApp na API?

Use whatsapp como serviço em GET /api/v1/prices e POST /api/v1/activations, junto com um id de país como in ou us.

O WhatsApp aceita qualquer número virtual?

Não. O WhatsApp pode recusar números virtuais, e é por isso que uma ativação que não recebe código é reembolsada integralmente na sua carteira.

Posso entrar de novo na conta do WhatsApp mais tarde com o mesmo número?

Não com um número do gateway, que cobre um único código. Se a conta for precisar de nova verificação, use um Número Virtual Dedicado nos EUA ou no Canadá.

Quanto custa um número de verificação do WhatsApp?

Os preços começam em $0.20 por código e variam conforme o país. O preço atual aparece no painel e no endpoint de preços antes de você pedir.

Dá para fazer a verificação por SMS do WhatsApp em testes dentro de um pipeline de CI?

Sim, para as suas próprias contas de teste. Desenvolva usando o sandbox e depois chame as rotas reais com moderação, com um intervalo crescente entre as tentativas.

Os nomes dos serviços são marcas registradas de seus respectivos proprietários. A OTP Route não é afiliada a eles. Use os números de forma lícita e siga os termos de cada serviço e nossa Política de Uso Aceitável.