Como descobrir o chat ID do Telegram: usuário, grupo, canal
Seu ID, o de outra pessoa, de um grupo ou de um canal — público ou privado — e de um tópico: o jeito mais rápido para cada um, o que é -100 e quando o ID muda.
Conecte um agente hoje
Conectar um agente no botResumo. O seu ID: aperte Iniciar no @getid_adminhub_bot. Uma pessoa ou um bot: escolha pelo botão Pessoa ou Bot do mesmo bot. Um canal ou grupo público: cole o @usuário no buscador de chat ID. Um privado: cole o link de qualquer post dele (
t.me/c/…) — o ID é montado a partir do link. Um tópico:/id@getid_adminhub_botdentro dele. IDs de canais e supergrupos começam com -100; copie com o sinal de menos.
O chat ID é o número que a Bot API usa para dizer para onde vai uma mensagem. Toda integração que posta no Telegram — um script, uma automação, um agente de IA — pede esse número ao lado do token do bot. O problema é que os apps comuns do Telegram não mostram esse número, então este guia passa por cada tipo de chat e pelo jeito mais rápido de conseguir o número dele.
O jeito mais rápido para cada tipo de chat
| De quem é o ID | Jeito mais rápido | Também funciona |
|---|---|---|
| Seu | Aperte Iniciar no @getid_adminhub_bot | Mande uma mensagem para o seu próprio bot e depois leia as atualizações dele no verificador de token |
| De outra pessoa | O botão Pessoa do bot — escolha a pessoa entre os seus chats | Encaminhe ao bot uma mensagem dela — a menos que ela oculte a conta nas mensagens encaminhadas |
| De um bot | O botão Bot do bot | Se o bot for seu: cole o token dele no verificador de token |
| De um canal ou grupo público | Cole o @usuário ou o link t.me no buscador de chat ID | O botão Canal / Grupo do bot |
| De um canal ou supergrupo privado | Cole no buscador o link de qualquer post dele (t.me/c/…) | O botão Canal / Grupo do bot (Meu canal / Meu grupo mostram só os que você criou) |
| De um tópico num grupo com tópicos | Envie /id@getid_adminhub_bot no tópico, com o bot no grupo | Leia o message_thread_id nas atualizações do seu bot |
| Dos chats que escreveram para o seu bot nas últimas 24 horas | Cole o token do bot no verificador de token — com o bot parado e sem webhook configurado | — |
Por que a linha da pessoa passa pelo próprio Telegram: o ID de uma pessoa não é público na web. A Bot API documenta a busca por nome de usuário para canais, supergrupos e bots, não para pessoas, e um bot fica sabendo o ID de uma pessoa pelo que chega até ele — por exemplo, quando ela escreve para ele, ou quando alguém a escolhe num seletor de chats ou encaminha uma mensagem dela (a menos que ela oculte a conta nas mensagens encaminhadas). Os botões de seleção do @getid_adminhub_bot funcionam assim: você escolhe na sua própria lista de chats, o bot responde com o ID e não entra em nenhum dos chats que você escolhe.
O que os números significam
A referência do Telegram sobre IDs de diálogo da Bot API coloca todos os chats numa única reta numérica, então o sinal e o tamanho do número dizem que tipo de chat ele é:
- Uma pessoa (e o chat privado com ela): um número positivo, por exemplo
987654321. - Um grupo básico: o ID interno com sinal de menos,
-4123456789. - Um supergrupo ou canal: menos a soma de 1.000.000.000.000 com o ID interno. Com IDs internos do tamanho atual, isso aparece como -100 seguido do número interno:
-1001234567890.
O número de um link privado de post, t.me/c/1234567890/45, é o interno; o chat ID é montado a partir dele, que é exatamente o que o buscador de chat ID faz quando você cola um link desses — e o que o gerador de links desfaz quando monta um link t.me/c/ a partir de um ID. Um ID pode ter mais de 32 bits, mas nunca mais de 52, então guarde-o como inteiro de 64 bits, não de 32.
Talvez você nem precise do número
Para um canal público, um supergrupo com nome de usuário ou um bot, o chat_id da Bot API aceita o próprio nome de usuário: @yourchannel funciona em qualquer lugar onde o número funciona. O número é necessário para tudo o que não tem nome de usuário — um chat privado com uma pessoa, um canal privado, um grupo básico — e, de qualquer forma, é a escolha mais segura: um nome de usuário pode ser trocado ou liberado; o ID, não.
Quando um chat ID muda
Uma vez. Quando um grupo básico é convertido em supergrupo, ele ganha um ID novo, que começa com -100, e o antigo deixa de ser o endereço certo. O Telegram responde a uma requisição para o ID antigo com um erro que traz o novo em migrate_to_chat_id, então um script bem-feito consegue trocar sozinho. Se o seu bot estava no grupo nesse momento, o verificador de token mostra o ID novo ao lado do antigo.
Nomes de usuário mudam; IDs, não. Um canal que muda de nome ou de @usuário continua com o mesmo chat ID.
Erros comuns
- Perder o sinal de menos.
1001234567890não é o mesmo chat que-1001234567890. Copie o número inteiro. - Usar o número de um link
t.me/c/do jeito que está. Esse é o ID interno; o chat ID é -100 seguido dele (ou, com precisão, menos a soma acima). - Continuar com o ID antigo de um grupo depois que ele virou supergrupo.
- Postar num canal em que o bot não é admin. O ID pode estar certo e a requisição ser recusada mesmo assim: para postar num canal, o bot precisa ser um dos administradores dele.
- Confundir o ID do bot com o chat ID. O ID do seu próprio bot — o que o getMe retorna — é de onde as mensagens saem, não para onde vão.
Se você está configurando um bot do zero, o guia do token do bot cobre o outro valor que toda integração pede.
Fontes, verificadas em outubro de 2026: Bot API dialog IDs — as faixas de ID de pessoas, grupos, supergrupos e canais; Telegram Bot API — sendMessage (chat_id como número ou @username, message_thread_id), getChat (nomes de usuário de supergrupos e canais), KeyboardButtonRequestUsers e KeyboardButtonRequestChat (os seletores de chats), MessageOrigin (mensagens encaminhadas), ResponseParameters (migrate_to_chat_id); links t.me e tg:// — links privados de posts.
O que as pessoas costumam perguntar
- Como descubro o meu próprio ID de usuário no Telegram?
- Abra o @getid_adminhub_bot no Telegram e aperte Iniciar: ele responde na hora com o seu ID. Qualquer bot vê esse mesmo número quando você manda mensagem para ele, porque o ID de um chat privado com uma pessoa é o ID de usuário dessa pessoa.
- Como pego o chat ID de um canal do Telegram?
- Para um canal público, cole o @usuário ou o link t.me dele no buscador de chat ID do AdminHub, e o ID volta na hora. Para um canal privado, cole o link de qualquer post dele (t.me/c/…), e o ID é calculado a partir do próprio link. Ou abra o @getid_adminhub_bot e escolha o canal pelo botão Canal — Meu canal lista só os canais que você criou. O ID de um canal começa com -100.
- Por que o chat ID começa com -100?
- Porque o chat é um supergrupo ou um canal. A Bot API deixa os IDs deles negativos e soma 1.000.000.000.000 ao ID interno, então, com IDs internos do tamanho atual, o número aparece como -100 seguido do ID interno. Copie o número inteiro, com o sinal de menos.
- Dá para usar o @usuário em vez do chat ID?
- Para um canal público, um supergrupo ou um bot, sim: o chat_id da Bot API aceita o nome de usuário no formato @username. Um chat privado, um canal privado e um grupo básico não têm nome de usuário, então precisam do ID numérico.
- Como descubro o ID de um tópico num grupo?
- Adicione o @getid_adminhub_bot ao grupo e envie /id@getid_adminhub_bot dentro do tópico: ele responde com o ID do grupo e o message_thread_id do tópico. Esse segundo número é o que você passa como message_thread_id para postar nesse tópico.
- Por que o chat ID do meu grupo mudou?
- O grupo foi convertido em supergrupo. O ID de um grupo básico é substituído por um novo, que começa com -100; o Telegram responde às requisições para o ID antigo com um erro que traz o ID novo em migrate_to_chat_id. Daí em diante, use o ID novo.