Como escolher a forma de receber códigos de verificação de Tonga (+676)

Número do Gateway ou linha de longo prazo: o que serve para um projeto em Tonga?

Comece pelo formato do trabalho. Se você precisa ver um código SMS chegar, para um teste de cadastro, uma checagem de localização ou a reprodução de um problema de suporte, o OTP Gateway é o produto certo. Você recebe um número +676 para uma verificação, o código chega ao painel e aos seus sistemas, e a ativação se encerra.

Se, em vez disso, você precisa de um número que fique com uma conta por meses, para voltar a fazer login, receber códigos de recuperação ou manter uma linha de suporte, esse é um trabalho para os Números Virtuais Dedicados. Eles estão disponíveis apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês, com SMS de entrada e saída e chamadas pelo navegador.

A OTP Route não tem linha tonganesa de longo prazo em autoatendimento. As equipes que precisarem de uma podem escrever para [email protected] para perguntar, sabendo que a disponibilidade depende das regras locais e pode não ser possível. Mais sobre essa troca em números temporários vs dedicados.

Por que alguém testaria um fluxo de cadastro com números de Tonga?

Tonga tem uma grande diáspora, em boa parte na Nova Zelândia, na Austrália e nos Estados Unidos, e as famílias mantêm contato entre esses países por apps de mensagens e serviços de remessa de dinheiro. Produtos que atendem comunidades do Pacífico, como ferramentas de remessa, plataformas comunitárias e serviços de viagem, precisam aceitar um número +676 com a mesma segurança que um +64.

Isso faz de Tonga um caso extremo útil no QA. O tonganês e o inglês são idiomas oficiais, e a maioria dos textos de verificação de apps internacionais chega em inglês, então os bugs interessantes costumam estar no tratamento do número, e não na redação da mensagem. As equipes que constroem onboarding de fintechs para corredores do Pacífico muitas vezes acrescentam um caso de Tonga à sua suíte de regressão justamente por esse motivo.

Como os validadores devem tratar números +676?

Os números nacionais de Tonga são muito mais curtos do que os europeus ou americanos que a maioria dos desenvolvedores tem na cabeça, e não há prefixo de tronco na forma internacional. Um código de validação com comprimento mínimo fixo é a causa mais comum de esses números serem rejeitados.

• Armazene todo número em E.164, +676 seguido dos dígitos do assinante, e nunca o preencha com zeros.
• Confie em uma biblioteca de telefones atualizada, e não em uma regex copiada de outro país.
• Garanta que o seu remetente de SMS não descarte silenciosamente destinatários cujo número parece curto demais.
• Mantenha um número de verificação de Tonga no seu conjunto de fixtures para que uma refatoração futura não reintroduza o bug.

Um pedido pontual de +676 no Gateway é uma forma barata de confirmar que todo o caminho funciona com um SMS real entregue por uma operadora.

Quais serviços a rota de Tonga cobre?

A rota tonganesa lista atualmente mais de 600 serviços. Entre os populares no último levantamento estão Facebook, TikTok, Viber, WhatsApp, Instagram, Telegram, Google (Gmail e YouTube), Snapchat, Microsoft e Outlook e Amazon.

A lista muda ao longo do dia conforme a capacidade se desloca entre rotas. Trate-a como um guia e confira a disponibilidade em tempo real antes de pedir, no painel ou pelo endpoint de preços.

Como chamar a API de OTP de Tonga?

Autentique-se em https://otproute.com/api/v1 com uma chave Bearer que começa com or_live_, obtida no Developer console. O id de país de Tonga é to.

Consulte preço e estoque com GET /api/v1/prices?country=to&service=<id> e depois faça o pedido com POST /api/v1/activations e um corpo como {"service": "viber", "country": "to"}. A resposta traz um id de ativação e um número +676.

Para receber automaticamente os códigos OTP por SMS de Tonga, registre um webhook para activation.sms_received e activation.expired. Cada requisição inclui X-OTPRoute-Signature: t=<unix>,v1=<hex>; recalcule o HMAC-SHA256 sobre <t>.<raw body> com o segredo do seu endpoint, compare em tempo constante e recuse timestamps antigos. O polling em GET /api/v1/activations/{id} serve para trabalhos pequenos, e POST /api/v1/activations/{id}/cancel libera um pedido de que você não precisa mais. Os limites são 300 requisições por minuto, 10 chaves e 5 endpoints de webhook por conta. Veja a documentação para desenvolvedores para detalhes de requisição e resposta.

O que fazer quando um código de Tonga está lento ou não chega?

Rotas finas são normais em mercados de pequenas ilhas, então construa a política de novas tentativas antes de precisar dela.

1. Deixe a janela de 20 minutos terminar; o pedido é reembolsado integralmente se nenhum SMS chegar.
2. Verifique se o serviço que você está testando aceita números virtuais. Alguns não aceitam, e nenhuma rota vai mudar isso.
3. Espere antes de tentar de novo, em vez de fazer pedidos novos em sequência.
4. Se o teste for sobre números do Pacífico em geral, tente uma rota próxima, como Fiji ou Samoa.

Lembre-se de que todo pedido deve respeitar os termos do serviço de destino e a Política de Uso Aceitável da OTP Route.

Como funcionam a cobrança e os testes em sandbox?

A OTP Route usa uma única carteira pré-paga em USD com preço conforme o uso, então não há mensalidade nem plano a escolher. Adicione fundos por cartão ou com stablecoins USDT/USDC, e cada recarga é seguida de uma fatura em PDF por e-mail. Desenvolvedores que ainda estão montando o fluxo podem pedir o modo sandbox para uma conta de desenvolvimento, que retorna números e códigos simulados para que a lógica de roteamento de OTP e os handlers de webhook sejam testados sem tocar na carteira. Os valores atuais por código estão na página de preços.

Perguntas frequentes

Posso receber um código de verificação de Tonga sem estar em Tonga?

Sim. Peça um número +676 no OTP Gateway e o código é exibido no seu painel e enviado ao seu webhook, onde quer que sua equipe esteja.

Qual id de país a API de verificação por SMS usa para Tonga?

O id é to, usado em GET /api/v1/prices e em POST /api/v1/activations.

Por que o meu formulário rejeita números tonganeses válidos?

Normalmente por uma verificação de comprimento mínimo escrita para números mais longos. Valide com uma biblioteca de telefones mantida e armazene os números em E.164.

Existe um número +676 de longo prazo que eu possa manter?

Não em autoatendimento. Os Números Dedicados de longo prazo são oferecidos apenas nos EUA e no Canadá; escreva para [email protected] para perguntar sobre Tonga.

O que acontece com o meu dinheiro se o código de Tonga não chegar?

O valor integral volta automaticamente para a sua carteira quando a janela de 20 minutos se encerra sem um SMS, ou quando você cancela.

Posso testar o onboarding tonganês do meu app no CI?

Sim. Use uma chave de API por ambiente, faça polling ou escute webhooks e mude uma conta de desenvolvimento para sandbox enquanto monta o pipeline.

Em que idioma chegam os textos de verificação de Tonga?

A maioria dos apps internacionais envia em inglês, embora dependa do serviço e da configuração de idioma da conta.

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.