Skip to content
Técnico
6 min de leitura6 de novembro de 2026

Como funciona a verificação de telefone no Telegram

Um bot do Telegram nunca vê o número do remetente, então verificar por lá funciona de outro jeito que no WhatsApp. Veja o fluxo, as checagens por trás dele e o que chega à sua aplicação.

À esquerda: uma conversa com um bot, com uma mensagem e um botão azul para compartilhar um número de telefone. Uma seta aponta para a direita, para um escudo branco com um visto azul sobre fundo azul, indicando que o número compartilhado foi verificado

O WhatsApp foi o primeiro canal da Phone-Verif, mas nem todo mundo vive nele. O Telegram agora é um segundo canal: mesma API, mesmo resultado e ativo por padrão. A mecânica por baixo é outra, e vale entendê-la antes de oferecê-lo.

No WhatsApp, a prova é uma mensagem que a pessoa envia: ela chega do número dela, que é a ideia por trás do Reverse OTP. Um bot do Telegram não tem esse sinal. Ele identifica as pessoas por um ID numérico de conta, e o número continua privado a menos que elas decidam compartilhá-lo. Por isso o bot precisa pedir, e a prova tem de vir de algo além do remetente.

O que a pessoa faz

Não há código para ler nem digitar. O fluxo inteiro são dois toques dentro do Telegram.

1. Abrir o link

Sua página mostra um QR code ou um botão. Ambos levam ao nosso bot com o token da sessão no link.

2. Tocar em Iniciar

Tocar em Iniciar entrega o token ao bot, que vincula esta conta do Telegram à sessão.

3. Compartilhar o número

O bot mostra um único botão para compartilhar o número. O toque envia o cartão de contato da própria conta no Telegram.

4. Pronto

O bot confirma, a sessão fica verificada e sua aplicação recebe o webhook e o status.

Por que um contato compartilhado vale como prova

Qualquer um pode enviar dígitos a um bot, então números digitados são recusados de cara: o bot mostra o botão de novo. Só um cartão de contato é lido, e ele precisa passar por quatro checagens antes de a sessão ser concluída.

É o próprio contato

O ID de usuário no cartão coincide com a conta que o enviou. O cartão de outra pessoa falha aqui.

Vem da conta certa

O remetente é a conta que tocou em Iniciar nesta sessão, então um cartão não conclui a sessão de outra pessoa.

Não foi encaminhado

Um cartão encaminhado de outra conversa é recusado, mesmo que seja do próprio remetente.

É recente

O cartão foi enviado depois da abertura da sessão, então um antigo não pode ser reaproveitado.

Um cartão que falha em qualquer checagem não muda nada: o bot pede de novo e a sessão continua aberta. Um número bloqueado é recusado no Telegram como no WhatsApp.

Cada sessão termina uma só vez

Um toque duplo no botão envia dois cartões, e uma nova tentativa de entrega pode enviar o mesmo duas vezes. Por isso a conclusão da sessão é reservada de forma atômica: um cartão vence, com um resultado, um webhook e um crédito gasto.

Uma sessão também só pode terminar em um canal. Por padrão, ela fica aberta ao WhatsApp, ao SMS e ao bot, e assim que um deles a conclui, os outros recusam o token. Uma sessão travada no Telegram ou no WhatsApp recusa o outro canal desde o início. O link do bot redireciona igual para qualquer token, então não serve para descobrir quais estão ativos.

Um número, uma identidade

Telegram e WhatsApp escrevem números de formas diferentes, então o número é normalizado para o mesmo formato antes de tudo. Isso importa porque as identidades se baseiam nele.

Quem se verifica hoje no WhatsApp e amanhã no Telegram recebe o mesmo user_id. É um usuário só, não dois, e flow=login informa is_new_user de acordo.

Nós mesmos dependemos disso. Telegram Connect e WhatsApp Connect, na nossa página de login, levam à mesma conta para o mesmo número, seja qual for o usado primeiro.

O que você recebe

Sua integração lê a mesma resposta de status e recebe o mesmo webhook do WhatsApp, e uma verificação gasta os mesmos créditos. Os fluxos phone, login e 2fa funcionam todos.

Só uma coisa é adicionada. Em flow=phone, uma sessão do Telegram verificada também traz um objeto telegram com user_id, username, first_name e last_name. Login e 2FA o omitem: respondem com um ID de usuário ou uma correspondência, e um nome de usuário identificaria a pessoa tanto quanto um número.

O que isso não prova

Uma sessão verificada mostra que esta conta do Telegram possui este número. Não diz nada sobre quem está com o chip hoje, um limite comum a todo canal baseado em conta, como explica o artigo sobre SIM swap.

A checagem de propriedade também depende do ID de usuário que o Telegram informa no cartão de contato. A documentação da Bot API não descreve como esse campo é preenchido, então aqui você confia na plataforma, como faz com o número do remetente no WhatsApp.

Há limites práticos também. A pessoa precisa ter o Telegram, e uma sessão travada no Telegram não tem alternativa por SMS.

Como adicionar

As sessões ficam abertas ao Telegram por padrão, então não há parâmetro a adicionar. Envie provider=telegram para travar uma sessão no bot, ou provider=whatsapp para deixar o bot de fora.

curl -X POST "https://api.phone-verif.com/start-verification" \
  -H "X-API-Key: $PHONE_VERIF_API_KEY"

A resposta traz um bloco telegram ao lado de whatsapp e sms, a menos que o Telegram esteja indisponível. Codifique qr_code_url no seu QR code e use direct_link para um botão no celular.

{
  "whatsapp": { "...": "..." },
  "sms": { "...": "..." },
  "telegram": {
    "qr_code_url": "https://t.phone-verif.com/tg/<token>",
    "direct_link": "https://t.me/PhoneVerif_com_bot?start=<token>"
  }
}

Você pode testar sem conta na demo do Telegram. O guia de integração cobre toda a API.