Como receber códigos SMS georgianos +995 para QA e lançamentos regionais

Por que o país Geórgia atrapalha planos de teste?

A primeira surpresa é o nome. A Geórgia, o país, divide-o com um estado americano, e por isso bibliotecas de formulário, filtros de analytics e até colegas de equipe confundem os dois. Na API, o id do país é ge, correspondente ao código ISO GE, e o código de discagem é +995. Um teste que escolhe em silêncio um número +1 dos EUA porque alguém digitou "Georgia" numa caixa de busca é um bug que vale pegar cedo.

A segunda é a escrita. O georgiano usa seu próprio alfabeto, o mkhedruli, que fica fora do conjunto de caracteres GSM de 7 bits. Qualquer SMS com letras georgianas é enviado em Unicode, de modo que cada segmento comporta menos caracteres e mensagens mais longas se dividem antes. Se o seu próprio produto envia mensagens em georgiano, é exatamente isso que o QA de localização deve examinar.

Como é um número +995 armazenado corretamente?

Dentro do país, as pessoas discam um prefixo de tronco 0 antes do número do assinante; no âmbito internacional esse 0 desaparece. Os celulares têm nove dígitos e começam com 5, então a forma E.164 é +995 seguido de nove dígitos começando com 5.

Uma rotina prática de normalização para entradas georgianas:

• Remova espaços, pontos e hifens que os usuários digitam por hábito.
• Se o valor começar com 0 e tiver dez dígitos, descarte o 0 e acrescente +995.
• Se começar com 995 e sem o sinal de mais, acrescente o sinal.
• Rejeite qualquer coisa que, depois do sinal de mais, ainda não tenha doze dígitos.

Guardar um único formato canônico significa que o número que o seu teste digita coincide com o número que o seu backend depois consulta.

Quais fluxos de verificação georgianos posso exercitar?

O panorama da Geórgia mostra atualmente WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft e Outlook, Discord, LinkedIn e Viber, e o catálogo completo passa de 1,500 serviços.

As equipes testam aqui por alguns motivos recorrentes: um produto que entra no Cáucaso Sul, uma equipe remota em Tbilisi que verifica contas empresariais regionais ou uma revisão de localização que checa se o texto georgiano é exibido corretamente nas telas de cadastro. A disponibilidade muda ao longo do dia, então, antes de reservar um número +995 para testes, pergunte à API em vez de confiar na lista de ontem. O roteamento de OTP escolhe entre o que está ativo naquele momento.

Como se desenrola a sequência de chamadas da API OTP da Geórgia?

Todas as chamadas vão para https://otproute.com/api/v1 com uma chave Bearer com o prefixo or_live_. Cada conta pode ter até 10 chaves, o que permite manter staging e produção separados.

1. Busque GET /api/v1/countries uma vez e confirme o id ge.
2. Chame GET /api/v1/prices?country=ge&service=<id> para ler o preço e a disponibilidade de hoje.
3. Faça o pedido com POST /api/v1/activations, por exemplo {"service": "whatsapp", "country": "ge"}.
4. Digite o número +995 no app em teste e dispare a etapa de SMS.
5. Leia o código em GET /api/v1/activations/{id}, ou deixe um webhook entregá-lo.
6. Se o cenário for abortado, libere o pedido com POST /api/v1/activations/{id}/cancel.

O limite de 300 requisições por minuto deixa espaço para fazer polling a cada poucos segundos em vários jobs paralelos.

Devo usar polling ou webhooks para os códigos +995?

Os dois estilos usam a mesma API de verificação por SMS, e o polling serve para um único desenvolvedor que quer receber mensagens SMS OTP da Geórgia a partir de um laptop. No CI, um webhook é mais tranquilo: registre até 5 endpoints no console do desenvolvedor e assine activation.sms_received, activation.expired e activation.cancelled.

Verifique toda requisição. O cabeçalho X-OTPRoute-Signature traz t=<unix>,v1=<hex>; calcule o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, compare em tempo constante e descarte requisições com timestamp antigo. Guarde os resultados pelo id da ativação para que uma entrega repetida seja inofensiva. O artigo sobre captura por webhook traz um padrão completo.

Um código georgiano não chegou. O que devo tentar?

Primeiro, dê a ele os 20 minutos completos; o pedido se reembolsa sozinho se nada chegar. Depois considere se o serviço aceita números virtuais para contas georgianas, já que alguns não aceitam. Tentar de novo mais tarde, ou executar o mesmo teste por outra rota de serviço, muitas vezes resolve uma queda temporária. O que você não deve fazer é disparar pedidos novos em loop apertado, o que desperdiça tempo e parece suspeito para a plataforma que recebe.

Números de longo prazo, cobrança e um sandbox

A OTP Route não vende números georgianos de longo prazo em autoatendimento. As linhas dedicadas existem apenas nos Estados Unidos e no Canadá, a partir de $1.95/month; para perguntar sobre uma linha +995 persistente, escreva para [email protected], e a resposta dependerá das regras locais.

A carteira é pré-paga em USD, sem assinatura: recarregue com cartão ou USDT/USDC e receba uma fatura em PDF a cada vez. Uma conta sandbox, disponível sob solicitação, retorna números e códigos simulados para testes de integração. Veja os preços ou crie uma conta para começar.

Perguntas frequentes

Como garanto que receberei um número da Geórgia, o país, e não do estado americano?

Use o id de país ge nas chamadas de API e procure o código de discagem +995 no painel. Um estado americano nunca tem um id de país próprio.

Posso testar um fluxo de cadastro georgiano sem um chip local?

Sim. Um número do OTP Gateway com o prefixo +995 recebe o código, e você o lê no painel ou pela API.

Mantenho o 0 inicial ao salvar celulares georgianos?

Não. O 0 é um prefixo de tronco doméstico; armazene o número como +995 mais nove dígitos começando com 5.

Por que as mensagens SMS em georgiano parecem mais curtas por segmento?

As letras georgianas ficam fora do alfabeto GSM de 7 bits, então a mensagem usa codificação Unicode, que comporta menos caracteres em cada segmento.

Qual é o preço de um número de verificação georgiano?

Começa em $0.20 por código e depende do serviço. O preço em tempo real vem de GET /api/v1/prices e aparece no painel antes do pedido.

Sou cobrado se a plataforma rejeitar o número?

Não. Quando nenhum SMS chega dentro da janela de 20 minutos, ou você cancela, o valor integral volta para a sua carteira.

Quais usos são permitidos com números +995?

Testar o seu próprio produto, automação de QA e operar as suas próprias contas empresariais. Siga os termos de cada serviço e a Política de Uso Aceitável da OTP Route.

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.