Checklist pré-voo para receber códigos de verificação +372 na Estônia

O que entra no checklist antes do primeiro pedido +372?

A maioria das execuções de teste que falham tem origem em algo que faltava antes mesmo de o número ser solicitado. Marque estes itens primeiro:

• Uma chave de API criada no console do desenvolvedor. Cada chave tem o prefixo or_live_ e viaja como token Bearer; como há espaço para 10 por conta, o runner de CI merece uma chave própria.
• Um endpoint de webhook com o segredo guardado no servidor, se você preferir ser chamado em vez de fazer polling. São permitidos cinco endpoints por conta.
• Os ids corretos. A Estônia é ee em toda requisição, e o id do serviço vem de GET /api/v1/services.
• Uma consulta de preço em tempo real. Chame GET /api/v1/prices?country=ee&service=<id> para que o job saiba o custo antes de comprometer fundos da carteira.
• Sandbox, se você ainda estiver montando tudo. Sob solicitação, uma conta de desenvolvimento pode passar ao modo sandbox, que retorna números e códigos simulados de ponta a ponta sem tocar no seu saldo.
• Um orçamento de requisições. A API aceita 300 requisições por minuto por conta, o que sobra, a menos que uma suíte de testes faça polling sem cuidado.

O guia de integração da API de OTP aborda cada um desses pontos com mais profundidade.

Como executo uma requisição da API OTP da Estônia do início ao fim?

Com o checklist cumprido, a sequência de chamadas é curta:

1. POST /api/v1/activations com o corpo {"service": "<id>", "country": "ee"}. A resposta traz um id de ativação e o número +372 para digitar no formulário de cadastro ou login em teste.
2. Dispare o SMS de verificação a partir do app que você está testando.
3. Aguarde o código. Ou o seu endpoint recebe activation.sms_received, ou você chama GET /api/v1/activations/{id} num intervalo razoável.
4. Envie o código no app e registre o resultado junto ao id da ativação.
5. Se o caminho do teste mudar e o número não for mais necessário, chame POST /api/v1/activations/{id}/cancel para que a reserva seja liberada de imediato.

Nas entregas por webhook, leia o cabeçalho X-OTPRoute-Signature (t=<unix>,v1=<hex>), calcule o HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint, compare em tempo constante e descarte qualquer coisa com timestamp antigo. Protegendo webhooks de OTP com HMAC apresenta um handler de referência. Torne as gravações idempotentes pelo id da ativação, porque uma nova tentativa pode entregar o mesmo evento duas vezes.

Quais serviços podem enviar códigos para um número de verificação estoniano?

O panorama atual da Estônia lista mais de 1,700 serviços. Entre as rotas populares estão WhatsApp, Telegram, Google (Gmail e YouTube), Facebook, Instagram, LinkedIn, Microsoft e Outlook, Amazon, Discord, Signal, Uber, Airbnb e ChatGPT (OpenAI).

O estoque muda ao longo do dia, então uma rota que respondeu hoje de manhã pode estar fraca à noite. Trate GET /api/v1/countries e o endpoint de preços como fonte da verdade, em vez de fixar uma lista nas fixtures dos seus testes.

Como armazenar e validar números +372?

A Estônia tem um dos planos de numeração mais simples de tratar, e justamente por isso validadores preguiçosos falham nela. Não há prefixo de tronco para remover: um número escrito no formato doméstico tem os mesmos dígitos que você acrescenta depois de +372. Os celulares geralmente começam com 5 e têm sete ou oito dígitos, então uma regex que exige um comprimento nacional fixo vai rejeitar entradas válidas.

Regras práticas para seus formulários e banco de dados:

• Guarde a string E.164 completa, como +3725xxxxxxx, e mantenha a entrada bruta do usuário separada, caso precise dela no suporte.
• Nunca acrescente um zero; não há nada a remover nem a adicionar.
• Teste os comprimentos de celular de sete e de oito dígitos nas máscaras de entrada.

Os textos de verificação destinados a usuários estonianos costumam chegar em estoniano, embora muitos apps sigam o idioma da conta ou do aparelho, e modelos em russo ou inglês também são comuns. Se o seu produto tem uma localização em estoniano, verifique se letras como õ, ä, ö e ü sobrevivem ao caminho do modelo até o aparelho.

Por que as equipes testam cadastros com números estonianos?

A Estônia rende muito mais do que o seu tamanho sugere para equipes de software. A reputação de governo digital e o programa de e-Residency fazem com que muitos fundadores e empresas remotas tenham algum vínculo com o país mesmo quando a equipe mora em outro lugar, e produtos voltados à região báltica e nórdica costumam lançar por lá primeiro.

Motivos típicos para um líder de QA pedir um número +372 para testes:

• Confirmar que seletores de país, máscaras de telefone e modelos de SMS funcionam num mercado da UE com plano de numeração curto.
• Verificações de localização do texto em estoniano antes de um lançamento regional.
• Reproduzir um chamado de um cliente estoniano cujo código nunca chegou.

Veja testes de QA para saber como as equipes incorporam essas verificações ao ciclo de lançamento.

O que verificar quando o código não aparece?

Investigue o problema em ordem, em vez de pedir número atrás de número:

1. Deixe a janela correr. A ativação fica aberta por 20 minutos, e alguns serviços enfileiram seus textos.
2. Confirme se o serviço aceita números virtuais. Alguns serviços os rejeitam por política; é esse o motivo do reembolso.
3. Olhe o status final. Um evento activation.expired, ou um estado de expirado na chamada GET, significa que nenhum SMS chegou e o dinheiro já voltou para a carteira.
4. Tente de novo com paciência. Tente novamente um pouco mais tarde, ou use outra rota para o mesmo serviço, em vez de refazer o pedido em loop apertado.
5. Verifique o seu próprio gatilho. Um teste que nunca solicitou o SMS de fato é idêntico a um código ausente.

Nosso artigo sobre como reduzir falhas na entrega de OTP lista outras causas que vale descartar.

Posso manter uma linha estoniana de longo prazo e como funciona a cobrança?

Não existe número estoniano de longo prazo em autoatendimento. Os Dedicated Numbers são um produto dos EUA e do Canadá a partir de $1.95/month; para a Estônia, escreva para [email protected] se a sua equipe precisar de uma linha persistente, e o time dirá o que as regras locais permitem, sem qualquer promessa de disponibilidade.

A cobrança do roteamento de OTP passa por uma única carteira pré-paga em USD, sem mensalidade e sem plano para escolher. Recarregue com 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, e a referência dos endpoints fica na documentação.

Perguntas frequentes

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

Sim. Peça um número +372 pelo OTP Gateway, use-o no seu formulário de cadastro e leia o código no painel, em um webhook ou no endpoint de ativação.

Qual é o id da Estônia na API da OTP Route?

Use ee como valor de country nas requisições de ativação e de preço.

Os números de telefone estonianos têm prefixo de tronco que preciso remover?

Não. A Estônia não tem prefixo de tronco, então os dígitos domésticos seguem +372 sem alteração.

Sou cobrado quando nenhum código estoniano chega?

Não. Se nada chegar dentro da janela de 20 minutos, ou se você cancelar antes, o valor integral volta automaticamente para a sua carteira.

Uma pessoa sem perfil técnico pode pedir um número de verificação da Estônia?

Sim. No painel, escolha a Estônia e o serviço, confirme o preço exibido, copie o número para o app e espere o código aparecer na mesma tela.

Dá para ensaiar a integração estoniana antes de gastar fundos reais?

Peça ao suporte para colocar sua conta de desenvolvimento em sandbox, que retorna números e códigos simulados para que todo o fluxo rode sem fundos da carteira.

Quais regras se aplicam ao uso desses números?

Siga os termos de cada serviço e a Política de Uso Aceitável da OTP Route; os números servem para testar e operar seus próprios produtos e contas legítimos.

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.