Testando a verificação de telefone em Burundi sem um chip local

Por que é tão difícil testar um cadastro +257 do exterior?

Imagine uma equipe de produto incluindo Burundi em um lançamento na África Oriental. A tela de cadastro pede um número de telefone, o backend envia um código único e ninguém na equipe tem um chip burundês. Chips de roaming comprados em viagem expiram, e pedir a um colega em Bujumbura que leia os códigos em voz alta expõe um número pessoal e não cabe numa suíte de testes noturna.

O roteamento de OTP elimina esse gargalo. Em vez de um aparelho físico, você pede um número de verificação de Burundi para um serviço específico, o código é capturado pela OTP Route e o seu ambiente de testes o lê como qualquer outro evento. A mesma abordagem serve para equipes de operações que gerenciam perfis empresariais em rotas burundesas e precisam manter os próprios celulares fora disso.

Quais serviços podem verificar com um número de Burundi hoje?

O retrato atual de Burundi lista apps conhecidos de mensagens, busca e comércio, entre eles WhatsApp, Viber, imo, Telegram, Signal, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, ChatGPT (OpenAI), Uber e Amazon. No total, a rota cobre mais de 1.000 serviços.

O estoque muda ao longo do dia, então trate essa lista como ponto de partida, não como promessa. Seu código deve consultar GET /api/v1/services e GET /api/v1/countries para ver o quadro atual, e o diretório completo pode ser explorado em países.

Como a API de OTP de Burundi se encaixa em uma execução de teste?

Crie uma chave no console de desenvolvedor; as chaves live começam com or_live_ e vão em um cabeçalho Bearer para https://otproute.com/api/v1. Uma verificação automatizada típica fica assim:

1. Chame GET /api/v1/prices?country=bi&service=whatsapp para ler o preço atual desse par.
2. Envie POST /api/v1/activations com o corpo {"service": "whatsapp", "country": "bi"}. A resposta traz um id de ativação e o número +257 para digitar no app em teste.
3. Aguarde o webhook activation.sms_received ou consulte GET /api/v1/activations/{id} em intervalos razoáveis.
4. Faça a asserção sobre o código e encerre o teste.

As requisições de webhook incluem X-OTPRoute-Signature: t=<unix>,v1=<hex>, um HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint. Recalcule, compare em tempo constante e descarte timestamps antigos; este passo a passo cobre os detalhes. Uma conta pode ter até 10 chaves e 5 endpoints de webhook, com teto de 300 requisições por minuto. Referência completa: documentação.

O que o meu validador deve esperar de um número burundês?

Burundi usa um plano de numeração fechado: os números de assinante têm oito dígitos depois do código do país e não há prefixo de tronco nacional para remover. Em E.164 isso significa +257 seguido de oito dígitos, armazenado sem espaços. Os formulários costumam exibi-lo agrupado de dois em dois, então normalize a entrada removendo espaços, hifens e um 00 inicial antes de salvar.

Um bug comum é um validador escrito para números nacionais de nove ou dez dígitos que rejeita em silêncio entradas +257 válidas. Inclua um caso de teste com esse comprimento.

Kirundi, francês e inglês são idiomas oficiais, e o suaíli é muito usado no comércio. Os textos de verificação de apps globais costumam chegar em inglês ou francês, conforme a lógica de idioma do remetente, então leia os dígitos em vez de comparar com o texto.

O código não chegou: e agora?

Toda ativação fica aberta por 20 minutos. Se nenhum SMS chegar ao número nesse prazo, ou se você cancelar com POST /api/v1/activations/{id}/cancel, o valor integral volta automaticamente para a sua carteira.

• Deixe a janela correr antes de concluir que falhou; alguns remetentes enfileiram mensagens.
• Confirme que o serviço de destino aceita números virtuais, já que alguns os rejeitam por política.
• Tente de novo mais tarde, ou teste o mesmo fluxo por outra rota de serviço.
• Evite refazer o pedido em loop apertado; espace as tentativas.

Prefere o painel? Entre na conta, escolha Burundi e o serviço, copie o número para o app e veja o código aparecer na tela. Há mais táticas em como reduzir falhas na entrega de OTP.

Podemos manter uma linha burundesa para contas em que fazemos login com frequência?

Não como produto de autoatendimento. A OTP Route não vende números de longo prazo de Burundi; o OTP Gateway emite um número por verificação. Se a sua equipe realmente precisa de uma linha persistente lá, escreva para [email protected] e descreva o caso de uso; a disponibilidade depende das regras locais e não é garantida.

Os Dedicated Virtual Numbers existem apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês, com SMS de entrada, encaminhamento por webhook e chamadas pelo navegador. Veja números virtuais se uma linha dos EUA ou do Canadá servir para as suas contas de staging.

Como é cobrado o uso em Burundi?

Há uma única carteira pré-paga em USD, sem mensalidade e sem plano para escolher. A recarga funciona por cartão ou por stablecoins USDT/USDC; o financeiro recebe por e-mail uma fatura em PDF a cada recarga. Antes de ligar pagamentos ao CI, peça que uma conta de desenvolvimento seja movida para o sandbox, que devolve números e códigos simulados sem tocar nos fundos da carteira.

Use cada número apenas para o seu próprio produto ou para contas empresariais legítimas, respeite os termos de cada serviço e lembre-se de que vale a Política de Uso Aceitável da OTP Route. Os valores atuais estão em preços.

Perguntas frequentes

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

Sim. Peça um número +257 no OTP Gateway para o seu serviço, digite-o no app e leia o código no painel, na API ou por webhook.

Qual id de país a API usa para Burundi?

Passe bi como valor de país, por exemplo em POST /api/v1/activations, junto com um id de serviço como telegram.

Sou cobrado se o código +257 nunca chegar?

Não. Se nada chegar dentro da janela de 20 minutos, ou se você cancelar, o valor integral volta automaticamente para a sua carteira.

Os números de Burundi têm um zero inicial a remover?

Não. Burundi não tem prefixo de tronco, então a forma E.164 é simplesmente +257 mais oito dígitos.

Em que idioma estará escrito o SMS de verificação de Burundi?

Depende do serviço de envio, mas inglês ou francês é o mais comum. Extraia o código numérico em vez de depender do texto da mensagem.

Posso reutilizar o mesmo número de Burundi no mês que vem?

Não. Os números do Gateway servem a uma única verificação. Para logins repetidos, há Dedicated Numbers apenas nos EUA e no Canadá.

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

Os preços de Burundi começam em $0.20 por código, com o valor definido por serviço. O valor exato é retornado por GET /api/v1/prices e mostrado antes do pedido.

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.