Um checklist pré-voo para receber códigos de login do Telegram em um número de teste

O que deve estar pronto antes de pedir um número do Telegram?

Percorra esta lista primeiro; a maioria dos testes falhos do Telegram vem de um desses itens.

• Uma finalidade clara. Você está testando um bot, um Mini App, um widget de login ou um fluxo de suporte operado pela sua própria equipe, e precisa de uma conta nova do Telegram que não esteja ligada ao celular pessoal de nenhum funcionário.
• Um país de destino. Defina a qual mercado a conta deve parecer pertencer. Os idiomas padrão e algumas telas de onboarding seguem o país do número.
• Saldo na carteira ou sandbox. Uma carteira pré-paga com saldo, ou uma conta de desenvolvimento colocada em sandbox pelo suporte para ensaios.
• Uma chave de API, se for automatizar. Crie uma com o prefixo or_live_ no console do desenvolvedor.
• Um aparelho ou emulador limpo. O Telegram entrega códigos dentro do app para qualquer sessão já conectada, então um aparelho sem sessão existente deixa o caminho do SMS previsível.
• Tempo. Cada ativação fica aberta por 20 minutos; só inicie uma quando o testador estiver pronto para digitar o número.

Quando o Telegram realmente envia um código por SMS?

O Telegram identifica cada conta pelo número de telefone. Ele pede um código quando alguém registra uma conta nova e quando uma conta existente entra em um aparelho novo. Se essa conta já estiver ativa em outro lugar, o Telegram normalmente envia o código de login como mensagem na sessão existente, e não por SMS, e é por isso que um número novinho em um aparelho limpo é a forma mais limpa de testar a etapa do SMS. Ele também pode oferecer uma ligação ou um reenvio depois de uma curta espera.

A verificação em duas etapas do Telegram é uma senha de nuvem separada, definida dentro do app. Ela não é um fator por SMS, então guarde essa senha no gerenciador de segredos da sua equipe se a ativar em uma conta de teste.

Quais países posso escolher para o Telegram, e por que isso importa?

O serviço telegram está listado hoje em 199 países, entre eles Índia, Alemanha, Brasil, Nigéria, Indonésia, Reino Unido, Ucrânia, Cazaquistão, Uzbequistão, Turquia, Espanha, México, Filipinas, Vietnã e Egito.

Combine o país com o caso de teste. Um bot que responde em português deve ser testado a partir de uma conta brasileira; uma equipe de suporte que cobre a Ásia Central pode querer um número do Cazaquistão. O Telegram também pode tratar números de alguns países com mais cautela do que de outros, então, se uma rota continuar falhando, um mercado vizinho é uma alternativa razoável. A disponibilidade ao vivo muda ao longo do dia, por isso leia-a na API em vez de usar uma lista salva.

Como automatizo o código do Telegram com a API?

1. Se quiser, confirme o custo com GET /api/v1/prices?country=<id>&service=telegram.
2. Crie o pedido: POST /api/v1/activations com {"service": "telegram", "country": "<id>"}, em que o id do país vem de GET /api/v1/countries (por exemplo br ou de).
3. Passe o número retornado ao seu executor de testes, que o digita no cliente ou emulador do Telegram.
4. Aguarde o código. Com webhook, escute activation.sms_received; caso contrário, consulte GET /api/v1/activations/{id} em um intervalo razoável.
5. Faça a limpeza com POST /api/v1/activations/{id}/cancel se a execução for interrompida.

Nos webhooks, verifique X-OTPRoute-Signature recalculando o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, rejeite timestamps antigos e registre cada id de ativação já processado para que um evento reenviado seja ignorado. Cada conta tem até 5 endpoints de webhook e 300 requisições por minuto. O guia de pipelines de CI trata de execuções em paralelo.

Posso seguir os mesmos passos manualmente no painel?

Sim. Entre na conta, abra o OTP Gateway, escolha Telegram e o país, confira o preço e faça o pedido. Copie o número para a tela de telefone do Telegram, selecione o código de país correspondente e peça o código. Quando o SMS chegar, ele aparece ao lado do pedido, pronto para colar.

O código do Telegram não chegou. O que há na lista de solução de problemas?

• Já existe uma sessão ativa? Se o número foi usado antes, o Telegram pode ter enviado o código dentro do app. Uma ativação nova evita isso.
• A janela terminou? Deixe o cronômetro de 20 minutos correr. Você só paga se o código chegar; a expiração ou o cancelamento devolve o valor integral automaticamente.
• A rota é aceita? O Telegram pode recusar alguns números virtuais. Isso foge do nosso controle e é exatamente por isso que existe a regra de reembolso.
• Tente de novo com intervalo. Peça outro número mais tarde ou em outro país; não refaça o pedido em laço rápido, o que não ajuda nem a entrega nem o seu limite de requisições.
• Confira o código do país no aparelho. Uma divergência entre o país selecionado e o número é um erro fácil em testes manuais.

Quando um Número Dedicado é melhor para o Telegram?

Um número avulso do OTP Gateway serve para testes de cadastro. Se a conta do Telegram precisar entrar de novo no mês que vem, por exemplo uma conta de equipe que administra um canal de suporte ou o login de administrador de um bot, ela precisa de um número que a sua equipe ainda controle. Os Números Dedicados nos Estados Unidos e no Canadá, a partir de $1.95/mês, continuam sendo seus enquanto renovam e encaminham os SMS recebidos ao painel e ao seu webhook como number.sms_received. A comparação entre números temporários e dedicados explica as vantagens e desvantagens.

Como é um teste responsável no Telegram?

Siga os termos de serviço do Telegram. Crie uma conta por pessoa real ou finalidade comercial, use-a para os seus próprios produtos, bots e operações, e nunca para spam, criação em massa de contas ou para contornar um banimento. Todo pedido do Telegram que você faz também está coberto pela Política de Uso Aceitável da OTP Route. Telegram é marca registrada de seu titular, e a OTP Route não tem afiliação com ele.

Perguntas frequentes

Consigo um código de verificação do Telegram sem usar meu celular pessoal?

Sim. Peça um número do Telegram no OTP Gateway da OTP Route, digite-o no app e leia o código SMS no painel ou pela API.

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

É telegram. Combine-o com um id de país de GET /api/v1/countries ao criar uma ativação.

Quanto custa a verificação por SMS do Telegram para testes?

A partir de $0.20 por código; o preço exato depende do país e é retornado ao vivo pelo endpoint de preços.

Por que o Telegram enviou o código dentro do app em vez de por SMS?

O Telegram entrega os códigos de login a uma sessão existente quando há uma. Use um número novo e um aparelho sem sessão conectada para testar o caminho do SMS.

Posso reutilizar um número de uso único para entrar de novo no Telegram mais tarde?

Não, os números do OTP Gateway servem para um único código. Para logins repetidos, use um Número Dedicado nos EUA ou no Canadá.

Sou cobrado se o Telegram rejeitar o número?

Não. Se nenhum código chegar ao número em 20 minutos, ou se você cancelar, o valor integral volta para a sua carteira.

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.