Verificar token do bot do Telegram e descobrir o chat ID

O token do bot e o chat ID são os dois valores que toda integração com o Telegram pede: o token diz qual bot está falando, e o chat ID diz onde. Esta página verifica o primeiro e encontra o segundo perguntando ao próprio Telegram — do seu navegador, sem nada no meio.

Chat ID sem token

O campo no topo responde à pergunta mais comum — o ID de um canal ou de um grupo — sem precisar de um bot seu. Para um chat público, cole o @usuário ou o link t.me dele: o servidor do AdminHub pergunta ao Telegram com o getChat, o método que a Bot API documenta para «o nome de usuário do supergrupo ou canal de destino», e mostra o ID junto com o título do chat, para você ver que é o chat certo. Para um canal ou supergrupo privado, cole o link de qualquer post dele: um link t.me/c/ traz o número interno do chat, e o ID da Bot API é montado a partir dele no seu próprio navegador — menos a soma de 1.000.000.000.000 com esse número.

Algumas coisas a página não procura. Um nome de usuário que pertence a uma pessoa ou a um bot recebe resposta sem ID: transformar o nome de usuário público de alguém no ID permanente dessa pessoa não é papel de uma página, e o bot de que falamos mais abaixo só faz isso quando você mesmo escolhe a pessoa. Um link de convite (t.me/+…) não traz ID nenhum. Para tudo isso, o @getid_adminhub_bot lê a sua própria lista de chats pelo seletor de chats do Telegram. Os nomes de usuário que você procura não ficam guardados além de um cache curto.

O que é um token de bot

Um token de bot é a chave de um bot. O @BotFather o entrega quando você cria um bot com /newbot, e ele tem esta cara: 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw — dígitos, dois-pontos e depois uma sequência longa de letras, dígitos, hífens e sublinhados. Toda requisição à Bot API o leva no endereço, depois da palavra bot: https://api.telegram.org/bot<token>/getMe. A documentação do Telegram é direta sobre o que decorre disso: o token autentica o bot, não a sua conta, qualquer pessoa que o tenha pode controlar o bot, e ele deve ser tratado como uma senha. Ele pode ser revogado a qualquer momento no @BotFather; se vazou ou se perdeu, o comando /token lá gera um novo, e o Mini App do @BotFather faz o mesmo com botões.

O primeiro passo desta página é o getMe, o método que a Bot API reserva exatamente para isso: testar um token. Quando o token funciona, o Telegram responde com o bot a que ele pertence: nome, nome de usuário, ID e duas configurações que vale conhecer antes de seguir — se o bot pode ou não ser adicionado a grupos e se o modo de privacidade (privacy mode) está ativado. Quando o token tem erro de digitação ou foi substituído, o Telegram o recusa, e a página diz isso com todas as letras.

De onde vêm os chat IDs

A Bot API não tem um método que liste os chats de um bot. Um bot só fica sabendo o ID de um chat quando algo desse chat chega até ele como atualização — uma mensagem, um post, o bot sendo adicionado ou removido —, e o getUpdates é o método que entrega essas atualizações. O Telegram as guarda por 24 horas, então o chat de que você precisa tem que ter feito algo recentemente. O quê, depende do chat:

Para pegar o ID de	Faça isto	Ele aparece como
Você mesmo	Envie /start ao bot	Um chat privado, número positivo
Um grupo	Adicione o bot ao grupo	Um grupo ou supergrupo, número negativo
Um canal	Torne o bot admin, ou encaminhe um post do canal para o bot	Um canal, começando com -100
Outra pessoa	Encaminhe uma das mensagens dela para o bot	Um chat privado, a menos que as configurações de privacidade dela a escondam

Adicionar o bot a um grupo basta por si só: o bot é avisado sobre a própria participação, e as regras do modo de privacidade do Telegram deixam todo bot ver as mensagens de serviço e as mensagens dos canais de que ele faz parte, qualquer que seja a configuração. O que o modo de privacidade esconde de fato é a conversa comum nos grupos — com ele ativado, um bot recebe os comandos destinados a ele, as respostas às próprias mensagens e as mensagens de serviço, então um simples «oi» num grupo pode nunca chegar. Um comando endereçado ao bot pelo nome, como /start@your_bot_name, sempre chega. Encaminhar funciona para canais em que o bot não está, porque um post encaminhado traz o canal de onde veio; uma pessoa que restringe o encaminhamento das próprias mensagens chega como remetente desconhecido, sem ID para mostrar.

Ainda não tem um bot seu, ou o seu bot não está no chat de que você precisa? O @getid_adminhub_bot responde com o ID de qualquer pessoa, bot, grupo ou canal que você escolher na sua própria lista de chats, pelo seletor de chats do Telegram — sem token, sem encaminhar nada, canais privados incluídos. Ele não entra em nenhum dos chats que você escolhe e não guarda os IDs deles, e como um chat tem o mesmo ID para todo bot, o número que ele dá serve também para o seu bot.

O que os números significam

Chat IDs não são arbitrários. A referência do Telegram sobre IDs de diálogo da Bot API coloca pessoas, grupos e canais numa única reta numérica, de modo que o sinal e o tamanho de um número dizem que tipo de chat ele é: o ID de uma pessoa é positivo e também é o ID do chat privado dela com qualquer bot; o ID de um grupo básico é o ID interno dele com sinal de menos; o ID de um supergrupo ou canal é menos a soma de 1.000.000.000.000 com o ID interno dele. Com IDs internos do tamanho atual, essa última regra é o motivo de IDs de canal aparecerem como -100 seguido de mais dígitos — e de o gerador de links remover exatamente esse -100 ao montar um link t.me/c/ para um post de um canal privado. Copie o número completo, com o sinal de menos: é isso que o chat_id espera. A mesma referência observa que um ID pode ter mais de 32 bits, mas nunca mais de 52, então um inteiro de 64 bits o armazena com segurança.

Um chat também pode mudar de ID uma vez. Quando um grupo básico é convertido em supergrupo, ele ganha um ID novo, com -100, e o antigo deixa de ser o endereço certo: o Telegram responde a uma requisição para ele com um erro que informa o ID novo. Se o bot viu o momento da conversão, esta página mostra o ID novo ao lado do antigo.

Quando as atualizações não podem ser lidas

Existem duas formas de um bot receber atualizações, e a documentação do Telegram diz que elas são mutuamente exclusivas: o getUpdates, que esta página usa, ou um webhook, em que o Telegram envia cada atualização para um servidor. Se o bot tem um webhook, o getUpdates é recusado, e esta página avisa isso em vez de remover o webhook — apagá-lo desligaria o seu servidor do próprio bot. Há duas saídas: ler o chat.id nas atualizações que o seu servidor já recebe, ou adicionar um segundo bot, de reserva, ao mesmo chat e verificar o token dele aqui, já que um chat tem o mesmo ID para todo bot.

Um bot que já está em execução com getUpdates — um script ou um framework consultando as atualizações — pega cada atualização assim que ela chega e a confirma, então não sobra nada para esta página ler, e a lista continua vazia por mais que você verifique. Pare o bot por um minuto, faça o passo que faz o chat aparecer, verifique aqui e depois inicie o bot de novo: as atualizações que a página viu continuam esperando por ele, porque esta página nunca tira atualizações da fila do bot. Parar o bot antes importa por mais um motivo. Quando duas requisições getUpdates do mesmo bot se sobrepõem, o Telegram pode responder a uma delas com um erro Conflict, e alguns frameworks de bots param de consultar as atualizações quando recebem esse erro; se o erro cair nesta página, ela avisa.

O que a página envia, e para quem

A parte da página que usa o token chama dois métodos, getMe e getUpdates, e os dois só leem. Ela chama o getUpdates sem parâmetro nenhum, de propósito: um offset confirmaria as atualizações, o que as tira da fila que o seu bot lê, e uma lista de atualizações permitidas seria salva pelo Telegram como configuração do próprio bot. Ela nunca configura nem remove um webhook e nunca envia uma mensagem. As requisições vão do seu navegador para api.telegram.org e para nenhum outro lugar — a aba Rede (Network) das ferramentas de desenvolvedor do seu navegador mostra isso —, então o servidor do AdminHub nunca recebe o token. A página mantém o token só na aba aberta, nunca no armazenamento do navegador, e o campo e os resultados ficam excluídos do analytics do site e das gravações de sessão. Se você prefere fazer à mão, abra https://api.telegram.org/bot<token>/getUpdates num navegador com o seu token no lugar de <token>: é a mesma requisição, respondida em JSON puro, com o ID de cada chat em “chat” e “id”. A busca por nome de usuário no topo é a única parte que passa pelo servidor do AdminHub — e o que passa é o nome de usuário, nunca um token.

Se o token e o chat ID são para um agente de IA que deve postar no seu canal, dá para nem entregar um token ao agente: o servidor MCP do AdminHub conecta o Claude, o ChatGPT ou o Cursor ao canal, e os posts saem pelo seu próprio bot.

---

Fontes, verificadas em outubro de 2026: Telegram Bot API — Authorizing your bot para o formato do token e o endereço da requisição, getMe, getUpdates para a página de 100 atualizações, a confirmação por offset e a configuração allowed_updates que fica salva, Getting updates para a retenção de 24 horas e as duas formas mutuamente exclusivas, Update e ChatMemberUpdated para as mudanças na participação do próprio bot, MessageOrigin para mensagens encaminhadas, ResponseParameters para migrate_to_chat_id; Bot features para o modo de privacidade e para criar um bot e gerar um token novo no @BotFather; Bot API dialog IDs para as faixas de ID de pessoas, grupos, supergrupos e canais; Bot tutorial para revogar um token e tratá-lo como uma senha; Bots FAQ para o getUpdates não funcionar enquanto houver um webhook configurado.