Roteando OTPs albaneses (+355) para o seu pipeline de testes

Quais chamadas REST retornam um número albanês e o seu código?

A API de OTP da Albânia é a mesma API de verificação por SMS usada em todos os mercados; só muda o id do país. As requisições vão para https://otproute.com/api/v1 com uma chave Bearer com o prefixo or_live_, gerada no console do desenvolvedor. O id da Albânia é al, então uma execução típica é assim:

1. GET /api/v1/services resolve o id do serviço de que você precisa, por exemplo telegram ou google. Guarde a lista em cache entre as execuções.
2. GET /api/v1/prices?country=al&service=<id> lê o preço atual e confirma que a rota está aberta agora.
3. POST /api/v1/activations com {"service": "telegram", "country": "al"} retorna um id de ativação e um número +355.
4. O seu teste envia esse número na tela de cadastro ou de login do app em teste.
5. O código chega por webhook ou por polling em GET /api/v1/activations/{id}; chame POST /api/v1/activations/{id}/cancel se o teste for interrompido.

Uma conta pode ter até 10 chaves, então o staging, o CI e o notebook de um colega podem ter cada um a sua e ser revogados separadamente. O limite de 300 requisições por minuto deixa folga para várias suítes em paralelo. Os detalhes de cada campo estão na referência da API.

Meus testes da Albânia devem fazer polling ou escutar webhooks?

O polling é o mais rápido de configurar: consulte o endpoint da ativação a cada poucos segundos até o status mudar. Quando as suítes passam a rodar em paralelo, um webhook é mais organizado. Registre até 5 endpoints e se inscreva em activation.sms_received, activation.expired e activation.cancelled.

Toda entrega é assinada. O cabeçalho X-OTPRoute-Signature tem o formato t=<unix>,v1=<hex>, em que v1 é o HMAC-SHA256 de "<t>.<raw body>" calculado com o segredo do endpoint. Recalcule-o sobre os bytes intactos da requisição, compare em tempo constante e descarte tudo que tiver um timestamp antigo. Trate os eventos com o id da ativação como chave, para que uma entrega repetida nunca grave duas vezes. O nosso artigo sobre captura de OTP por webhook percorre um handler completo.

Como os números +355 devem ser normalizados antes de chegar ao meu banco de dados?

A Albânia usa o código de país +355 e um prefixo de tronco doméstico 0. Localmente, um número de celular costuma ser escrito com esse 0 à frente, como 06X XXX XXXX, enquanto a forma internacional o omite: +355 6X XXX XXXX. Armazene a versão E.164 (+3556…, sem espaços) e aplique a formatação local só na hora de exibir.

Verificações que valem a pena ao validar um número +355 para testes:

• Remova o 0 inicial quando o usuário digitar a forma nacional depois de já ter selecionado +355.
• Rejeite um prefixo duplicado como +355 0 6X, que aparece quando um formulário cola o código do país ao número local sem pensar.
• Mantenha espaços, hífens e parênteses fora do valor armazenado.

O texto em torno do código depende do serviço remetente e do idioma da conta; albanês e inglês são ambos comuns. Mire nos dígitos no seu parser em vez de uma frase fixa. As equipes testam esse mercado ao lançar um produto na Albânia, ao localizar um app para falantes de albanês na região e no exterior, ou ao confirmar que uma conta de operações regional ainda é verificada.

O que posso verificar na rota da Albânia?

A rota da Albânia lista atualmente mais de 1.500 serviços. Entre os populares no snapshot ao vivo estão WhatsApp, Telegram, Google (Gmail e YouTube), Facebook, Instagram, TikTok, Viber, Signal, Microsoft & Outlook, ChatGPT (OpenAI), Uber, LinkedIn e Discord.

O estoque muda ao longo do dia, e por isso a disponibilidade vem da API e não de uma lista estática. Condicione cada teste a uma consulta de preço para al e marque-o como ignorado, não como falho, quando a rota estiver fechada naquele momento. Assim o ruído do roteamento de OTP fica fora dos resultados reais da sua regressão.

Um colega sem perfil técnico pode pedir um número +355?

Sim. O painel cobre o mesmo fluxo sem nenhum código:

1. Cadastre-se com o seu e-mail e um código de 6 dígitos por e-mail ou com o login do Google e ative a autenticação em dois fatores TOTP.
2. Adicione saldo à carteira por cartão ou com USDT/USDC.
3. Escolha a Albânia e o serviço, confira o preço exibido e confirme o pedido.
4. Digite o número de verificação da Albânia no app; o código aparece na página da ativação quando o SMS chegar.

Agências que gerenciam perfis de clientes e equipes de operações que criam contas empresariais regionais costumam usar esse caminho. Os pedidos feitos aqui e pela API compartilham a mesma carteira e a mesma regra de reembolso.

E se o SMS albanês nunca aparecer?

Uma ativação fica aberta por 20 minutos. Você só paga se o código chegar; se a janela se fechar vazia ou se você cancelar antes, o valor total volta para a sua carteira por conta própria e o webhook dispara activation.expired ou activation.cancelled.

Quando um código não aparece:

• Dê tempo à janela antes de reagir, pois alguns serviços enviam devagar.
• Verifique se o serviço aceita números virtuais; alguns os recusam por política.
• Tente de novo mais tarde, ou por outra rota de serviço, se o seu teste permitir.
• Evite refazer pedidos em um loop apertado. Espere entre as tentativas para que um script não martele a rota.

O nosso texto sobre como reduzir falhas na entrega de OTP lista outros padrões de novas tentativas para rotas dos Bálcãs e além. Use esses números apenas para os seus próprios produtos e contas, siga os termos de cada serviço e lembre-se de que a Política de Uso Aceitável da OTP Route se aplica.

Existe uma linha albanesa de longo prazo, e como funciona a cobrança?

Não existe número de longo prazo em autoatendimento para a Albânia. Os Números Virtuais Dedicados são vendidos na hora apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês, com SMS de entrada, encaminhamento por webhook, SMS de saída e chamadas pelo navegador. Se você precisa de uma linha albanesa duradoura, escreva para [email protected]; se é possível providenciar depende das regras locais e não é garantido.

A cobrança 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 vem com uma fatura em PDF por e-mail. Os valores atuais estão na página de preços. Para trabalhos de integração, peça para mudar uma conta de desenvolvimento para o sandbox, que retorna números e códigos simulados, para que o pipeline possa ser exercitado sem gastar o saldo da carteira.

Perguntas frequentes

Posso testar o fluxo de cadastro albanês do meu app sem um chip local?

Sim. Peça um número do OTP Gateway com o país al, envie-o na sua tela de cadastro e leia o código no painel ou no seu webhook. Não há chip nem contrato com operadora local envolvidos.

Quanto custa um código de verificação albanês?

Os códigos começam em $0.20, e o preço exato de um serviço é retornado por GET /api/v1/prices antes de você pedir. Se nada chegar dentro da janela de 20 minutos, a cobrança volta para a sua carteira.

Devo armazenar números albaneses com o 0 inicial?

Não. Salve-os em E.164, ou seja, +355 seguido do número nacional sem o 0 de tronco, e recoloque o 0 apenas na exibição local.

O mesmo número +355 pode ser reutilizado em um login futuro?

Um número do OTP Gateway atende a um único código de verificação. Para contas que precisam continuar entrando, use um Número Dedicado nos EUA ou no Canadá, ou pergunte ao suporte sobre a Albânia.

A OTP Route tem sandbox para testes de integração da Albânia?

O modo sandbox pode ser ativado em uma conta de desenvolvimento sob solicitação. Ele retorna números e códigos simulados, para que as execuções de CI exercitem o fluxo completo sem tocar nos fundos da carteira.

Por que o app recusou o meu número albanês?

Alguns serviços recusam números virtuais. Cancele a ativação ou deixe-a expirar para receber o reembolso automático e tente de novo em outro horário ou por outra rota.

Qual id da API devo usar para a Albânia?

Use al como valor de country nas consultas de preço e nas requisições de ativação, e pegue o id do serviço em GET /api/v1/services.

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.