Como as equipes recebem códigos SMS do WeChat para testes e operações

Por que a verificação do WeChat é diferente de outros aplicativos de mensagens?

O WeChat é muito mais do que um aplicativo de chat. Para muitos usuários, também é uma carteira, uma vitrine por meio dos Mini Programs e o principal canal para falar com empresas na China. Por isso as verificações de conta dele são mais rigorosas que a maioria, e por isso um número de telefone do WeChat pesa mais do que um simples identificador de login.

O aplicativo usa códigos por SMS em vários pontos:

• Registro, em que o número se torna o identificador principal da conta.
• Login em um novo dispositivo, muitas vezes combinado com outras verificações.
• Alteração ou recuperação do número vinculado.
• Revisões de segurança, que podem pedir mais do que um SMS: o WeChat pode exigir a confirmação de um usuário existente ou outras etapas de identidade. Nenhum número, de nenhum provedor, substitui essas etapas.

Para uma equipe que cria um Mini Program do WeChat, uma integração de conta oficial ou uma central de suporte transfronteiriça, isso significa planejar as contas de teste com cuidado em vez de criá-las na hora.

Quais países podem entregar um código SMS do WeChat?

As rotas do WeChat estão listadas atualmente em 198 países. Entre os exemplos estão China, Hong Kong, Singapura, Malásia, Estados Unidos, Canadá, Taiwan, Macau, Tailândia, Vietnã, Indonésia, Filipinas, Austrália, Reino Unido, Alemanha e Bangladesh.

Escolha o país conforme o caso que você está testando, e não a rota mais barata. Uma central de suporte que atende turistas chineses na Europa deve testar com números europeus; um Mini Program voltado à comunidade chinesa da Malásia deve testar com números malaios. O WeChat pode tratar contas de regiões diferentes de maneiras diferentes, e o seu teste deve refletir o que os usuários reais veem. Os preços variam por país e são retornados em tempo real.

Como funciona o fluxo da API de código de verificação do WeChat?

As chamadas vão para https://otproute.com/api/v1 com uma chave Bearer or_live_ criada no console do desenvolvedor (até 10 chaves, 300 requisições por minuto).

1. Confirme o id de serviço wechat por GET /api/v1/services e o id do país por GET /api/v1/countries.
2. Leia o preço atual: GET /api/v1/prices?country=<id>&service=wechat.
3. Crie o pedido com POST /api/v1/activations e {"service": "wechat", "country": "<id>"}. Guarde o id da ativação retornado.
4. Informe o número no WeChat e peça o SMS.
5. Colete o código pelo webhook activation.sms_received ou consulte GET /api/v1/activations/{id} a cada poucos segundos.
6. Se o teste parar antes, chame POST /api/v1/activations/{id}/cancel.

A referência completa está na documentação.

O que um handler de webhook para códigos do WeChat deve fazer?

Registre até 5 endpoints por conta. Cada requisição traz X-OTPRoute-Signature: t=<unix>,v1=<hex>. Reconstrua a assinatura como o HMAC-SHA256 de <t>.<raw body> com o segredo daquele endpoint, compare em tempo constante e recuse timestamps com mais de alguns minutos.

Torne o handler idempotente: grave o código usando o id da ativação como chave, para que uma entrega repetida não faça nada de novo. Escute também activation.expired e activation.cancelled, para que as execuções de teste terminem de forma limpa em vez de ficarem penduradas. Nosso guia sobre como proteger webhooks de OTP mostra a verificação passo a passo. A consulta periódica é uma boa alternativa para um único teste manual; os webhooks escalam melhor quando muitos jobs rodam em paralelo.

Posso fazer isso pelo painel?

Sim. No painel da OTP Route, abra o OTP Gateway, escolha o WeChat e um país, confira o preço exibido e confirme. Cole o número no WeChat, peça o código e acompanhe a página do pedido; o SMS aparece ali assim que for entregue. Isso serve à equipe de operações que configura uma conta empresarial uma vez e nunca toca na API.

Por que um código do WeChat pode não chegar?

Cada ativação dura 20 minutos e atende um código. Você só paga se o código chegar; se a janela se fechar vazia ou você cancelar, o dinheiro volta automaticamente para a sua carteira.

Motivos comuns para o silêncio:

• O WeChat pode recusar números virtuais ou pedir uma verificação extra que o SMS sozinho não satisfaz.
• A rota escolhida está ocupada; tente mais tarde ou teste outro país que combine com o seu caso.
• O pedido nunca foi enviado, muitas vezes porque o aplicativo mostrou antes um captcha ou um aviso de segurança.

Deixe a janela correr antes de refazer o pedido e nunca tente de novo em um loop apertado. Há mais dicas em como reduzir entregas de OTP com falha.

Quando um Número Dedicado é melhor que um código de uso único?

Um número temporário recebe um código. Se uma conta de staging do WeChat precisar entrar de novo no mês seguinte, ou se uma equipe de suporte compartilhar um login empresarial, o número precisa continuar com você. Os Números Dedicados fazem isso: estão disponíveis nos Estados Unidos e no Canadá, a partir de $1.95/mês, com SMS recebidos no painel e no seu webhook via number.sms_received. Os outros países não têm opção de longo prazo de autoatendimento; escreva para [email protected] para perguntar.

Use toda conta do WeChat de acordo com os termos do WeChat: uma conta por pessoa ou empresa real, criada para os seus próprios produtos legítimos. WeChat é marca registrada de seu titular e a OTP Route não é afiliada a ele; a nossa Política de Uso Aceitável se aplica.

Perguntas frequentes

Posso usar um número virtual para testar o cadastro no WeChat?

Muitas vezes, mas nem sempre. O WeChat pode recusar alguns números virtuais ou exigir verificações extras; quando nenhum código chega, a ativação é reembolsada.

Qual é o id de serviço do WeChat na API?

É wechat. Use-o na chamada de preços e no corpo da requisição de ativação.

Por que o WeChat pede que um usuário existente confirme minha conta nova?

Essa é uma etapa de segurança do WeChat, separada do SMS. Um número de telefone não consegue concluí-la sozinho.

Quantos países aceitam a verificação por SMS do WeChat para testes?

Atualmente 198 países listam rotas do WeChat. Confira a lista atual antes de pedir, pois a disponibilidade muda ao longo do dia.

Quanto custa receber um OTP do WeChat?

Os códigos começam em $0.20 por código; o preço exato depende do país e é exibido antes de você pedir. Você paga somente se o código chegar.

Posso manter o mesmo número do WeChat para logins futuros?

Sim, com um Número Dedicado dos EUA ou do Canadá a partir de $1.95/mês. As ativações temporárias atendem apenas um código.

Posso testar a minha integração com o WeChat sem gastar dinheiro?

Peça ao suporte para colocar uma conta de desenvolvimento em modo sandbox, que retorna números e códigos simulados para testes de ponta a ponta.

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.