连接一个机器人只需要它的令牌,别的什么都不用。你得先把机器人创建好—— Telegram 需要准备什么 介绍了 BotFather——之后就只是一张表单。
连接它
-
打开 /channels,按 添加渠道。
-
选择 Telegram。打开的页面是 连接 Telegram,上面在 如何获取您的 凭据 之下列着 BotFather 的三步:
打开 Telegram 并搜索 @BotFather 发送 /newbot 并按提示操作 复制 BotFather 给您的机器人令牌
-
在 凭据 下面,填写两个字段:
- 渠道名称 —— 已经预填了 “Telegram”。保持不变,连接完成后渠道就会以 机器人的名字命名:Telegram — @BrightwaterBikesBot。也可以自己起名。
- 机器人令牌(来自 @BotFather) —— 粘贴令牌。
-
按 连接并校验。
渠道已成功连接 您现在可以把智能体部署到此渠道了。
从那一刻起,顾客发给机器人的消息就会进入 Omni Octo。下一步是选择由谁回复—— 给 Telegram 机器人装上 AI 智能体。 在你设置好之前,消息照样到达,在 /conversations 里等你的团队处理。
连接并校验做了什么
两件事,按顺序:
- 向 Telegram 检查令牌。 一个可用的令牌会告诉 Omni Octo 机器人的 @用户名 和名称。
- 告诉 Telegram 把机器人的消息发送到 Omni Octo,用的是只有 Telegram 和 Omni Octo 知道的密钥。Telegram 送达的每条消息都带着它,不带它到达的一切都会 被拒收,所以别人无法把伪造的顾客消息塞进你的收件箱。
任何一步失败,页面都会显示 校验未通过,并附上原因。渠道仍然会创建,标记为 错误,你可以在它的页面上修复。
| 原因显示 | 含义 |
|---|---|
| Health check failed: 401: Unauthorized | 令牌不对,或者已在 BotFather 里被撤销。重新复制一遍——完整复制,包括冒号前面的部分。 |
| … is already connected to another Omni Octo channel | 这个机器人已经连接到别处。Telegram 只把机器人的消息送到一个地方,所以先删除另一个渠道,或者再创建一个机器人。 |
| The bot token works, but Telegram could not be told to send this bot’s messages here | 令牌没问题;Telegram 没有接受第二步。等一分钟,在渠道页面上按 校验。 |
渠道的页面
在 /channels 里打开渠道。名称旁边是 Telegram 和它的状态——已连接时为
进行中。在 平台信息 下,你会看到机器人按照 Telegram 上报原样显示的
botUsername 和 botName;在 智能体 下,是回复这里的智能体,等有了一个
之后。
当渠道还不是 进行中 时,会出现 校验。它把两步都再跑一遍:修好原因里 指出的问题之后,就用它。
更换令牌
如果你在 BotFather 里撤销了令牌,或者换了一个新机器人:
- 在渠道页面上,按 更新凭据。
- 粘贴新令牌,然后按 保存并校验。
两个步骤都会用新令牌再跑一遍,Telegram 会拿到一个新的密钥。给 同一个 机器人 换新令牌,你已有的会话都还在。给 另一个 机器人的令牌,对顾客来说就是另一个 机器人:他们得重新找到新机器人并给它发消息。
删除渠道
渠道页面上的 删除 会移除渠道,并把挂在它上面的所有智能体撤下来(智能体本身 保留):
… 及其所有部署将被永久移除。此操作无法撤销。
机器人本身还在 Telegram 里存在,顾客也还能给它发消息,只是没有人回复了。想再 连接它,就把它作为新渠道添加一次。
让 Octo 来连接
Octo 可以在一段对话里做同样的事。把你想做的事和令牌一起告诉它:
连接我的 Telegram 机器人,让 Brightwater front desk 智能体来回复它。令牌是 …
Octo 会连接机器人,告诉 Telegram 消息发到哪里,并把智能体装上去;在会改变顾客 所见内容的步骤之前,它会先征求你的同意。
接下来
- 给 Telegram 机器人装上 AI 智能体 —— 选择由哪个 AI 智能体来回复。
- 你的 Telegram 机器人没有回复 —— 消息收不到、或者没人回复时,该检查什么。