Testando fluxos de cadastro +994 quando ninguém na equipe tem um chip azerbaijano

Nosso produto vai entrar no ar em Baku e a etapa de verificação trava todos os testes. Quais são as opções?

Esse é um ponto comum para equipes que adicionam o Azerbaijão a um app existente. A tela de telefone aceita +994, o texto localizado está pronto e então o QA para, porque o único chip azerbaijano pertence a um prestador de serviço em outro fuso horário. Pegar emprestado o celular pessoal de um colega funciona uma vez, mas liga uma conta de teste a um número privado e não consegue rodar dentro de um pipeline.

O OTP Gateway elimina esse gargalo. Você pede um número +994 para um único código, usa-o na sua própria tela de cadastro ou login e coleta o SMS sem que ninguém tenha um aparelho. Cada número atende a uma verificação, o que mantém os dados de teste limpos e os celulares pessoais fora das contas empresariais. As equipes que fazem isso a cada sprint costumam combiná-lo com o fluxo de testes de QA.

Quais apps podem entregar códigos a uma rota azerbaijana agora?

O snapshot ao vivo do Azerbaijão lista mais de 1.600 serviços. Entre os populares estão WhatsApp, Telegram, Viber, Uber, Google (Gmail e YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Signal e Amazon.

A disponibilidade não é fixa. As rotas abrem e fecham ao longo do dia conforme as nossas operadoras parceiras rotacionam a capacidade, então um serviço visível de manhã pode sumir à tarde. Em vez de fixar uma lista no código, leia-a da API antes de cada execução e pule com elegância quando uma combinação não for oferecida.

Como ligamos a API de OTP do Azerbaijão a uma suíte automatizada?

Todas as chamadas vão para https://otproute.com/api/v1 com uma chave Bearer do console do desenvolvedor; as chaves começam com or_live_, e uma conta pode ter até 10 delas. O id do país do Azerbaijão é az.

1. Busque o catálogo com GET /api/v1/services e GET /api/v1/countries e confirme a combinação com GET /api/v1/prices?country=az&service=<id>.
2. Crie o pedido com POST /api/v1/activations e um corpo como {"service": "viber", "country": "az"}. Guarde o id da ativação da resposta.
3. Digite o número +994 retornado no build em teste.
4. Espere activation.sms_received no seu webhook ou faça polling em GET /api/v1/activations/{id} se o job rodar onde o tráfego de entrada é bloqueado.
5. Libere o que for abandonado com POST /api/v1/activations/{id}/cancel.

As chamadas de webhook trazem X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalcule o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, compare em tempo constante e descarte timestamps antigos; o guia de segurança de webhooks explica o passo a passo. O limite de 300 requisições por minuto deixa bastante folga para jobs em paralelo.

Alguém de fora da engenharia pode buscar um código +994 manualmente?

Sim. Gerentes de produto, tradutores e líderes de suporte muitas vezes precisam de um único código para conferir uma tela, e o painel cobre isso sem nenhuma chave de API:

• Entre na conta e abra o OTP Gateway.
• Escolha o Azerbaijão, depois o serviço que está testando, e leia o preço ao vivo.
• Peça o número e cole-o no seu app.
• Mantenha a página da ativação aberta; o SMS aparece ali assim que for entregue.

Se o teste for cancelado, cancele a ativação e o valor volta direto para a carteira.

Como o nosso backend deve armazenar e normalizar números +994?

Persista todo número no formato E.164, por exemplo +994 seguido do número nacional de nove dígitos. Dentro do país, as pessoas discam um 0 de tronco antes do código da operadora, então um formulário de cadastro receberá os dois estilos. Remova espaços, hífens e esse 0 doméstico e depois acrescente o código do país antes de salvar. Uma biblioteca de parsing mantida é mais segura que uma regex escrita à mão.

O azerbaijano é o idioma oficial e usa um alfabeto latino com letras como ə, ğ, ı, ş e ç; o russo também é amplamente entendido. Dependendo do serviço e do locale do aparelho, um código pode chegar em azerbaijano, russo ou inglês. Isso torna as rotas +994 úteis para conferir se os seus próprios modelos de SMS exibem corretamente caracteres especiais e se um parser de códigos não depende de palavras em inglês.

O código nunca apareceu. O que tentamos antes de escalar?

Comece deixando a ativação correr os seus 20 minutos completos; alguns remetentes enfileiram as mensagens. Se nada chegar, o pedido expira, activation.expired dispara e o valor total é reembolsado automaticamente, então você só paga se o código chegar.

Depois percorra as causas habituais:

• Alguns serviços recusam números virtuais em certos fluxos. Confirme que o serviço os aceita antes de culpar a rota.
• Tente de novo mais tarde ou troque para outra rota de serviço que exercite a mesma tela.
• Evite refazer pedidos em um loop apertado; espere entre as tentativas para que uma rajada de falhas não esgote a fila.

A lista de verificação para entregas que falham cobre outros diagnósticos.

Existe uma linha azerbaijana de longo prazo, e como o uso é cobrado?

Não existe número dedicado em autoatendimento para o Azerbaijão. Os Números Dedicados são um produto dos Estados Unidos e do Canadá a partir de $1.95/mês; se você precisa de uma linha +994 permanente, escreva para [email protected] e a equipe verificará o que as regras locais permitem, sem promessa de disponibilidade. Para contas que precisam de logins repetidos, uma linha dos EUA ou do Canadá é a alternativa.

Nos testes em Baku, o gasto sai de uma única carteira pré-paga em USD; não há nível de assinatura nem cobrança mensal. Recarregue por cartão ou com USDT ou USDC, e cada recarga gera uma fatura em PDF por e-mail; os valores atuais estão na página de preços. Uma conta de desenvolvimento pode ser mudada para sandbox sob solicitação, retornando números e códigos simulados para que a integração possa ser testada de ponta a ponta antes de gastar fundos reais. A Política de Uso Aceitável da OTP Route e os termos de cada serviço se aplicam a todo pedido.

Perguntas frequentes

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

Sim. Peça um número +994 no OTP Gateway, informe-o no seu app e leia o código no painel ou pela API, sem nenhum chip físico envolvido.

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

Use az no campo country de POST /api/v1/activations e nas consultas de preço.

Quanto custa um número +994 para testes?

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ê se comprometer.

Sou cobrado se o SMS azerbaijano nunca chegar?

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

Devemos salvar os números azerbaijanos com o zero inicial?

Não. Descarte o 0 de tronco doméstico e armazene o número no formato E.164 começando com +994.

Posso manter o mesmo número de verificação do Azerbaijão para logins futuros?

Não pelo OTP Gateway, que emite um número por código. As linhas de longo prazo em autoatendimento existem apenas nos EUA e no Canadá; pergunte ao suporte sobre o Azerbaijão.

Em que idioma chegam as mensagens de verificação do Azerbaijão?

Depende do remetente e das configurações do aparelho; azerbaijano, russo e inglês são todos comuns.

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.