Códigos de verificação vietnamitas (+84), direto para a sua suíte de testes

Por que vale testar o Vietnã em uma rota +84 real?

O Vietnã é um mercado mobile-first em que chat, social commerce e serviços no estilo super-app ocupam o centro da vida diária. O Zalo é o mensageiro local amplamente usado, e marketplaces como Shopee e Lazada são nomes conhecidos de todos. As equipes de produto testam aqui ao lançar uma versão vietnamita, validar um onboarding em vietnamita ou atender clientes do Sudeste Asiático a partir de um hub regional de operações. Nossa página de verificação em apps móveis descreve como esse tipo de teste costuma se encaixar em um ciclo de release.

Como são formatados os números de celular vietnamitas?

No formato doméstico, os celulares são escritos com um 0 de tronco e dez dígitos no total, começando com prefixos como 03, 05, 07, 08 ou 09. Em 2018 o país migrou seus antigos celulares de onze dígitos para dez dígitos, então dados antigos de CRM ainda podem conter prefixos desatualizados.

Para armazenamento, descarte o 0 e use E.164: +84 mais nove dígitos. Normalize na entrada e formate para exibição separadamente.

O vietnamita usa diacríticos, e os remetentes costumam removê-los dos SMS para encurtar as mensagens, então um código pode chegar em vietnamita sem acentos ou em inglês. Teste se o seu parser extrai os dígitos nos dois casos.

Quais serviços estão disponíveis na rota do Vietnã?

Mais de 2.800 serviços estão listados atualmente para o Vietnã. Entre os mais solicitados estão Zalo, Shopee, Lazada, TikTok, Facebook, Telegram, WhatsApp, Google (Gmail e YouTube), Instagram, Microsoft e Outlook, Amazon, ChatGPT (OpenAI), Discord e Viber. A disponibilidade muda ao longo do dia, então leia-a em tempo real em vez de fixar suposições no código.

O que uma rodada de QA vietnamita realmente deve cobrir?

Além de receber o código, uma boa execução de testes com +84 verifica as partes do onboarding que costumam quebrar nesse mercado:

• o campo de telefone aceita tanto a entrada nacional 09… quanto a internacional +84 9… e salva as duas de forma idêntica;
• o seletor de país mostra Việt Nam corretamente, com acentos, na sua versão em vietnamita;
• o preenchimento automático de OTP no Android e no iOS continua capturando os dígitos quando o texto ao redor não tem acentos;
• o texto de erro para código errado ou expirado soa natural em vietnamita, e não como uma tradução literal;
• o botão de reenvio espera o suficiente para que uma entrega lenta não seja ultrapassada por uma segunda solicitação.

Executar isso em uma rota real, e não em uma camada de SMS simulada, revela bugs de formatação e de parsing antes que os clientes em Hanói ou Ho Chi Minh os encontrem.

Como funciona a API de OTP do Vietnã de ponta a ponta?

As requisições vão para https://otproute.com/api/v1 com uma chave Bearer (prefixo or_live_). O id do país do Vietnã é vn.

1. Consulte GET /api/v1/prices?country=vn&service=zalo para confirmar preço e disponibilidade.
2. Reserve um número enviando a POST /api/v1/activations o corpo {"service": "zalo", "country": "vn"}; guarde o id da ativação retornado.
3. Envie o número +84 retornado na tela de verificação do seu app.
4. Receba activation.sms_received em um webhook ou faça polling em GET /api/v1/activations/{id} a cada poucos segundos.
5. Encerre as ativações desnecessárias com POST /api/v1/activations/{id}/cancel.

Verifique o X-OTPRoute-Signature de cada webhook antes de confiar nele. Para uma configuração completa de CI, veja testes de OTP por SMS em pipelines de CI.

Quem não é desenvolvedor também pode pedir um número +84?

Sim. No painel, selecione o Vietnã e o serviço, confira o preço exibido, confirme e cole o número no app. O código aparece no cartão da ativação. Se nada chegar em 20 minutos, ou se você cancelar, o valor é reembolsado na sua carteira.

A OTP Route vende números vietnamitas de longo prazo?

Não. Os Dedicated Virtual Numbers de autoatendimento existem apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês. Para o Vietnã, cada número do OTP Gateway recebe um único código. Equipes que querem uma linha +84 persistente podem escrever para [email protected], embora a regulamentação local determine se isso é possível. Compare os dois modelos na página de números virtuais.

Como se paga pelos testes com +84?

As ativações vietnamitas usam a mesma carteira pré-paga em USD de qualquer outra rota, sem mensalidade nem plano para escolher. Pagamentos por cartão e USDT/USDC funcionam nas recargas, e cada uma gera uma fatura em PDF enviada por e-mail para o seu financeiro. Solicite o modo sandbox em uma conta de desenvolvimento para rodar números e códigos simulados na sua integração sem custo para a carteira.

Perguntas frequentes

Posso testar o cadastro vietnamita do meu app sem comprar um chip local?

Sim. Peça um número +84 no OTP Gateway, envie-o no seu próprio fluxo de cadastro e leia o código no painel ou pela API.

Devo armazenar números vietnamitas com o 0 inicial?

Não. Armazene-os como +84 seguido de nove dígitos e recoloque o 0 apenas ao exibir um número no formato nacional.

Por que meus dados antigos de clientes têm celulares vietnamitas de onze dígitos?

O Vietnã converteu os celulares de onze dígitos para dez em 2018. Registros capturados antes da mudança podem precisar ser migrados para os prefixos atuais.

As mensagens de verificação vietnamitas terão acentos?

Muitas vezes não, porque muitos remetentes removem os diacríticos dos SMS. Garanta que o parser do código se baseie nos dígitos, e não nas palavras ao redor.

E se um código do Zalo ou da Shopee nunca chegar ao número +84?

Deixe a ativação aberta pelos 20 minutos completos para que ela seja reembolsada automaticamente e tente de novo mais tarde ou use outra rota. Alguns serviços recusam números virtuais, e pedir repetidamente em sequência rápida dificilmente ajuda.

Quantos serviços a rota do Vietnã suporta?

Mais de 2.800 no momento. A lista em tempo real vem de GET /api/v1/services junto com GET /api/v1/prices para o id de país vn.

Um número +84 da OTP Route é aceito por todos os apps?

Não, a aceitação não é garantida, pois cada serviço define sua própria política sobre números virtuais. Você só paga quando um código é entregue.

Quais regras de uso se aplicam aos números vietnamitas?

Verifique apenas seus próprios produtos e contas comerciais, siga os termos de cada serviço e respeite a Política de Uso Aceitável da OTP Route. A criação de contas em massa ou duplicadas não é permitida.

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.