Integrando um fluxo de verificação por SMS do Egito (+20) à API da OTP Route

De quais requisições uma integração com a API OTP do Egito realmente precisa?

Sete endpoints cobrem tudo, todos sob https://otproute.com/api/v1 e todos autenticados com uma chave Bearer de prefixo or_live_. Gere uma chave por ambiente no console do desenvolvedor; uma conta pode ter até 10.

1. Carregue o catálogo com GET /api/v1/services e GET /api/v1/countries. O id do país do Egito é eg, e ele raramente muda, então guardá-lo em cache é aceitável.
2. Antes de cada pedido, consulte GET /api/v1/prices?country=eg&service=<id> para ver o preço e a disponibilidade atuais. A disponibilidade se move ao longo do dia, então trate essa resposta como dado novo, e não como configuração.
3. Crie a ativação com POST /api/v1/activations e um corpo como {"service": "whatsapp", "country": "eg"}. Você recebe um id de ativação e o número +20 a digitar na tela em teste.
4. Pegue o código por um webhook ou chamando GET /api/v1/activations/{id}.
5. Se um teste for abortado, libere o pedido com POST /api/v1/activations/{id}/cancel para que os fundos voltem na hora.

Um rápido GET /api/v1/balance no início de cada suíte permite que um job de CI pare cedo em vez de falhar no meio. O limite é de 300 requisições por minuto por conta, o que deixa espaço para consultar várias ativações em paralelo. Exemplos completos de requisição estão na documentação para desenvolvedores.

Como consumo códigos +20 de um webhook assinado em vez de usar polling?

O polling funciona para um único teste local; o webhook é a melhor opção quando um pipeline executa muitas ativações egípcias ao mesmo tempo. Adicione um endpoint no console do desenvolvedor (cinco por conta) e inscreva-se em activation.sms_received, além de activation.expired e activation.cancelled, para que o seu job saiba quando parar de esperar.

Toda requisição traz X-OTPRoute-Signature: t=<unix>,v1=<hex>. Reconstrua a string <t>.<raw body>, calcule o HMAC-SHA256 com o segredo do endpoint e compare-o com v1 por meio de uma verificação em tempo constante. Rejeite tudo cujo timestamp seja antigo e calcule o hash dos bytes exatamente como recebidos, e não de um objeto interpretado e recodificado.

Trate o id da ativação como chave de idempotência: guarde o evento uma vez, ignore as repetições e devolva rapidamente um 2xx. O guia de captura de OTP por webhook percorre uma versão desse handler apoiada em fila.

Quais serviços podem entregar códigos a um número de verificação do Egito?

O snapshot ao vivo do Egito lista, no total, mais de 1.600 serviços. Entre os populares que as equipes testam em números +20 estão WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, Uber, Snapchat, Viber, imo, ChatGPT (OpenAI), Amazon e LinkedIn.

Essa lista é uma visão de um instante, não uma promessa. Um serviço que tem números esta manhã pode estar escasso à tarde, e é exatamente por isso que o endpoint de preços informa a disponibilidade junto com o custo. Alguns serviços também recusam números virtuais por completo; quando isso acontece, a regra de reembolso descrita abaixo protege você.

Como um app deve armazenar e validar celulares egípcios?

O Egito usa o código de país +20 e um prefixo de tronco doméstico 0. Localmente, um celular é escrito com onze dígitos começando em 01, enquanto na forma internacional o zero desaparece e dez dígitos seguem o +20. Alguns hábitos evitam a maioria dos bugs:

• Salve apenas em E.164, como +201XXXXXXXXX, e formate para exibição só na hora de renderizar.
• Remova o zero de tronco quando um usuário digitar 01… com o país já definido como Egito; caso contrário, você acaba com um valor inválido +2001….
• Normalize os dígitos. Quem usa teclado árabe pode digitar numerais arábico-índicos, então converta-os em dígitos ASCII antes da validação e antes de comparar um OTP digitado.

O árabe é o idioma oficial, então muitos serviços enviam os códigos aos usuários egípcios em árabe, enquanto outros usam o inglês por padrão. Se o seu parser extrai o código com uma regex, teste-a tanto com corpos de mensagem da direita para a esquerda quanto com os em inglês.

A equipe de operações pode pedir um número egípcio sem escrever código?

Pode. Nem toda verificação precisa de um script, e colegas de suporte ou de growth podem usar o mesmo OTP Gateway pelo navegador:

1. Crie sua conta com o seu e-mail e o código de 6 dígitos, ou com o Google.
2. Recarregue a carteira e abra o OTP Gateway.
3. Escolha o Egito e o serviço; o preço aparece antes de você confirmar.
4. Copie o número +20 para o app e aguarde o código aparecer na tela.

A ativação é idêntica a um pedido pela API, então uma verificação manual e uma automatizada se comportam do mesmo modo.

E se o código +20 não aparecer?

Cada ativação fica aberta por 20 minutos. Se nenhum SMS chegar nesse tempo, ou se você cancelar antes, o valor integral volta para a sua carteira automaticamente, então um número silencioso nunca custa nada.

Quando os códigos continuam falhando:

• Deixe a janela correr até o fim antes de decidir que falhou; o tempo de entrega depende do serviço e da rota.
• Confirme se o serviço aceita números virtuais. Alguns os recusam, e nenhuma escolha de roteamento muda isso.
• Tente de novo um pouco mais tarde, ou por uma rota vizinha, se o seu teste não depender de um número egípcio.
• Evite refazer o pedido em um laço rápido. Deixe um intervalo crescente entre os pedidos e guarde cada id de ativação nos seus logs.

Nossas notas sobre como reduzir falhas na entrega de OTP aprofundam a política de novas tentativas.

Por que as equipes de produto testam com números egípcios?

O Egito é um dos maiores mercados de língua árabe, então é uma primeira parada natural para equipes que localizam um produto para o árabe. Um número +20 real exercita as partes que os emuladores pulam: o seletor de país, o tratamento do zero de tronco, os templates de SMS em árabe e o layout da direita para a esquerda na tela de digitação do código.

As equipes de operações regionais também usam o roteamento de OTP para confirmar que um fluxo de cadastro continua funcionando para clientes egípcios depois de um release, e as empresas que atendem egípcios que vivem no exterior verificam que um número +20 também é aceito fora do país.

Existe uma linha egípcia de longo prazo e como funciona a cobrança?

Não há número de longo prazo com contratação self-service para o Egito. As linhas dedicadas são um produto apenas dos Estados Unidos e do Canadá, a partir de $1.95/month; se você precisa de uma linha egípcia contínua, escreva para [email protected] e a equipe poderá dizer se isso é possível pelas regras locais, sem promessa de que seja.

A cobrança é uma carteira pré-paga em USD, sem mensalidade e sem plano para escolher. Os fundos entram por cartão ou como USDT/USDC, e cada recarga é seguida de uma fatura em PDF enviada por e-mail. Enquanto monta a integração, você pode pedir o modo sandbox em uma conta de desenvolvimento, que devolve números e códigos simulados sem tocar nos fundos da carteira. As tarifas atuais estão na página de preços.

Perguntas frequentes

Posso verificar o OTP de cadastro egípcio do meu app sem um chip egípcio?

Sim. Peça um número +20 no OTP Gateway, digite-o no seu formulário de cadastro e leia o código no painel ou pela API, tudo sem um chip local.

Qual id de país a API da OTP Route usa para o Egito?

O Egito é eg. Passe-o ao endpoint de preços e no corpo de POST /api/v1/activations.

Pago por um número +20 se o SMS nunca chegar?

Não. Se nenhum código chegar em 20 minutos, ou se você cancelar a ativação, o valor integral é devolvido à sua carteira automaticamente.

Devo manter o zero inicial ao salvar um celular egípcio?

Não. O 0 é um prefixo de tronco doméstico; descarte-o e armazene o número em E.164, começando com +20.

Posso fazer login de novo no mês que vem com o mesmo número egípcio de teste?

Não de forma confiável. Cada número do OTP Gateway atende a um código de verificação, e as linhas dedicadas self-service existem apenas para os EUA e o Canadá, então planeje as contas que precisam de logins repetidos em torno disso.

Posso usar números egípcios para abrir muitas contas em uma plataforma?

Não. A OTP Route serve para testar e operar os seus próprios produtos e contas legítimos; siga os termos de cada serviço e a Política de Uso Aceitável.

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.