Escolhendo uma rota +55 para a verificação por SMS no Brasil

Um teste no Brasil deve usar o OTP Gateway ou uma linha de longo prazo?

Comece pelo formato do trabalho, porque ele define o produto. Um teste de verificação no Brasil normalmente precisa de um código, uma vez: uma tela de cadastro em português, um desafio de login, uma etapa de troca de telefone. É exatamente para isso que o OTP Gateway foi feito. Você escolhe um serviço e o Brasil, recebe um número +55 para um único código, e a ativação se encerra após 20 minutos ou quando o SMS chega.

Uma linha de longo prazo é outra história. Os Números Dedicados são um produto dos Estados Unidos e do Canadá, vendidos instantaneamente no painel a partir de $1.95/mês, com SMS de entrada, SMS de saída e chamadas pelo navegador. Não existe número +55 de longo prazo em autoatendimento. Se sua equipe realmente precisa de uma linha brasileira para manter, escreva para [email protected] e descreva o caso de uso; a possibilidade depende das regras locais, e nada é prometido.

Uma regra prática rápida:

• Um código por caso de teste, estado limpo a cada execução: OTP Gateway com br.
• Uma conta de staging que precisa fazer login de novo no mês que vem: um Número Dedicado dos EUA ou do Canadá, se o serviço o aceitar.
• Na dúvida: leia números temporários vs. dedicados antes de comprar qualquer coisa.

Quais apps conseguem enviar códigos para um número brasileiro agora?

A rota do Brasil cobre atualmente mais de 2.900 serviços, e os populares no panorama atual incluem WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, TikTok, Uber, Discord, Microsoft & Outlook, LinkedIn, Netflix, Airbnb, Shopee e AliExpress.

Trate essa lista como um retrato do momento e não como um contrato. A disponibilidade muda ao longo do dia conforme nossos parceiros de operadora adicionam e alternam rotas, então um pipeline deve perguntar à API em vez de confiar numa lista fixa. O diretório de países mostra os mesmos dados em tempo real para quem prefere um navegador.

Como é a sequência da API OTP do Brasil na prática?

Toda chamada vai para https://otproute.com/api/v1 com uma chave Bearer de prefixo or_live_, gerada no console do desenvolvedor. O id de país do Brasil é br.

1. Resolva os ids de serviço uma vez com GET /api/v1/services e mantenha-os na configuração.
2. Antes de pedir, chame GET /api/v1/prices?country=br&service=whatsapp (ou o id do seu serviço). A resposta traz o preço e a disponibilidade atuais daquele par.
3. Crie a ativação com POST /api/v1/activations e o corpo {"service": "whatsapp", "country": "br"}. Guarde o id da ativação junto da sua execução de teste.
4. Digite o número +55 no fluxo que você está testando.
5. Escute o evento activation.sms_received num webhook; como alternativa, consulte GET /api/v1/activations/{id} a cada poucos segundos.
6. Se o teste for abortado, libere o número com POST /api/v1/activations/{id}/cancel para que o saldo volte imediatamente.

As entregas de webhook são assinadas em X-OTPRoute-Signature como t=<unix>,v1=<hex>: um HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint. Verifique-o, descarte timestamps antigos e torne o handler idempotente pelo id da ativação. A referência completa está na documentação da API.

Alguém da equipe de growth consegue fazer isso sem código?

Sim. O painel executa o mesmo roteamento de OTP sem nenhum script:

1. Crie uma conta com seu e-mail e um código de 6 dígitos por e-mail, ou com o login do Google.
2. Adicione fundos à carteira em USD.
3. Escolha o Brasil e o serviço, confira o preço exibido e faça o pedido.
4. Cole o número +55 no app e veja o código aparecer no cartão da ativação.

Pessoas de marketing, suporte e revisão de localização costumam usar esse caminho para confirmar que uma tela de onboarding em português se comporta bem antes de um lançamento, enquanto os engenheiros mantêm a API para as execuções automatizadas.

Como armazenar e normalizar números +55?

Os números brasileiros têm um código de área de dois dígitos (DDD) seguido do número do assinante, e os celulares têm nove dígitos começando com 9. Dentro do Brasil, as pessoas discam um 0 inicial mais um código de seleção de operadora para ligações de longa distância, e é por isso que a entrada do usuário muitas vezes contém dígitos extras que não pertencem ao armazenamento.

Guarde tudo em E.164: +55, o código de área e depois o número do assinante, sem espaços, sem 0 inicial e sem código de operadora. Normalize na entrada, compare pelo valor normalizado e formate apenas para exibição. Os códigos de remetentes brasileiros costumam chegar em português, às vezes em inglês, então interprete os dígitos em vez de comparar com uma frase fixa.

As equipes testam este mercado para um lançamento no Brasil, para QA de localização em português e para fluxos de onboarding que convivem com as obrigações da lei brasileira de proteção de dados, a LGPD. Nossa página de onboarding fintech trata do lado da verificação desse trabalho.

E se um código brasileiro nunca aparecer?

Primeiro, deixe a janela de 20 minutos correr; alguns remetentes são mais lentos que outros, e a entrega depende do serviço e da rota. Se ela expirar, a cobrança é revertida automaticamente e você pode tentar de novo um pouco mais tarde ou em outra rota listada pela API.

• Confirme se o serviço aceita números virtuais. Alguns não aceitam, e é exatamente por isso que a regra de reembolso existe.
• Não refaça o pedido em loop. Espere entre as tentativas e registre o id de cada ativação.
• Verifique se o seu app enviou o número completo na forma internacional, e não num formato local com os dígitos de tronco.

O guia de como reduzir entregas de OTP que falham lista mais diagnósticos.

Como carteira, faturas e sandbox se encaixam?

A OTP Route cobra de uma única carteira pré-paga em USD: pague conforme o uso, sem mensalidade e sem plano para escolher. Recarregue com cartão ou com USDT ou USDC, e cada recarga chega com uma fatura em PDF por e-mail. As tarifas completas estão na página de preços e na API.

Para o trabalho de integração, peça ao suporte para colocar uma conta de desenvolvimento em sandbox. Ele devolve números e códigos simulados, para que você exercite o caminho da ativação e do webhook de ponta a ponta sem tocar nos fundos da carteira. Use-o apenas para seus próprios produtos, siga os termos de cada serviço e lembre que a Política de Uso Aceitável se aplica a todas as contas.

Perguntas frequentes

Posso testar o fluxo de cadastro brasileiro do meu app sem um chip local?

Sim. Peça um número +55 no OTP Gateway para o seu próprio app ou para um serviço compatível, digite-o no fluxo e leia o código no painel ou pela API.

Qual é o id de país do Brasil na API da OTP Route?

É br. Informe-o como o campo country ao criar uma ativação ou como o parâmetro de consulta country no endpoint de preços.

Sou cobrado se o WhatsApp nunca enviar o código para o meu número +55?

Não. Se nenhum SMS chegar ao número em 20 minutos, ou se você cancelar antes, o valor total volta para a sua carteira automaticamente.

Posso comprar um número brasileiro e mantê-lo por meses?

Não como produto em autoatendimento. Os Números Dedicados de longo prazo são vendidos apenas para os Estados Unidos e o Canadá; para o Brasil você pode escrever para [email protected] e perguntar, sem promessa de disponibilidade.

Devo guardar o zero inicial de um número brasileiro?

Não. Remova o 0 de tronco e qualquer código de seleção de operadora, e salve o número em E.164, começando com +55 e o código de área de dois dígitos.

Em que idioma chegam as mensagens de verificação do Brasil?

A maioria chega em português, e alguns serviços globais enviam texto em inglês. Extraia o código numérico em vez de depender da redação.

Posso experimentar a API antes de colocar fundos na carteira?

Peça o modo sandbox numa conta de desenvolvimento. Ele simula números e códigos, para que a integração completa possa ser testada sem gastar saldo da carteira.

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.