Telegram Bot API

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

  1. 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.
  2. 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.
  3. Clique em Encontrar chat IDs. A tabela lista cada chat com nome, tipo, chat_id e, para tópicos do fórum, o message_thread_id. Use Copiar ao lado do ID.
  4. Para um canal ou supergrupo público, você pode dispensar as atualizações e digitar o @username no 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

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