基于 Cloudflare Workers 的高可用、零服务器成本、企业级安全 Telegram ID 与元数据查询机器人
TGID_bot 专为 Telegram 用户、频道主、社群管理员及 Bot 开发者设计。无需购买 VPS 服务器，依托 Cloudflare 全球边缘网络 (Serverless) 实现毫秒级响应、永久在线与零维护。
代码原生支持 Cloudflare 绑定 GitHub 自动化构建，每次提交代码自动热更新！
| 功能模块 | 图标 | 特性描述 |
|---|---|---|
| 发送者识别 | 👤 | 精准提取当前用户的 User ID、姓名、用户名、Telegram Premium 状态及语言代码 |
| 群聊与频道 | 💬 | 查询普通群、超级群（Supergroup）、频道（Channel）ID 及论坛话题（Topic ID） |
| 目标回复解析 | 🎯 | 群内 回复 (Reply) 某人消息并发送 /id，秒级提取被回复者的 ID 与媒体信息 |
| 转发深度溯源 | 🔄 | 深度解析 转发 (Forward) 消息来源（原作者、原频道/群组 ID、原始发送时间戳） |
| 全量媒体提取 | 📁 | 提取各类文件 file_id 与 file_unique_id（贴纸、图片、视频、音频、动图、名片等） |
| 安全加固体系 | 🛡️ | X-Telegram-Bot-Api-Secret-Token 官方签名防伪校验，杜绝虚假请求与恶意轰炸 |
| 健壮容灾机制 | ⚡ | 4096 字符溢出保护 + Telegram HTML 解析失败自动纯文本降级兜底 |
所有返回的 ID 均采用 Telegram
<code>代码块渲染，手机或电脑端 轻触数字即可一键复制！
1. 发送 /start（欢迎与使用指南卡片）
👋 欢迎使用 What's My ID 机器人！
这是一个极速、安全、无日志的 Telegram 身份与元数据查询工具 ⚡
🆔 您的基础信息：
├ 用户 ID: 123456789
├ 姓名: 开发者
├ 用户名: @developer
└ 对话 ID: 123456789
📖 快捷使用指南：
• 极简查 ID： 发送 /id（仅返回纯数字 ID，防刷屏）
• 全量元数据： 发送 /info 或直接发媒体/转发消息
• 查他人： 在群内【回复他人消息】并输入 /id
• 查来源： 转发他人或频道消息给我，解析原作者与频道 ID
• 查群组： 在群内发送 /id 获取群组与话题 Topic ID
• 查媒体： 发送贴纸、图片、音视频或文件，提取开发专用 File ID
💡 提示：轻触上方任意数字即可一键复制！
2. 发送 /id ——【极简极速模式】（轻量、干净、防群聊刷屏）
- 私聊查询自己：
🆔 用户 ID: 123456789 - 群聊直接发送：
🆔 用户 ID: 123456789 💬 群聊 ID: -1001234567890 🧵 话题 ID: 12 - 群内【回复他人消息】发送：
🎯 目标用户 ID: 987654321 🆔 用户 ID: 123456789 💬 群聊 ID: -1001234567890
3. 发送 /info 或【直接发送/转发媒体】 ——【全量元数据报告】
🆔 Telegram 详细元数据报告
🎯 被回复的目标消息 (Target Reply):
├ 消息 ID: 520
├ 目标用户 ID: 987654321
├ 目标姓名: 目标成员
├ 目标用户名: @target_user
└ 目标是机器人: 否
👤 发送者 (Sender):
├ 用户 ID: 123456789
├ 姓名: 管理员
├ 用户名: @admin
├ 会员状态: Telegram Premium 🌟
└ 语言代码: zh-hans
💬 当前所在对话 (Chat):
├ 对话 ID: -1001234567890
├ 对话类型: supergroup
├ 名称: 极客交流圈
├ 话题 Topic ID: 12
└ 当前消息 ID: 521
4. 转发频道/他人消息（深度溯源原作者与时间）
🆔 Telegram 详细元数据报告
👤 发送者 (Sender):
├ 用户 ID: 123456789
├ 姓名: 开发者
└ 用户名: @developer
💬 当前所在对话 (Chat):
├ 对话 ID: 123456789
├ 对话类型: private
└ 当前消息 ID: 1025
🔄 转发来源 (Forward Origin):
├ 来源类型: 频道
├ 频道 ID: -1001987654321
├ 频道名: 前沿技术资讯
├ 用户名: @tech_news
├ 原消息 ID: 888
└ 原始时间: 2026-08-30 08:00:00 UTC
5. 发送贴纸 / 图片 / 附件（提取 File ID）
🆔 Telegram 详细元数据报告
👤 发送者 (Sender):
├ 用户 ID: 123456789
├ 姓名: 开发者
└ 用户名: @developer
💬 当前所在对话 (Chat):
├ 对话 ID: 123456789
├ 对话类型: private
└ 当前消息 ID: 1026
📁 附加内容信息:
├ 类型: 贴纸 👍
├ 集合名: AnimatedDuck
├ File ID: CAACAgIAAxkBAAIC...AgADbQADNgQ
└ Unique ID: AQADbQADNgQ
只需简单的 4 步，即可实现 GitHub 代码改动时 Cloudflare 自动拉取构建与更新：
- 在 Telegram 中搜索并私聊 @BotFather，发送
/newbot。 - 按照提示设置机器人昵称与用户名（例如
MyAwesomeIdBot）。 - 复制生成的 Bot Token（格式如
123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ）。 -
(可选建议) 在
@BotFather中发送/setprivacy$\to$ 选择你的 Bot$\to$ 选择Disable（允许群内正常响应指令）。
将本项目代码克隆/推送到你的 GitHub 个人账户下。
- 登录 Cloudflare Dashboard。
- 进入左侧菜单 Compute (Workers & Pages)
$\to$ Create application。 - 选择 Workers 或 Pages 选项卡下的 Connect to Git（连接到 Git）。
- 授权你的 GitHub 账号，并选择刚才创建的
TGID_bot仓库。 -
构建设置 (Build settings)：
-
Project name:
tgid-bot（或自定义） -
Production branch:
main -
Framework preset:
None - Build command: 留空
- Deploy command: 保持默认
-
Project name:
- 点击 Save and Deploy 完成初次部署。
- 在 Cloudflare 该项目的 Settings
$\to$ Variables and Secrets 页面，点击 Add 添加以下环境变量：-
BOT_TOKEN: 你的 Telegram Bot Token。 -
SECRET_TOKEN: 自定义一段安全密钥（仅限字母、数字、下划线、短横线，例如my_secret_token_888）。 -
BOT_USERNAME: (可选) 你的机器人用户名（不带@，用于精准防抢答）。
-
- 点击 Save and Deploy 重新生效。
- 复制 Cloudflare 分配给你的域名，在浏览器中访问一次：
https://你的Cloudflare域名/setWebhook?secret=你设置的SECRET_TOKEN - 看到返回
{"ok": true, "result": true, "description": "Webhook was set"}即代表成功上线！🎉
客户端请求 ──> [Cloudflare 全球边缘节点]
│
├──> 校验 X-Telegram-Bot-Api-Secret-Token (防伪造)
│
├──> 正则校验指令与 @bot_username (防抢答)
│
├──> 业务解析 (用户/群聊/转发/媒体/Topic)
│
└──> safeSendMessage 容灾发送
├─ 4000 字符主动截断
├─ HTML 实体转义
└─ 格式异常自动降级为 Plain Text 重试
本项目在架构设计、功能构思与代码打磨过程中，得到了以下优秀 AI 技术的启发与支持，特此致谢：
- Google 反重力 (Antigravity) - 提供强大的智能代理架构与工程设计能力。
- ChatGPT (OpenAI) - 提供敏捷的代码优化思路与逻辑灵感。
本项目基于 MIT License 开源。欢迎 Star ⭐ 与 Fork 支持！