Localizador de chat ID do Telegram
Este localizador de chat ID do Telegram mostra o chat_id de cada chat privado, grupo, supergrupo, canal e tópico do fórum de onde o seu bot recebeu atualizações recentemente: cole o token do bot, mande uma mensagem a ele e clique em um botão.
O token fica no seu navegador (localStorage) e é enviado apenas para api.telegram.org.
Envie qualquer mensagem ao seu bot (ou adicione-o a um grupo ou canal e publique algo lá) e depois clique no botão.
As atualizações são lidas sem offset, então continuam não confirmadas e o seu bot ainda as recebe.
Como pegar o chat ID no Telegram
- Cole o token do seu bot (onde encontrá-lo: /pt/guides/telegram-bot-token.html). Marque Servidor de testes apenas se o bot estiver no ambiente de testes.
- Escreva qualquer coisa ao bot em um chat privado. Para um grupo, adicione o bot e envie
/start@your_bot— com o modo de privacidade ativado, o bot só vê os comandos endereçados a ele. Para um canal, adicione o bot como administrador e publique um post. - Clique em Encontrar chat IDs. A tabela lista cada chat com nome, tipo,
chat_ide, para tópicos do fórum, omessage_thread_id. Use Copiar ao lado do ID. - Para um canal ou supergrupo público, você pode dispensar as atualizações e digitar o
@usernameno campo de consulta.
O que acontece nos bastidores
Primeiro a ferramenta chama getMe para verificar o token e mostrar qual bot você está usando. Depois chama getUpdates com limit 100 e timeout 0 — e sem offset. Sem offset, o Telegram não confirma as atualizações, então o seu bot (ou a próxima execução da ferramenta) ainda as recebe.
Os chats são coletados de mensagens e mensagens editadas, posts de canal, mensagens business, callback queries, mudanças de my_chat_member e chat_member, solicitações de entrada, reações e boosts. Por isso, muitas vezes basta adicionar o bot a um grupo ou canal para o chat aparecer.
A consulta por @username chama getChat. O Bot API só aceita username para supergrupos e canais públicos; usuários não podem ser consultados pelo username.
Se nenhum chat aparecer
- Lista vazia — não há atualizações recentes. O Telegram guarda as atualizações por até 24 horas, e um bot rodando com long polling as confirma quase na hora. Pare o bot por um momento, envie uma nova mensagem e tente de novo.
- 409 Conflict — há um webhook configurado e o
getUpdatesfica desativado. A ferramenta oferece Apagar webhook (comdrop_pending_updates=false, para manter as atualizações na fila) e tenta de novo. Depois, configure o webhook outra vez: /pt/guides/telegram-bot-webhook.html. - Um grupo não aparece — o modo de privacidade oculta as mensagens comuns; envie um comando endereçado ao bot.
Privacidade
O token é salvo apenas no localStorage do seu navegador, e as requisições vão direto do navegador para api.telegram.org. Nada passa pelo nosso servidor. Você pode repetir a mesma chamada manualmente no /pt/telegram-bot-api-tester.html#getUpdates. Para ver cada tipo de chat em detalhes, leia /pt/guides/telegram-chat-id.html, e para enviar a primeira mensagem ao ID encontrado, veja /pt/guides/telegram-bot-send-message.html.
Perguntas frequentes
Como descobrir o meu chat ID no Telegram?
Envie qualquer mensagem ao seu bot, cole o token do bot na ferramenta acima e clique em Encontrar chat IDs. A tabela mostra o chat_id; no chat privado com o bot, ele é igual ao seu ID de usuário.
Por que a ferramenta não encontra nenhum chat?
Não há atualizações não confirmadas: ninguém escreveu ao bot nas últimas 24 horas, ou o seu bot em execução já as confirmou com offset. Se houver um webhook configurado, getUpdates retorna 409 Conflict; a ferramenta oferece apagar o webhook.
A ferramenta vai tirar atualizações do meu bot?
Não. getUpdates é chamado sem offset, então o Telegram não marca as atualizações como confirmadas e o seu bot continua recebendo-as.
Por que o ID de um grupo ou canal começa com -100?
Supergrupos e canais têm IDs como -1001234567890, grupos básicos têm IDs negativos e usuários, positivos. Sempre passe o número completo, incluindo o sinal de menos e o -100.
É seguro colar o token do meu bot aqui?
O token fica no localStorage do seu navegador e é enviado apenas para api.telegram.org — não para o nosso servidor. Se um token vazar, revogue-o com /revoke no @BotFather.
Outros utilitários
Escape de MarkdownV2 e HTMLValidador de initData do Mini AppVerificador de webhookBot API Tester