Telegram Bot API

Telegram Chat ID 查询工具

这个 Telegram chat id 查询工具会显示机器人最近收到更新的每个私聊、群组、超级群组、频道和论坛话题的 chat_id:粘贴 Bot Token,给机器人发一条消息,再点一下按钮即可。

Token 只保存在你的浏览器中(localStorage),并且只发送到 api.telegram.org。

给你的机器人发送任意消息(或者把它加入群组或频道并在其中发言),然后点击按钮。

读取更新时不带 offset,因此更新不会被确认,你的机器人仍然能收到它们。

如何获取 Telegram chat id

  1. 粘贴你的机器人的 Token(在哪里找:/zh/guides/telegram-bot-token.html)。只有当机器人位于测试环境时才勾选测试服务器。
  2. 在私聊中给机器人随便发点什么。对于群组,先把机器人加进去,然后发送 /start@your_bot——开启隐私模式时,机器人只能看到发给它的命令。对于频道,把机器人添加为管理员并发布一条帖子。
  3. 点击查找 Chat ID。表格会列出每个聊天的名称、类型、chat_id,论坛话题还会显示 message_thread_id。点击 ID 旁边的复制即可。
  4. 对于公开频道或超级群组,可以跳过更新,直接在查询框中输入它的 @username。

工具背后做了什么

工具先调用 getMe 检查 Token,并显示你正在使用哪个机器人。然后调用 getUpdates,参数为 limit 100 和 timeout 0,并且不带 offset。不带 offset 时 Telegram 不会确认这些更新,因此你的机器人(或者下一次运行的工具)仍然能收到它们。

聊天信息从以下来源收集:消息和编辑过的消息、频道帖子、商业消息、回调查询、my_chat_member 和 chat_member 变更、加群申请、表情回应以及助力。所以很多时候,只要把机器人加入群组或频道,该聊天就会出现在列表中。

按 @username 查询会调用 getChat。Bot API 只接受公开超级群组和频道的用户名;无法通过用户名查询用户。

如果没有显示任何聊天

隐私

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