Telegram Chat ID 查询工具
这个 Telegram chat id 查询工具会显示机器人最近收到更新的每个私聊、群组、超级群组、频道和论坛话题的 chat_id:粘贴 Bot Token,给机器人发一条消息,再点一下按钮即可。
Token 只保存在你的浏览器中(localStorage),并且只发送到 api.telegram.org。
给你的机器人发送任意消息(或者把它加入群组或频道并在其中发言),然后点击按钮。
读取更新时不带 offset,因此更新不会被确认,你的机器人仍然能收到它们。
如何获取 Telegram chat id
- 粘贴你的机器人的 Token(在哪里找:/zh/guides/telegram-bot-token.html)。只有当机器人位于测试环境时才勾选测试服务器。
- 在私聊中给机器人随便发点什么。对于群组,先把机器人加进去,然后发送
/start@your_bot——开启隐私模式时,机器人只能看到发给它的命令。对于频道,把机器人添加为管理员并发布一条帖子。 - 点击查找 Chat ID。表格会列出每个聊天的名称、类型、
chat_id,论坛话题还会显示message_thread_id。点击 ID 旁边的复制即可。 - 对于公开频道或超级群组,可以跳过更新,直接在查询框中输入它的
@username。
工具背后做了什么
工具先调用 getMe 检查 Token,并显示你正在使用哪个机器人。然后调用 getUpdates,参数为 limit 100 和 timeout 0,并且不带 offset。不带 offset 时 Telegram 不会确认这些更新,因此你的机器人(或者下一次运行的工具)仍然能收到它们。
聊天信息从以下来源收集:消息和编辑过的消息、频道帖子、商业消息、回调查询、my_chat_member 和 chat_member 变更、加群申请、表情回应以及助力。所以很多时候,只要把机器人加入群组或频道,该聊天就会出现在列表中。
按 @username 查询会调用 getChat。Bot API 只接受公开超级群组和频道的用户名;无法通过用户名查询用户。
如果没有显示任何聊天
- 列表为空——没有新的更新。Telegram 最多保存更新 24 小时,而正在以长轮询方式运行的机器人几乎会立即确认它们。先暂停机器人,发送一条新消息后再试。
- 409 Conflict——设置了 Webhook,
getUpdates被禁用。工具会提供删除 Webhook按钮(使用drop_pending_updates=false,因此队列中的更新会保留),然后重试。之后请重新设置 Webhook:/zh/guides/telegram-bot-webhook.html。 - 缺少某个群组——隐私模式屏蔽了普通消息;请发送一条发给机器人的命令。
隐私
Token 只保存在你浏览器的 localStorage 中,请求直接从浏览器发送到 api.telegram.org,不经过我们的服务器。你也可以在 /zh/telegram-bot-api-tester.html#getUpdates 中手动执行同样的调用。各类聊天的详细说明请阅读 /zh/guides/telegram-chat-id.html;要向找到的 ID 发送第一条消息,请参见 /zh/guides/telegram-bot-send-message.html。
常见问题
怎样查看自己的 Telegram chat id?
给你的机器人发送任意消息,把 Bot Token 粘贴到上方工具中,然后点击查找 Chat ID。表格会显示 chat_id;对于与机器人的私聊,它就等于你的用户 ID。
为什么工具找不到任何聊天?
因为没有未确认的更新:过去 24 小时内没有人给机器人发消息,或者正在运行的机器人已经用 offset 确认了这些更新。如果设置了 Webhook,getUpdates 会返回 409 Conflict,工具会提示你删除 Webhook。
这个工具会抢走机器人的更新吗?
不会。调用 getUpdates 时不带 offset,因此 Telegram 不会把更新标记为已确认,你的机器人仍然能收到它们。
为什么群组或频道的 ID 以 -100 开头?
超级群组和频道的 ID 形如 -1001234567890,普通群组的 ID 是负数,用户的 ID 是正数。请始终传入完整的数字,包括负号和 -100。
把 Bot Token 粘贴到这里安全吗?
Token 只保存在你浏览器的 localStorage 中,并且只发送到 api.telegram.org,不会发送到我们的服务器。如果 Token 泄露,请在 @BotFather 中用 /revoke 撤销。
其他工具
MarkdownV2 与 HTML 转义工具Mini App initData 校验工具Webhook 检查工具Bot API Tester