Telegram 集成
Telegram 集成提供两种互相独立的连接：
- Agent 机器人：把一个 HiFox Agent 绑成 Telegram 机器人，在私聊、群组 @ 和话题中对话。
- 任务助手：每个空间一个系统助手。从 Telegram 集成页绑定后，可以在群里根据聊天上下文整理需求并创建任务，也可以查询和修改该空间的任务。
两者都用 @BotFather 创建的机器人令牌连接，可以同时使用，但需要分别配置。任务助手不是普通 Agent：它不会出现在 Agent 列表、处理人选择器和站内私聊里。
连接前需要准备什么？
从哪里进入？
- 进入组织后，打开 外部应用集成，进入 Telegram 详情页；
- 或进入某个 Agent 的详情页，在 集成 页签中配置，这种方式会直接绑定当前 Agent。
连接 Agent 机器人
- 打开 连接 Telegram 弹窗。
- 选择要绑定的 Agent。
- 粘贴 @BotFather 给出的机器人令牌。
- 点击连接，令牌验证通过后即完成绑定。
- 用设置页上的 拉进群 把机器人加入群组，或 打开对话 直接和机器人私聊。
机器人要先进入群组才能收发群消息。绑定后可以在 Agent 的集成设置里按条开启触发方式。
绑定任务助手
- 打开 外部应用集成，进入 Telegram 详情页的 任务助手 分组。
- 找到你加入的空间，选择 绑定 Telegram。
- 选择运行该空间任务助手的 Runtime。
- 粘贴机器人令牌，把机器人拉进目标群。
每个空间只能有一个任务助手。任务助手与 Agent 分身使用同一套设置结构：空间行的 ··· 菜单提供 设置、解绑 和 移除助手。设置 会打开和 Agent 相同的设置面板，可以调整运行电脑与 Runtime、默认模型、指令、技能等；其中 描述 和 指令 默认继承管理后台的「任务助手模板」，模板修改后自动同步，在助手侧改过即标记 已覆盖、可用 恢复继承 回到模板。系统自带一套出厂模板（内置在 Telegram 里创建任务的指令），组织管理员可在管理后台的 任务助手模板 页统一维护中文 / 英文模板。
在 Telegram 中怎么使用？
私聊机器人
在 Telegram 里直接给机器人发私信，可以和绑定的 Agent 对话。第一次私信会创建对应的 Agent 会话，之后在同一私信里继续发送，Agent 会基于这个会话回复。
在群里 @ 机器人
在群里 @ 机器人并输入问题或指令，这是默认触发方式。Agent 回复时会带上附近消息的聊天上下文；已经在话题（Topics）里 @ 则回在当前话题。
可选：表情触发、消息触发
在 Agent 的集成设置里可以按条开启触发方式，开关名称以线上为准，常见有：
- 群里被 @ 到（默认）；
- 群消息 Emoji 表情触发：对消息添加指定表情会触发 Agent，并带上该消息附近的上下文。Telegram 只把表情事件推送给群管理员身份的机器人，请先把机器人设为群管理员；机器人只能处理服务启动后收到过的消息（每个聊天最近 100 条、24 小时内），更早的消息它会回复说读不到；
- 群消息直接触发：所选群里的每条消息都会触发 Agent，无需 @。需要先关闭 Privacy Mode（或把机器人设为群管理员）；群列表要把机器人拉进群并在群里发一条消息后才会出现。可以开启 论坛话题（Topics）里的消息也触发。
Telegram 不支持用表情终止正在工作的 Agent；需要停止时，请在 HiFox 里点停止。
使用 /new 新开会话
在和机器人的会话中使用 /new，可以开始一个新的 Agent 会话，不会带上之前的上下文。
发送文件
Agent 回复里的文件会回到原来的 Telegram 会话：图片按图片消息发送，其他文件以文件形式发送；单个文件最大 50 MB，一轮回复最多携带 10 个文件，超限的文件会在回复里说明。
管理和断开
回到 Telegram 集成页可以查看已连接的机器人列表，包括绑定的 Agent、所在群和当前状态，并进行重试或断开。断开后，这个 Agent 不再通过该机器人收发消息；已有 HiFox 会话和历史消息不会因此删除。
常见状态
常见问题
机器人在群里收不到普通消息怎么办？
先确认已经关闭 Privacy Mode（@BotFather 发送 /setprivacy 并选择 Disable），改完要把机器人移出群再重新拉进来才生效；或者把机器人设为群管理员。只 @ 机器人时不需要这些设置。
群列表里找不到目标群？
把机器人拉进 Telegram 群后，在群里发一条消息，群就会出现在可选列表里。Telegram 不允许机器人自行列出所在群，需要以消息为线索。
Telegram 消息会变成 HiFox 任务吗？
Agent 机器人不会自动把消息变成任务。需要把群里的讨论整理成任务时，使用空间的任务助手：在群里 @ 任务助手，它会根据聊天上下文创建任务；之后也可以在 Telegram 里继续查询和修改任务。