Recebendo códigos SMS de Botsuana com uma chamada de API

Por quais chamadas de API passa uma ativação de Botsuana?

Tudo fica sob https://otproute.com/api/v1 e é autenticado com uma chave Bearer que começa com or_live_. Você cria as chaves no console do desenvolvedor; uma conta pode ter até 10 delas, e o limite é de 300 requisições por minuto, o que é de sobra para uma suíte de testes que pede um punhado de números de Botsuana por execução.

Uma sequência típica é assim:

1. Chame GET /api/v1/countries uma vez e guarde em cache, para que o seu código saiba que bw é o identificador de Botsuana.
2. Pergunte a GET /api/v1/prices?country=bw&service=whatsapp o preço ao vivo e a disponibilidade do par de que você precisa. Os preços variam por serviço e país, então leia-os em vez de fixá-los no código.
3. Envie POST /api/v1/activations com o corpo {"service": "whatsapp", "country": "bw"}. A resposta traz o número +267 e um id de ativação.
4. Digite esse número no formulário de cadastro em teste e depois faça polling em GET /api/v1/activations/{id} ou aguarde um webhook.
5. Se o teste for abortado, chame POST /api/v1/activations/{id}/cancel para que os fundos voltem na hora para a carteira.

O guia de integração da API de OTP percorre as mesmas chamadas com o tratamento de erros em mente.

Como o meu receptor de webhook deve tratar eventos +267?

Os webhooks são a escolha mais limpa quando mais de um teste roda em paralelo. Registre um endpoint (cinco por conta) e escute activation.sms_received, activation.expired e activation.cancelled, cada um identificado pelo id de ativação que você recebeu ao fazer o pedido.

Toda entrega traz um cabeçalho X-OTPRoute-Signature no formato t=<unix>,v1=<hex>. Reconstrua o HMAC-SHA256 da string "<t>.<raw body>" com o segredo do endpoint, compare-o com v1 em tempo constante e descarte tudo cujo timestamp esteja antigo. Analise o JSON só depois que a verificação passar, porque reserializar o corpo altera os bytes.

Faça o handler ser idempotente: guarde o id da ativação quando o código for consumido e ignore a repetição do mesmo evento. Os detalhes estão em proteger webhooks de OTP com HMAC.

Para que serve um número de verificação de Botsuana?

O retrato ao vivo de Botsuana lista mais de 800 serviços. Entre os populares estão WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft & Outlook, Amazon, LinkedIn, Uber, Signal, Netflix e Airbnb.

A disponibilidade em uma determinada rota muda ao longo do dia conforme a capacidade das operadoras varia. É por isso que o endpoint de preços também informa o que pode ser pedido agora: trate a resposta dele como a fonte de verdade, e não esta lista.

O que os engenheiros devem saber sobre os números de telefone de Botsuana?

Botsuana usa o código de país +267 e não tem prefixo de tronco, então o número nacional é discado exatamente como é escrito. Os celulares têm oito dígitos e começam com 7. Em E.164, isso dá +267 seguido dos oito dígitos, sem nenhum zero para remover.

Alguns pontos práticos para quem armazena ou valida esses números:

• Normalize tudo para E.164 na entrada. Os usuários podem digitar 00267, espaços ou um sinal de mais na frente; reduza todos a uma única forma canônica antes de comparar ou deduplicar.
• Não reutilize a regra de prefixo de tronco de um mercado vizinho. Um validador copiado de um país que remove o zero inicial rejeitará entradas válidas de Botsuana.
• O inglês e o setswana são os principais idiomas. Os códigos de apps globais costumam chegar em inglês, mas o seu parser deve extrair os dígitos por padrão, em vez de depender de uma redação fixa.

As equipes testam aqui ao lançar um produto na África Austral, ao verificar o onboarding de clientes que ficam do outro lado da fronteira com a África do Sul ou ao tocar operações regionais que precisam de um número local +267 para testes.

Quem não programa consegue pedir um código de Botsuana pelo painel?

Sim. Cadastre-se com o seu e-mail e um código de seis dígitos (ou com o Google), recarregue a carteira, abra o OTP Gateway, escolha Botsuana e o serviço, confira o preço exibido e faça o pedido. Cole o número no app que você está testando; o código aparece no painel assim que o SMS chega à rota.

Cada ativação fica aberta por 20 minutos. Se nenhuma mensagem chegar nesse tempo, ou se você cancelar antes, o valor total volta automaticamente para a sua carteira.

E se o código de Botsuana nunca chegar?

A velocidade de entrega depende do serviço e da rota, então dê tempo à janela antes de agir. Se ela fechar vazia, percorra esta lista:

• Tente de novo um pouco mais tarde, ou escolha outra rota de serviço para o mesmo fluxo, se o seu produto permitir.
• Confirme que o app do outro lado aceita enviar um SMS para uma linha virtual; alguns apps recusam esses números, e é precisamente por isso que as ativações não usadas voltam para o seu saldo.
• Deixe a janela de 20 minutos terminar em vez de cancelar depois de um minuto.
• Evite refazer o pedido em loop apertado a partir do CI; acrescente um back-off entre as tentativas.

Mais padrões estão em como reduzir falhas na entrega de OTP. Seja o que for que você testar, siga os termos de cada serviço; a Política de Uso Aceitável da OTP Route se aplica a todos os pedidos.

Existe uma linha +267 de longo prazo e como funciona a cobrança?

Não como produto em autoatendimento. Os Números Dedicados são vendidos de forma instantânea apenas nos Estados Unidos e no Canadá, a partir de $1.95/month; para Botsuana você pode escrever para [email protected] e perguntar, e a disponibilidade depende das regras locais. Veja números virtuais para saber o que as linhas dos EUA e do Canadá incluem.

A cobrança é uma única carteira pré-paga em USD, sem mensalidade, recarregada por cartão ou com USDT/USDC, e cada recarga vem com uma fatura em PDF por e-mail. Para o trabalho de integração, uma conta de desenvolvimento pode ser mudada para sandbox mediante pedido, de modo que todo o fluxo rode com números e códigos simulados. Os valores atuais estão na página de preços.

Perguntas frequentes

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

É bw. Passe-o como country em POST /api/v1/activations e na query string de GET /api/v1/prices.

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

Sim. Peça um número +267 para o serviço do seu app pelo OTP Gateway e leia o código no painel ou no seu webhook, sem nenhum chip ou telefone envolvido.

Os números de Botsuana precisam de um zero inicial ao serem armazenados?

Não. Botsuana não tem prefixo de tronco, então armazene o número como +267 mais o celular de oito dígitos.

Sou cobrado se o código +267 não chegar?

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

Posso manter um número de Botsuana para logins futuros?

Não existe número de longo prazo em autoatendimento para Botsuana. As linhas de longo prazo são um produto dos EUA e do Canadá; escreva para [email protected] se precisar perguntar sobre outras opções.

Posso rodar testes de Botsuana no CI sem gastar o saldo da carteira?

Peça para a sua conta de desenvolvimento ser mudada para sandbox. Ela devolve números e códigos simulados, de modo que todo o caminho de API e webhook possa ser exercitado sem custo.

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.