Testando a verificação por telefone tailandesa (+66): checklist, passos e correções

Antes de começar: um checklist de testes +66

Os fluxos de cadastro tailandeses têm algumas armadilhas que é mais barato pegar no papel do que em uma execução de CI que falhou. Confirme cada item antes:

• Credenciais. Uma chave Bearer com o prefixo or_live_ do console do desenvolvedor, com escopo para o ambiente que vai usá-la.
• Identificadores. O id do país da Tailândia é th; pegue o id do serviço em GET /api/v1/services em vez de adivinhá-lo.
• Forma de entrega. Ou um endpoint de webhook com o segredo de assinatura salvo, ou um job de polling que respeite o limite de 300 requisições por minuto.
• Tratamento do número. Defina como o seu código remove o 0 doméstico antes de armazenar qualquer coisa (veja a seção sobre formatação).
• Interpretação da mensagem. Garanta que o parser lide com a escrita tailandesa ao redor dos dígitos.
• Orçamento. Uma carteira com saldo, ou uma conta sandbox se você só precisa provar a integração.

Quais fluxos de cadastro tailandeses o OTP Gateway pode cobrir?

A Tailândia é uma das rotas mais amplas, com mais de 1.800 serviços no snapshot ao vivo. Mensagens e comércio dominam o uso local, então as equipes costumam começar por LINE, Shopee, Lazada, TikTok, WhatsApp, Facebook, Instagram e Telegram. Outros da lista incluem Google (Gmail & YouTube), Microsoft & Outlook, ChatGPT (OpenAI), Discord, Viber, Netflix, Amazon e Airbnb.

A disponibilidade por serviço muda conforme os números entram e saem, então leia o endpoint de preços antes de cada execução em vez de fixar suposições no código.

Pedindo um número de verificação da Tailândia pela API

A URL base é https://otproute.com/api/v1.

1. Solicite GET /api/v1/prices?country=th&service=<id>; uma resposta vazia ou indisponível significa que você deve escolher outro horário ou outra rota.
2. Envie POST /api/v1/activations com um corpo como {"service": "line", "country": "th"}. Guarde o id da ativação retornado junto com a sua execução de teste.
3. Digite o número +66 no app em teste e dispare o SMS.
4. Obtenha o código no evento activation.sms_received, ou em GET /api/v1/activations/{id} se você usar polling.
5. Libere os pedidos desnecessários com POST /api/v1/activations/{id}/cancel.

Verifique o cabeçalho X-OTPRoute-Signature (t=<unix>,v1=<hex>) em toda entrega e descarte os eventos cujo timestamp seja antigo demais. Os eventos são identificados pelo id da ativação, o que facilita ignorar entregas duplicadas. Exemplos completos de requisições estão na documentação para desenvolvedores.

Formatos de número tailandeses, o zero de tronco e mensagens em escrita tailandesa

No uso doméstico, os celulares tailandeses são escritos com um 0 inicial e mais nove dígitos, geralmente começando por 06, 08 ou 09. Esse 0 é um prefixo de tronco: no formato internacional ele desaparece, de modo que 08x xxx xxxx vira +66 8x xxx xxxx. Armazene a versão E.164 e normalize qualquer entrada do usuário que ainda tenha o zero, ou a sua deduplicação tratará um mesmo aparelho como duas pessoas.

Os códigos de apps voltados à Tailândia muitas vezes chegam dentro de uma frase em tailandês. Extraia o código por padrão (uma sequência de dígitos do tamanho esperado) em vez de se apoiar em palavras em inglês, e lembre-se de que o SMS em escrita tailandesa usa codificação Unicode, de modo que as mensagens se dividem em segmentos mais curtos. A QA de localização é o outro motivo pelo qual as equipes testam aqui: os campos de data em interfaces tailandesas costumam mostrar o ano da Era Budista, e os limites de tamanho dos campos de nomes e endereços tailandeses são fáceis de errar. Lançamentos de produtos no Sudeste Asiático, onboarding de vendedores em marketplaces e centrais de suporte em tailandês completam a lista habitual.

Como a equipe de suporte e de operações usa o painel no lugar disso?

Nem toda verificação precisa de um script. Alguém da equipe de operações pode criar uma conta, adicionar saldo, abrir o OTP Gateway, escolher um serviço e a Tailândia, conferir o preço informado e receber o número. O código chega ao cartão da ativação no navegador. Vale a mesma janela de 20 minutos, e o reembolso acontece por conta própria se a janela se encerrar vazia.

Solução de problemas para códigos que nunca chegam ao número +66

Quando uma ativação continua vazia, siga esta lista:

• Dê a ela a janela completa antes de cancelar; reenvios atrasados são comuns.
• Confirme se o serviço aceita números virtuais para a Tailândia. Alguns não aceitam, e é isso que o reembolso automático cobre.
• Tente de novo mais tarde, ou mude para outra rota de país se o seu caso de teste permitir. O artigo sobre roteamento por país explica como as equipes escolhem alternativas.
• Espace as novas tentativas. Refazer o pedido em loop apertado raramente ajuda e polui os seus logs.

Nenhum dinheiro se perde em uma tentativa que falha: uma ativação expirada ou cancelada devolve o valor integral à carteira.

Linhas de longo prazo, carteira e sandbox para projetos tailandeses

A OTP Route não vende um número de longo prazo da Tailândia em autoatendimento. As equipes que precisam de uma linha tailandesa persistente podem escrever para [email protected] para perguntar; as regras locais decidem se algo é possível. Os números dedicados que você mantém e renova estão disponíveis apenas nos EUA e no Canadá, a partir de $1.95/mês.

Todo o resto funciona com uma carteira pré-paga em USD, sem assinatura. Recarregue com cartão ou USDT/USDC, e uma fatura em PDF é enviada por e-mail a cada recarga. Para o trabalho de integração, uma conta de desenvolvimento pode ser movida para o sandbox, para que números e códigos simulados passem pelo seu código sem custo. Veja os preços para os valores atuais, respeite os termos de cada serviço e lembre-se de que a Política de Uso Aceitável da OTP Route vale para toda ativação.

Perguntas frequentes

Posso verificar o cadastro tailandês do meu app sem um chip da Tailândia?

Sim. Peça um número +66 no OTP Gateway, informe-o no seu app e leia o código no painel ou pela API e por webhooks.

Devo manter o 0 inicial ao armazenar um celular tailandês?

Não. Descarte o 0 de tronco e armazene o número como +66 seguido dos nove dígitos restantes.

Qual id a API espera para a Tailândia?

Use th como valor do país, por exemplo em GET /api/v1/prices?country=th&service=<id>.

Por que a mensagem do LINE ou da Shopee chega em tailandês?

Muitos serviços localizam o modelo de SMS pelo país do número ou pelo idioma da conta, então faça o parsing dos dígitos em vez de palavras-chave em inglês.

Quanto custa uma ativação que falha na Tailândia?

Nada. Se a janela de 20 minutos terminar sem SMS, ou se você cancelar, o valor integral volta para a sua carteira automaticamente.

Há como rodar testes de OTP tailandeses no CI sem gastar dinheiro?

Sim, peça o modo sandbox para uma conta de desenvolvimento. Ele retorna números e códigos simulados para que o pipeline seja testado de ponta a ponta, como descrito na página da solução de CI/CD.

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.