Um checklist para receber códigos SMS da Twitch em números da OTP Route

Checklist de pré-voo antes do primeiro pedido para a Twitch

Passe por isto antes de solicitar um número:

• A finalidade é legítima: você está testando a sua própria integração, uma extensão ou operando uma conta de canal que pertence à sua organização.
• Chave de API pronta: uma chave Bearer (prefixo or_live_) do console de desenvolvedor.
• Endpoint de webhook registrado, com o segredo guardado no servidor.
• País escolhido de acordo com o público da conta ou o caso de teste.
• Carteira com saldo, ou sandbox solicitado para um ensaio.
• Necessidade de longo prazo verificada: se a conta precisar ser verificada de novo mais tarde, leia primeiro a última seção.

Onde a Twitch pede um número de telefone?

A Twitch pode usar um número de telefone no cadastro como alternativa ao e-mail, para confirmar a conta, na recuperação de senha e quando a autenticação em dois fatores está ativada. Os canais que transmitem, moderam ou operam extensões costumam ativar o login em duas etapas, o que faz de um número acessível parte do acesso cotidiano, e não de uma etapa única.

Para uma equipe de QA, isso significa dois formatos de teste diferentes. Um teste de cadastro ou de confirmação precisa de um código e termina, que é exatamente o que o OTP Gateway oferece. Um teste de login com verificação em duas etapas precisa de códigos repetidas vezes no mesmo número, o que pede uma linha de longo prazo. Decida qual formato você está testando antes de fazer o pedido, porque isso muda o produto de que você precisa.

De qual país deve vir o número da Twitch?

A Twitch está disponível em rotas de 197 países, incluindo Estados Unidos, Canadá, Reino Unido, Alemanha, Brasil, Japão, México, França, Espanha, Polônia, Coreia do Sul, Turquia, Filipinas e Austrália.

Combine o número com o mercado ao qual a conta pertence. Um teste de localização para um canal brasileiro é mais realista com um número brasileiro, e verificações regionais de risco podem tratar uma incompatibilidade como algo incomum. O guia de roteamento por país explica o porquê.

Passo a passo: um OTP da Twitch pela API

1. Confirme que o id do serviço é twitch com GET /api/v1/services e escolha um id de país em GET /api/v1/countries.
2. Verifique o custo: GET /api/v1/prices?country=<id>&service=twitch.
3. Faça o pedido: POST /api/v1/activations com {"service": "twitch", "country": "<id>"}.
4. Digite o número retornado no campo de telefone da Twitch.
5. Aguarde activation.sms_received ou consulte GET /api/v1/activations/{id}.
6. Envie o código e encerre o seu teste.

A URL base é https://otproute.com/api/v1, com 300 requisições por minuto por conta. Em um job de CI, envolva os passos 3 a 6 em uma única fixture de teste que cancela a ativação no teardown, para que uma execução abortada nunca deixe um pedido pendurado; testes de OTP por SMS em pipelines de CI mostra a abordagem.

Como escrever o handler de webhook?

Cada entrega inclui X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalcule o HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint, compare em tempo constante e recuse timestamps antigos. Torne o handler idempotente usando o id da ativação como chave, para que uma entrega reenviada não envie o mesmo código da Twitch duas vezes. Se o seu endpoint estiver inacessível, consultar a ativação por polling é uma alternativa razoável. Veja a captura de OTP por webhook.

Passos no painel para gestores de comunidade e de canais

Nem todo mundo precisa da API. No painel, abra o OTP Gateway, escolha a Twitch e um país, confira o preço exibido e faça o pedido. Digite o número na Twitch; o código aparece ao lado do pedido assim que for entregue. Isso serve a um gestor de canal que configura uma única conta de marca. Também mantém o número pessoal de um streamer fora de um perfil da empresa, o que importa quando a equipe muda e o acesso precisa ser passado adiante de forma limpa.

Solução de problemas: sem código, número recusado, janela expirada

• Nada chegou: deixe a janela de 20 minutos terminar. A expiração ou o cancelamento reembolsa o valor integral automaticamente.
• A Twitch rejeitou o número: a Twitch pode recusar números virtuais; tente outra rota de país mais tarde.
• Falhas repetidas: faça uma pausa em vez de refazer o pedido em loop acelerado e confirme que você está digitando o número internacional completo.
• Código errado enviado: garanta que o seu handler leia a ativação mais recente, e não uma anterior em cache.
• Bugs de integração: peça o sandbox para reproduzir o fluxo com códigos simulados.

Quando um Número Dedicado dos EUA ou do Canadá serve melhor

Um número do gateway recebe um código e desaparece. Se uma conta da Twitch precisar de códigos de novo, para logins em duas etapas ou recuperação em um login compartilhado da equipe, um Número Dedicado é a ferramenta melhor. Eles são vendidos na hora, apenas para os Estados Unidos e o Canadá, a partir de $1.95/mês, e encaminham os SMS recebidos para o seu webhook.

Seja qual for a escolha, siga os termos da Twitch: uma conta por pessoa real ou empresa. A OTP Route serve para testar e operar os seus próprios produtos e contas legítimos, sob a sua Política de Uso Aceitável.

Perguntas frequentes

Posso receber um OTP da Twitch sem um telefone pessoal?

Sim. Uma equipe pode pedir um número para twitch no OTP Gateway e ler o código no painel, mantendo os celulares dos colaboradores fora das contas de marca.

Quanto custa um código da Twitch?

A partir de $0.20 por código, dependendo do país. O preço atual vem de GET /api/v1/prices antes de você fazer o pedido.

Por que a Twitch não enviou um código para o meu número?

A entrega depende da rota, e a Twitch pode rejeitar alguns números virtuais. Espere a janela terminar para receber o reembolso automático e depois tente mais tarde ou em outro país.

Um número virtual para a Twitch serve para login com autenticação em dois fatores?

Somente uma linha de longo prazo faz sentido nesse caso. Use um Número Dedicado dos EUA ou do Canadá, já que os números do gateway recebem um único código.

Posso fazer a verificação por SMS da Twitch para testes em CI?

Sim. Dispare os pedidos a partir do seu pipeline pela API e consuma o webhook; o sandbox evita gastar saldo da carteira durante o desenvolvimento.

A OTP Route tem ligação com a Twitch?

Não. Twitch é marca registrada de seu titular, e a OTP Route não tem afiliação com ela.

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.