Escolhendo a rota certa para códigos de verificação armênios (+374)

Qual produto da OTP Route serve a uma tarefa de verificação armênia?

Defina isso antes de escrever qualquer código, porque a resposta molda toda a integração. A OTP Route vende duas coisas, e só uma delas chega à Armênia.

• OTP Gateway: um número das nossas operadoras parceiras, reservado para um serviço e um código. Serve a testes de cadastro, execuções de regressão em uma tela de onboarding localizada e à verificação pontual de um perfil empresarial. É o que você usa para +374.
• Números Virtuais Dedicados: uma linha que você mantém enquanto ela é renovada, com SMS de entrada e de saída e chamadas pelo navegador. É vendida na hora apenas para os Estados Unidos e o Canadá, a partir de $1.95/mês.

Não existe número armênio de longo prazo em autoatendimento. Se o seu projeto realmente precisa de um, escreva para [email protected] e descreva o caso de uso; se algo pode ser providenciado depende das regras locais, então trate isso como uma pergunta e não como um plano. Para contas que precisam continuar entrando depois do primeiro código, uma linha dedicada dos EUA ou do Canadá é a alternativa prática.

O que um número +374 pode verificar no OTP Gateway?

As rotas armênias cobrem atualmente mais de 1.700 serviços. Entre os populares no snapshot ao vivo estão WhatsApp, Telegram, Viber, Google (Gmail e YouTube), Facebook, Instagram, TikTok, Signal, LinkedIn, Microsoft & Outlook, Discord, ChatGPT (OpenAI) e Uber.

Os mensageiros merecem uma nota: Viber e Telegram são nomes familiares na Armênia, então um produto que leva os usuários a um canal de chat ali muitas vezes vai querer contas de teste neles. A disponibilidade de cada serviço muda ao longo do dia, e por isso a API a retorna ao vivo, em vez de imprimirmos uma lista fixa.

Como funciona a sequência de chamadas da API de OTP da Armênia?

Tudo fica em https://otproute.com/api/v1 com uma chave Bearer com o prefixo or_live_, do console do desenvolvedor. O id do país da Armênia é am.

1. Consulte os ids dos serviços uma vez com GET /api/v1/services e confirme am por GET /api/v1/countries.
2. Peça a GET /api/v1/prices?country=am&service=<id> o preço atual e se a rota está aberta.
3. Crie o pedido com POST /api/v1/activations e um corpo como {"service": "telegram", "country": "am"}. Guarde o id da ativação que ele retorna.
4. Coloque o número +374 no fluxo em teste e espere activation.sms_received no seu webhook ou faça polling em GET /api/v1/activations/{id}.
5. Se a execução for abortada, chame POST /api/v1/activations/{id}/cancel para que os fundos voltem imediatamente.

As requisições de webhook trazem X-OTPRoute-Signature: t=<unix>,v1=<hex>. Calcule o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, compare e descarte tudo que tiver um timestamp antigo. A documentação da API lista os demais eventos, activation.expired e activation.cancelled, que usam o mesmo id de ativação como chave. As contas são limitadas a 300 requisições por minuto, então faça polling com moderação.

Um colega sem acesso à API pode pedir um número +374?

Sim. A equipe de operações e os agentes de suporte podem fazer o mesmo pelo navegador:

1. Entre na conta, abra o OTP Gateway e escolha a Armênia.
2. Selecione o serviço; o preço atual aparece antes de você confirmar.
3. Copie o número para o app ou site que o pede.
4. Mantenha a ativação aberta; o código aparece ao lado do número quando chegar.

O painel e a API compartilham uma única carteira e um único histórico de pedidos, então um engenheiro de QA e um líder de suporte podem trabalhar com o mesmo saldo.

Como os números armênios devem ser armazenados, e em que idioma chegam os códigos?

Dentro da Armênia, as pessoas discam um 0 inicial como prefixo de tronco. Na forma internacional esse 0 desaparece e o código de país +374 é seguido por um número nacional de oito dígitos. Normalize toda entrada para E.164 antes de salvar: remova espaços e hífens, descarte o 0 doméstico e mantenha o sinal de mais com 374. Um formulário que aceita o formato doméstico, mas o armazena sem tratar, vai falhar depois nas buscas pelo valor E.164 que o seu ambiente de testes tem.

O armênio tem alfabeto próprio, e o russo é amplamente entendido, então uma interface em armênio é um alvo real de localização. Os textos de verificação de apps globais costumam seguir o idioma configurado no app e muitas vezes chegam em inglês, mas um modelo localizado pode voltar em armênio ou em escrita cirílica russa. Extraia os dígitos com um padrão que ignore as palavras em volta e garanta que logs e bancos de dados lidem com UTF-8, para que corpos de mensagem em alfabeto não latino não sejam corrompidos.

As equipes testam aqui por motivos práticos: onboarding localizado para um lançamento na Armênia, suporte à grande diáspora armênia que se cadastra do exterior com números de casa ou operações regionais que cobrem o Cáucaso Sul.

O que devo verificar quando nenhum código armênio chega?

O silêncio dentro da janela tem algumas causas habituais, e nenhuma delas custa dinheiro.

• O serviço recusou o número. Algumas plataformas recusam números virtuais de vez; é exatamente por isso que as ativações não usadas são reembolsadas.
• A rota está ocupada. Deixe a janela de 20 minutos correr até o fim e depois tente mais tarde ou escolha outra rota de serviço.
• O teste reenviou rápido demais. Refazer pedidos em um loop apertado raramente ajuda e pode acionar os limites do próprio serviço. Espere entre as tentativas.

Se nada chegar antes de a janela se fechar, ou se você cancelar, o valor total volta para a sua carteira automaticamente. O nosso guia sobre como reduzir falhas na entrega de OTP aborda com mais profundidade o tempo das novas tentativas.

Como as ativações armênias são cobradas e testadas?

A OTP Route funciona com uma única carteira pré-paga em USD, sem mensalidade e sem plano a escolher. Recarregue por cartão ou com as stablecoins USDT/USDC, e cada recarga gera uma fatura em PDF enviada por e-mail. Os valores atuais estão na página de preços e voltam do endpoint de preços.

Antes de gastar saldo real, peça o modo sandbox em uma conta de desenvolvimento. Ele retorna números e códigos simulados, de modo que um job de CI pode exercitar o fluxo am completo de ponta a ponta. A visão geral de testes de QA mostra como as equipes o encaixam em um pipeline. Use o serviço apenas para os seus próprios produtos e contas legítimas, siga os termos de cada plataforma e lembre-se de que a Política de Uso Aceitável da OTP Route se aplica.

Perguntas frequentes

Posso testar o fluxo de cadastro armênio do meu app sem um chip local?

Sim. Peça um número +374 para o seu serviço no OTP Gateway, informe-o no fluxo e leia o código no painel ou pela API com o id de país am.

Quanto custa um número +374 para testes?

Os códigos começam em $0.20 por código, e o valor exato depende do serviço. Você só paga se o SMS chegar dentro da janela de 20 minutos.

O número armazenado deve incluir o 0 inicial?

Não. Armazene-o em E.164: +374 seguido do número nacional de oito dígitos, com o 0 de tronco doméstico removido.

Posso manter um número de verificação armênio para logins futuros?

Não em autoatendimento. Os números do OTP Gateway servem a um único código; as linhas dedicadas de longo prazo são um produto dos EUA e do Canadá, e você pode escrever para [email protected] para perguntar sobre outros países.

Os códigos armênios chegarão em escrita armênia?

Às vezes. Muitos serviços enviam texto em inglês, mas modelos localizados podem usar armênio ou russo, então analise apenas os dígitos e armazene as mensagens em UTF-8.

Existe como testar a integração com a Armênia sem gastar saldo?

Sim. Peça o modo sandbox para uma conta de desenvolvimento e ele retornará números e códigos simulados para todo o fluxo de ativação.

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.