Receber códigos SMS do X (Twitter): um checklist para equipes de produto e QA

Para que o X pede um número de telefone?

O X usa números de telefone em alguns pontos bem conhecidos: como alternativa ao e-mail no cadastro, ao adicionar um número a uma conta existente, em desafios de login acionados por atividade que parece incomum, na redefinição de senha e na autenticação em dois fatores por mensagem de texto. Ao longo dos anos, o X restringiu quais contas podem usar o segundo fator por SMS e oferece aplicativos autenticadores como opção, então confira as configurações atuais da conta que você está testando. Cada um desses fluxos envia um código numérico curto, e cada um vale a pena ser coberto se o seu produto se integra a contas do X ou as administra. Casos típicos são uma ferramenta de redes sociais que faz o onboarding de contas de marcas, uma agência que gerencia perfis de clientes a partir de um login compartilhado da equipe e uma suíte de QA que verifica como o seu próprio app se comporta depois que um usuário vincula um perfil do X.

Checklist pré-voo para testar a verificação por SMS do X (Twitter)

• Titularidade. A conta pertence a você, à sua empresa ou a um cliente que pediu que você a gerenciasse. Uma conta por pessoa ou empresa real.
• Termos. Leia as regras do X sobre números de telefone e automação; elas valem além da nossa Política de Uso Aceitável.
• País. Decida qual mercado a conta representa antes de pedir.
• Id do serviço. Na OTP Route, o id do serviço do X é twitter.
• Infraestrutura. Uma chave Bearer (or_live_) e um laço de consulta periódica ou um endpoint de webhook.
• Vida útil. Essa conta vai precisar entrar de novo daqui a um mês? Se sim, leia a seção sobre linhas dedicadas antes de começar.

De qual dos 198 países deve vir o número?

A rota do X cobre 198 países, incluindo Estados Unidos, Canadá, Reino Unido, Alemanha, França, Índia, Indonésia, Filipinas, Japão, Brasil, México, Turquia, Arábia Saudita, Quênia, Nigéria e Gana. Combine o número com o mercado que a conta atende ou com o caso de teste que você quer provar: uma conta de marca regional deve ter um número da sua região, e um teste de localização precisa do idioma e do formato de número daquele país. Uma divergência entre número, localização do IP e perfil também é o tipo de sinal que pode provocar verificações extras do lado do X.

Passos: pedindo um número para o X pela API

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

1. Consulte o preço do seu par com GET /api/v1/prices?country=<id>&service=twitter, que também confirma a disponibilidade atual.
2. Crie o pedido: POST /api/v1/activations com {"service": "twitter", "country": "<id>"}. Guarde o id da ativação.
3. Digite o número retornado no campo de telefone do X.
4. Pegue o código no evento de webhook ou consulte GET /api/v1/activations/{id} até ele aparecer.
5. Se o X rejeitar o número, libere-o com POST /api/v1/activations/{id}/cancel.

Os ids de país vêm de GET /api/v1/countries; a documentação da API mostra os formatos de requisição e resposta.

Como o receptor de webhook deve ser construído?

Assine activation.sms_received, activation.expired e activation.cancelled. Toda entrega traz X-OTPRoute-Signature: t=<unix>,v1=<hex>; calcule o HMAC-SHA256 do timestamp, um ponto e o corpo bruto com o segredo do endpoint, compare em tempo constante e recuse timestamps antigos. Como as entregas podem se repetir, guarde os ids de ativação já processados e ignore duplicatas. A consulta periódica é um bom plano B para suítes pequenas, bem dentro de 300 requisições por minuto. O guia de HMAC traz um exemplo completo.

Prefere clicar? No painel, abra o OTP Gateway, escolha X e um país, confirme o preço exibido, cole o número no X e veja o código aparecer ao lado do pedido.

Solução de problemas: o X não enviou um código

• O número foi recusado. O X pode recusar números virtuais, às vezes com uma mensagem dizendo que o número não pode ser usado. Cancele e tente de novo mais tarde ou com outro país.
• Ainda não chegou nada. Deixe a janela de 20 minutos aberta em vez de pedir de novo imediatamente.
• O X está limitando. Requisições repetidas de uma mesma conta podem acionar os limites do próprio X; espace as tentativas.
• O seu handler descartou o código. Verifique falhas de assinatura e erros nos seus logs.
• A conta está sinalizada. Se o X restringiu a própria conta, um novo número não muda isso; resolva pelos canais de suporte do X.

A regra de reembolso elimina o custo da falha: você só paga se o código chegar, e ativações expiradas ou canceladas devolvem o valor integral à carteira.

Quando uma linha dedicada dos EUA ou do Canadá é a melhor opção?

Uma ativação de uso único serve para uma única verificação. Uma conta de empresa que precisa passar por desafios de login ou recuperar o acesso daqui a meses precisa de um número que permaneça. Os Números Dedicados oferecem isso nos Estados Unidos e no Canadá, a partir de $1.95/mês: SMS recebidos no painel e no seu webhook via number.sms_received, SMS de saída e chamadas pelo navegador. Compare os dois em números virtuais. A OTP Route cobra tudo de uma única carteira pré-paga, recarregada por cartão ou USDT/USDC, com faturas em PDF.

Perguntas frequentes

Qual é o id de serviço do X (Twitter) na API da OTP Route?

É twitter. Use-o na consulta de preços e no corpo da ativação.

Posso receber um OTP do X sem chip?

Sim, em um número do OTP Gateway em qualquer um dos 198 países, exibido no painel ou enviado ao seu webhook.

Por que o X disse que meu número de telefone não pode ser usado?

O X pode recusar alguns números virtuais. Cancele a ativação para receber o reembolso e tente outro país ou outro horário.

Quanto custa um código de verificação do X?

A partir de $0.20 por código; o preço exato depende do país e é mostrado antes de você pedir.

Posso reutilizar o mesmo número para entrar no X mais tarde?

Uma ativação de uso único recebe um código. Para logins repetidos, use um número dedicado dos EUA ou do Canadá.

Posso usar a OTP Route para criar muitas contas do X?

Não. Ela serve para testar e operar suas próprias contas e produtos legítimos, de acordo com os termos do X.

Existe um sandbox para construir a integração?

Sim. Mediante pedido, uma conta de desenvolvimento pode passar para o sandbox e retornar números e códigos simulados.

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.