可通过四种方法获取telegram userid:一、用botfather创建机器人并监听webhook或getupdates中的from.id;二、使用@userinfobot转发目标用户信息查询;三、通过hermes agent inline查询触发返回自身id;四、解析telegram登录二维码回调中的tgwebappdata解码后id字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在 Hermes Agent 中集成 Telegram 功能,但无法获取目标用户的 Telegram UserID,则可能是由于未通过官方方式触发用户身份识别流程。以下是获取 Telegram UserID 的几种可行方法:
一、通过 BotFather 创建机器人并启用 Webhook 日志捕获
Telegram 官方 Bot API 在用户与机器人首次交互时,会将完整的更新数据(包括 from.id)发送至配置的 Webhook 地址或由 getUpdates 拉取。Hermes Agent 可通过监听该事件提取 UserID。
1、访问 Telegram 应用,搜索并打开 BotFather 账户。
2、发送 /newbot 命令,按提示完成机器人创建,获得 API Token。
3、在 Hermes Agent 配置中填入该 Token,并启用 Telegram Bot 接入模块。
4、让目标用户向新创建的机器人发送任意消息(如 /start)。
5、查看 Hermes Agent 后台日志或调试终端输出,定位包含 "from":{"id":123456789} 的 JSON 数据段。
二、使用 Telegram 官方 @userinfobot 辅助查询
@userinfobot 是 Telegram 社区广泛验证的公开工具型机器人,无需开发即可直接返回当前聊天对象的完整用户信息,包括唯一整型 UserID。
1、在 Telegram 中搜索并关注 @userinfobot。
2、点击其对话界面底部的 Start 按钮启动会话。
3、将待查询用户以转发形式发送给 @userinfobot(需对方已开启“谁可以查看我的手机号”中的“所有人”或“我的联系人”)。
4、等待 bot 返回结构化信息,其中 "id": 987654321 即为目标 UserID。
三、通过 Hermes Agent 内置 Telegram 插件发起 inline 查询
Hermes Agent 支持 Telegram Inline Query 机制,可在用户输入 @botname 时实时返回其自身 ID,适用于群组内快速确认成员身份。
1、确保 Hermes Agent 已部署 Telegram 插件且状态为 active。
2、在任意 Telegram 聊天窗口中输入 @your_hermes_bot inline(将 your_hermes_bot 替换为实际 Bot 用户名)。
3、从下拉菜单中选择任意预设 inline 项(如 “myid”)。
4、Hermes Agent 将立即返回一条私密消息,内容含 Your Telegram UserID is: 555123456。
四、解析 Telegram 登录二维码回调中的 auth_data
当 Hermes Agent 采用 Telegram Login Widget 方式嵌入网页端登录时,用户扫码授权后前端会收到加密 auth_data,其中 base64 解码后可提取 id 字段。
1、在 Hermes Agent 管理后台启用 Telegram Web Login 功能。
2、生成含 redirect_url 的登录链接并提供给目标用户。
3、用户扫码并授权后,浏览器跳转至指定地址,URL query 参数中包含 tgWebAppData=...。
4、对 tgWebAppData 值进行 URL 解码与 base64 解码,查找键名为 id 的数值字段。











