Como levar códigos SMS etíopes (+251) ao seu pipeline de testes

Quais chamadas de API buscam um código de verificação etíope?

O roteamento de OTP para a Etiópia se resume a cinco chamadas HTTP simples contra https://otproute.com/api/v1. Autentique cada uma com uma chave Bearer que comece com or_live_, gerada no console do desenvolvedor; uma conta pode ter até 10 chaves, então CI, staging e um laptop local podem rodar com credenciais separadas.

1. GET /api/v1/countries lista todas as rotas, e a Etiópia aparece com o id et.
2. GET /api/v1/services retorna os ids dos serviços, enquanto GET /api/v1/prices?country=et&service=<id> informa o preço atual e a disponibilidade do par que você pretende testar.
3. POST /api/v1/activations com {"service": "telegram", "country": "et"} reserva um número +251 e devolve um id de ativação.
4. Digite esse número no campo de telefone do produto em teste e dispare o SMS dele.
5. Leia o código de um evento de webhook ou por polling em GET /api/v1/activations/{id}, e abandone uma execução de forma limpa com POST /api/v1/activations/{id}/cancel.

O estoque muda ao longo do dia, então chame o endpoint de preços em tempo de execução em vez de fixar qualquer valor. Um rápido GET /api/v1/balance antes de a suíte começar permite que um job pare cedo quando a carteira está baixa. Os formatos de requisição e resposta desta API de verificação por SMS estão na documentação para desenvolvedores.

Como configuro um webhook assinado para ativações +251?

O polling serve para um único teste, mas jobs paralelos são mais fáceis de entender quando os eventos são enviados até você. Registre até 5 endpoints de webhook por conta e assine activation.sms_received, activation.expired e activation.cancelled.

Toda requisição traz X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalcule o HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint, compare o resultado com v1 usando uma verificação em tempo constante e recuse a chamada quando o timestamp estiver antigo. Verifique sobre os bytes brutos antes de qualquer parser de JSON tocar neles.

Presuma que um evento pode ser entregue mais de uma vez: identifique o handler pelo id da ativação e descarte as repetições, para que um evento reenviado nunca preencha um campo de OTP duas vezes. Se você ficar no polling, um intervalo de alguns segundos cabe com folga no limite de 300 requisições por minuto. Nosso passo a passo sobre como proteger webhooks de OTP com HMAC inclui um handler de referência.

Quais serviços podem receber códigos SMS OTP da Etiópia agora?

A rota da Etiópia lista atualmente mais de 1,700 serviços. Entre os destaques do panorama em tempo real estão WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft e Outlook, LinkedIn, Uber, Signal, Viber, imo e Netflix.

Trate essa lista como um retrato do momento. A disponibilidade de um serviço específico pode mudar em poucas horas, e por isso a API a informa em tempo real em vez de numa tabela estática. Consulte os endpoints de países e de preços no início de cada execução e pesquise o catálogo completo no painel se precisar de algo menos comum.

O que as equipes de QA precisam saber sobre formatos +251 e o idioma do SMS?

Um número etíope em E.164 é +251 seguido de nove dígitos. No uso doméstico, as pessoas discam um 0 inicial antes desses nove dígitos, então os usuários muitas vezes digitam 09… no seu formulário. Remova esse zero de tronco, acrescente +251 na frente e guarde a string E.164 canônica, exibindo o estilo local apenas na interface. Cubra as duas entradas, além de espaços e hífens, porque a validação do campo de telefone é onde muitos bugs de cadastro se escondem.

O amárico é a língua de trabalho federal e é escrito no alfabeto etíope (ge'ez), enquanto o afaan oromo, o tigrínia e o somali são amplamente usados em suas regiões. A maioria dos serviços internacionais envia os códigos em inglês, mas um modelo localizado pode chegar em amárico. Extraia os dígitos com um padrão em vez de comparar as palavras ao redor, e garanta que seus logs armazenem UTF-8 corretamente.

As equipes costumam testar essa rota ao lançar um app para usuários etíopes, ao verificar uma localização em amárico ou ao atender clientes da diáspora que se cadastram com um número do país de origem. Se o seu produto mostra datas, o calendário próprio da Etiópia é um caso de localização à parte que vale incluir. A página de testes de QA mostra como outras equipes estruturam essas suítes.

Quem não é desenvolvedor consegue um número de verificação da Etiópia pelo painel?

Sim. Gerentes de produto e equipes de suporte podem executar o mesmo fluxo sem escrever código:

1. Crie uma conta com seu e-mail e um código de 6 dígitos, ou com o login do Google, e depois ative a autenticação em dois fatores TOTP.
2. Adicione fundos à carteira.
3. Escolha a Etiópia, selecione o serviço e veja o preço exibido antes de confirmar.
4. Cole o número +251 no app que você está verificando.
5. Mantenha a ativação aberta; o código é exibido ali assim que for recebido.

Muitas equipes usam esse caminho para verificações pontuais enquanto os engenheiros percorrem a mesma rota pela API.

O que acontece quando o código +251 não aparece?

Cada ativação fica aberta por 20 minutos. Você só paga se o código chegar; se a janela se encerrar sem SMS, ou se você cancelar, o valor integral volta automaticamente para a carteira.

Quando nada chega:

• Deixe a janela correr antes de considerar uma falha, já que o tempo depende do serviço e da rota.
• Tente mais tarde, ou troque para outra rota de serviço, se o seu caso de teste permitir.
• Confirme se o serviço aceita números virtuais; alguns os recusam, e o reembolso existe exatamente para essa situação.
• Não refaça o pedido em loop apertado. Espace as tentativas e registre cada id de ativação para que os padrões fiquem visíveis.

O artigo sobre como reduzir falhas na entrega de OTP lista outras verificações.

Existe uma linha etíope de longo prazo e como é feita a cobrança?

A OTP Route não tem número de longo prazo em autoatendimento na Etiópia. Os Dedicated Numbers, linhas que você mantém enquanto renovam, são um produto dos EUA e do Canadá a partir de $1.95/month. Se a sua equipe precisar de uma linha +251 duradoura, escreva para [email protected] para perguntar; a disponibilidade depende das regras locais e não é garantida.

As ativações etíopes saem de uma única carteira pré-paga em USD, sem mensalidade e sem plano para escolher. Recarregue com cartão ou com stablecoins USDT/USDC; uma fatura em PDF chega à sua caixa de entrada após cada recarga. Antes de gastar fundos reais em uma integração nova, peça o modo sandbox para uma conta de desenvolvimento: ele retorna números e códigos simulados para que todo o fluxo seja exercitado de ponta a ponta.

Os números de teste etíopes da OTP Route servem para verificar produtos e contas que a sua organização realmente possui; os termos de cada serviço continuam valendo, assim como a nossa Política de Uso Aceitável.

Perguntas frequentes

Posso testar o fluxo de cadastro etíope do meu app sem um chip local?

Sim. Peça um número +251 para o seu serviço no OTP Gateway, digite-o no seu app e leia o código no painel ou pela API. Você só é cobrado se o código chegar.

Qual é o id da Etiópia na API da OTP Route?

É et. Envie et como o campo country ao criar uma ativação etíope e ao consultar preços.

Quanto custa um número +251 para testes?

Os códigos começam a partir de $0.20 por código. O valor exato de cada serviço é retornado por GET /api/v1/prices e exibido no painel antes do pedido.

Devo armazenar os números de telefone etíopes com o zero inicial?

Não. Mantenha a forma E.164, +251 mais nove dígitos, e descarte o 0 doméstico sempre que o usuário o digitar. Aplique a formatação local apenas na tela.

Os textos de verificação etíopes chegarão em amárico?

Em geral chegam em inglês, embora um serviço possa usar um modelo em amárico na escrita etíope. Extraia os dígitos em vez da redação para que as duas versões funcionem.

Posso manter um número etíope para logins futuros?

Não em autoatendimento, porque um número de uso único cobre um único código. Para uma conta que precisa entrar de novo, um Dedicated Number nos EUA ou no Canadá é a opção adequada, ou você pode escrever ao suporte para perguntar sobre a Etiópia.

Dá para experimentar a API OTP da Etiópia sem gastar fundos da carteira?

Sim. Peça o modo sandbox em uma conta de desenvolvimento e ele retornará números e códigos simulados, para que você teste a integração de ponta a ponta.

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.