连接 Telegram

前置条件

开始前，请确认：

• 智能体已经创建。
• 智能体状态是 running。页面只有在 running 状态下才允许保存 token 并注册 webhook。
• 你可以访问 Telegram，并能通过 @BotFather 创建 bot。
• 你已经从 @BotFather 拿到 bot token。

如果智能体还在 provisioning，请等待状态同步完成后再配置 Telegram。

连接步骤

1. 打开 Dashboard，进入目标智能体详情页。
2. 找到 Channels / Telegram 区域。
3. 在 Telegram 中打开 @BotFather，创建一个 bot，并复制 bot token。
4. 回到 Hast，把 bot token 粘贴到 Telegram 配置输入框。
5. 点击 Save and register webhook。
6. 保存成功后，Dashboard 会显示 webhook 状态。
7. 如果 Telegram bot 要求配对，在 Dashboard 的 pairing 输入框中填写 bot 给出的 code。
8. 点击 Pair 完成绑定。

token 保存后，Hast 会把 Telegram 配置同步到运行中的智能体，并尝试注册 webhook。之后 Telegram 的消息会通过 webhook 进入运行时。

状态说明

你可能会看到这些状态：

• Webhook registered：token 已保存，webhook 已注册，Telegram 可以把消息发送到智能体运行时。
• Saved (deploy to register webhook)：配置已保存，但智能体尚未 running。等运行后需要重新确认 webhook 状态。
• Paired successfully：pairing code 已提交，Telegram bot 和智能体完成绑定。

如果你重新生成了 bot token，或换了 Telegram bot，需要回到这里重新保存并注册 webhook。

排查问题

• 按钮不可用：确认智能体状态是否为 running。
• token 保存失败：确认 token 完整复制自 @BotFather，没有多余空格。
• webhook 没有注册：刷新智能体详情页，确认状态仍为 running 后重新保存。
• pairing code 无效：确认 code 来自同一个 Telegram bot，并且没有过期。
• bot 不响应：先确认页面显示 Webhook registered，再确认 Telegram 中使用的是同一个 bot。
• 仍然无法使用：重新同步智能体状态，或检查智能体详情页是否有运行时错误。