Testando fluxos de cadastro +93 quando ninguém na equipe tem um chip afegão

Nossos usuários se cadastram com números +93, mas o QA não consegue reproduzir. E agora?

Essa é uma lacuna comum em apps de remessas, ferramentas de logística humanitária, produtos de mensagens e marketplaces com uma grande diáspora afegã. Os chamados de suporte falam de códigos que nunca chegam ou de números que o formulário rejeita, mas a equipe de testes está em Berlim, Dubai ou Toronto e não tem como colocar um chip afegão em um aparelho.

Um número de verificação do Afeganistão do OTP Gateway resolve isso. Você pede uma linha +93 temporária para um único serviço, digita-a no fluxo que está testando e o código aparece onde os seus engenheiros já trabalham. Nada precisa ser enviado, usado em roaming ou registrado localmente, e o número é descartado depois que o código é usado.

A mesma abordagem serve a gerentes de produto que querem acompanhar um funil de onboarding localizado de ponta a ponta antes de um lançamento, ou a uma equipe de operações que precisa de um número +93 para testar uma integração com um parceiro.

Como trago OTPs afegãos para um ambiente de testes pela API?

A API de OTP do Afeganistão usa as mesmas chamadas de qualquer outra rota; só muda o id do país. Para o Afeganistão, esse id é af.

1. Crie uma chave Bearer com o prefixo or_live_ no console do desenvolvedor. Uma conta pode ter até 10 chaves e 5 endpoints de webhook, com um limite de 300 requisições por minuto.
2. Chame GET /api/v1/services para achar o id do serviço e depois GET /api/v1/prices?country=af&service=<id> para ver quanto essa rota custa agora.
3. Envie POST /api/v1/activations com um corpo JSON que indique o serviço e af. A resposta traz o id da ativação e o número +93.
4. Faça polling em GET /api/v1/activations/{id} ou espere o evento activation.sms_received no seu webhook. Confira o cabeçalho X-OTPRoute-Signature, um HMAC-SHA256 do timestamp mais o corpo bruto, e descarte requisições com timestamps antigos.
5. Se o teste for abandonado, POST /api/v1/activations/{id}/cancel libera o número e devolve a reserva.

A referência da API cobre todos os endpoints, e o guia sobre captura de OTP por webhook mostra como usar o id da ativação como chave dos eventos para que as repetições sejam idempotentes.

Quais apps podem enviar códigos para um número do Afeganistão hoje?

O snapshot ao vivo de af lista mais de 1.700 serviços. Entre os mais pedidos pelas equipes estão WhatsApp, Telegram, Google (Gmail e YouTube), Facebook, Instagram, imo, Viber, Signal, TikTok, Microsoft & Outlook, LinkedIn, Discord e ChatGPT (OpenAI).

Os apps de mensagens dominam essa lista por um motivo: apps de voz e de chat são a forma como muitas famílias afegãs no exterior mantêm contato, então os produtos que se integram a eles recebem muito tráfego +93. A disponibilidade muda ao longo do dia conforme as nossas operadoras parceiras rotacionam o estoque, e é por isso que a API informa o que pode ser pedido no momento da consulta, em vez de um catálogo fixo.

E quem nunca mexe com a API?

Agentes de suporte e donos de produto podem fazer tudo no navegador. Cadastre-se com um e-mail e um código de 6 dígitos (ou com o login do Google), adicione saldo, abra o OTP Gateway, escolha o Afeganistão e o serviço e confirme o preço exibido. O número +93 aparece na hora; cole-o no app em teste e deixe a aba aberta. Quando o SMS chegar, o código é mostrado ao lado do pedido.

Ativar a autenticação em dois fatores (TOTP) no painel é uma medida sensata para qualquer conta compartilhada por vários colegas.

Como devemos armazenar e normalizar números de telefone afegãos?

O Afeganistão usa o código de país +93 com o prefixo de tronco 0. Localmente, um número de celular é escrito com esse zero à frente, por exemplo 07X XXX XXXX, enquanto a forma internacional o omite: +93 7X XXX XXXX. Salve a versão E.164 (+937...) no seu banco de dados e remova um 0 inicial sempre que o usuário digitar o formato local ao lado de um seletor +93; caso contrário, o seu validador contará um dígito a mais.

Dari e pachto são os idiomas oficiais, mas os grandes serviços globais costumam enviar o texto do código em inglês ou no idioma configurado na conta ou no aparelho. Teste um locale da direita para a esquerda e um em inglês se o seu próprio app exibir o conteúdo do SMS em algum lugar, como em uma dica de preenchimento automático.

O código não apareceu. O que a equipe deve tentar?

As rotas para o Afeganistão podem ser irregulares, então conte com alguma falha ocasional:

• Deixe a janela de 20 minutos terminar. Um SMS lento ainda vale se chegar antes de expirar.
• Lembre-se da regra de reembolso. Você só paga se o código chegar; uma ativação expirada ou cancelada devolve o valor total automaticamente.
• Tente de novo mais tarde ou por outra rota. Um novo pedido pouco depois, ou o mesmo serviço em um mercado vizinho como o Paquistão, costuma funcionar.
• Verifique se o serviço aceita números virtuais. Alguns os recusam por política, e nenhuma rota muda isso.
• Não martele o endpoint. Refazer pedidos em um loop apertado gasta o limite de requisições sem melhorar a entrega; espere entre as tentativas.

O artigo sobre como reduzir falhas na entrega de OTP aprofunda o desenho de novas tentativas.

Podemos manter uma linha +93 para logins no mês que vem, e como é a cobrança?

Não existe linha afegã de longo prazo em autoatendimento. Os Números Dedicados são um produto à parte, vendido apenas para os Estados Unidos e o Canadá, a partir de $1.95/mês, com SMS de entrada e de saída e chamadas pelo navegador. Se a sua equipe realmente precisa de uma linha +93 duradoura, escreva para [email protected]; se é possível providenciar depende das regras locais, e a resposta pode ser não.

A cobrança do OTP Gateway funciona com uma única carteira pré-paga em USD, sem mensalidade e sem plano a escolher. Recarregue por cartão ou com USDT/USDC, e cada recarga gera uma fatura em PDF por e-mail. Para trabalhos de integração, peça ao suporte que mude uma conta de desenvolvimento para o modo sandbox, que retorna números e códigos simulados sem tocar no seu saldo. Os preços completos estão na página de preços.

Perguntas frequentes

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

Sim. Peça um número +93 para o serviço desejado no OTP Gateway, informe-o no seu app e leia o código no painel ou pela API.

Qual é o id do Afeganistão na API da OTP Route?

É af. Passe-o como valor de country ao criar uma ativação ou consultar preços.

Quanto custa receber um OTP por SMS do Afeganistão?

Os códigos começam em $0.20 por código. O valor exato depende do serviço e é retornado por GET /api/v1/prices antes de você pedir.

Sou cobrado se o SMS de verificação nunca chegar?

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

Devo armazenar números afegãos com o zero inicial?

Armazene-os em E.164, começando com +93 e sem o 0 de tronco; aceite o formato local na entrada e normalize antes de salvar.

Todo serviço aceita um número +93 da OTP Route?

Não necessariamente, porque alguns serviços rejeitam números virtuais. Siga os termos de cada serviço e a nossa Política de Uso Aceitável, que limita o uso às suas próprias contas e produtos legítimos.

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.