微信、飞书与 Telegram

#消息渠道在业务中的作用

消息渠道不只是与 Agent 聊天的入口，也可以把需要人处理的业务事项送到团队已经在使用的工具中。对 AI 客服来说，它尤其重要：普通会话继续由 AI 处理，退款、补发或规则外判断等升级事项则投送给负责人，负责人回复后 AI 再继续执行。

本页优先介绍 飞书、微信和 Telegram。如果你要配置客服升级，推荐先用飞书；它提供单独的升级表单卡片，处理意见和完成状态都能在同一条消息中提交。

#1. 优先连接飞书

进入 连接 → 消息渠道，选择飞书，然后点击连接。推荐使用二维码方式：按页面提示扫码，TK Copilot 会完成机器人凭证和官方插件配置。

APP CAPTURE中文浅色界面的飞书连接引导；推荐二维码自动配置，并保留 App ID 与 App Secret 的手动方式。

如果二维码流程提示缺少权限，请按提示为应用补充“更新应用”等所需权限，再重试。团队已有自建飞书或 Lark 应用时，也可以改用手动方式填写 App ID 与 App Secret，并确认区域选择正确：国内飞书使用 Feishu，国际版使用 Lark。

让企业外部用户也能使用机器人

飞书应用默认服务于应用所属企业内的用户。如果还要让企业外部用户与机器人沟通，需要发布一个允许对外共享的新版本：

1. 打开 飞书开放平台，进入对应的飞书应用；
2. 进入 版本管理与发布，创建或更新一个应用版本；
3. 在“对外共享”中勾选 允许外部用户与机器人单聊；
4. 如果机器人还需要加入外部群，同时勾选 允许机器人被添加到外部群中使用；
5. 首次开放时建议保留“外部用户首次开启单聊时，需应用所有者审核”；
6. 保存并发布新版本，确认页面顶部显示“当前修改均已发布”。

APP CAPTURE飞书开放平台的版本管理与发布页面；对外共享区域已勾选允许机器人加入外部群，以及允许外部用户与机器人单聊。

“可用范围”管理企业内部哪些成员可以使用应用，“对外共享”则控制外部群和外部用户。开放对外共享前，请评估外部消息可能包含的数据、隐私和访问风险，并只开启实际需要的能力。

连接后建议：

1. 先给机器人发送一条私聊消息；
2. 回到渠道列表确认账户在线；
3. 展开账户，检查接收人是否已经出现；
4. 再到店铺的 AI 智能客服配置中，把该账户和接收人选为客服升级投送目标。

飞书升级到达后，负责人直接填写处理意见并选择“未解决”或“已解决”。提交已解决后，卡片标题会从待处理色变成绿色完成状态，AI 会收到这次决定并继续原会话。

#2. 连接微信

在消息渠道中选择微信并开始连接，然后用需要接收业务消息的微信扫描二维码。登录成功后，还要从该微信账户主动给机器人发送一条初始消息；完成这一步后，对应接收人才会出现在 TK Copilot 中。

当前建议把微信作为负责人私聊渠道使用。配置客服升级时，选择这个微信账户和对应接收人。收到升级通知后，直接回复原消息即可；回复时保留升级请求的上下文，避免只发送无法关联到事项的孤立结论。

如果更换了微信账户或登录失效，请回到消息渠道重新扫码，并再次发送初始消息验证接收人。

#3. 连接 Telegram

先在 Telegram 中打开 @BotFather，使用 /newbot 创建机器人并复制 Bot Token。然后在 TK Copilot 的消息渠道中选择 Telegram，填写 Token。

APP CAPTURE中文浅色界面的 Telegram 账户配置；Bot Token 为必填项，Webhook 可选，并可设置私聊与群组访问策略。

首次配置建议：

• Webhook URL 留空，使用默认连接方式；
• 私聊策略保留 配对，只有经过批准的用户可以交互；
• 群组只在确有需要时开启，并设置允许的群组或用户；
• 创建后先给机器人发送一条消息，再回到渠道账户中批准配对请求。

如果机器人需要读取群组中的普通消息，请同时检查 BotFather 的隐私模式和 TK Copilot 的群组策略；仅接收提及机器人消息时可以保持更严格的设置。

#4. 管理账户、配对和接收人

每个渠道可以有一个或多个账户。展开一个已连接账户，可以查看运行状态、配对请求、允许名单和已经发现的接收人。建议：

• 给账户设置清晰标签，例如“客服升级｜上海团队”；
• 只批准团队成员发起的配对；
• 用允许名单限制可私聊或可触发机器人的用户；
• 在店铺配置中选择具体账户和接收人，不要只依赖渠道名称。

接收人列表依赖一次真实会话。新连接的飞书、微信或 Telegram 账户如果没有目标可选，先从目标用户或群组向机器人发送一条消息，再刷新账户。

#5. 验证客服升级投送

渠道显示已连接后，还需要做一次业务验证：

1. 在测试店铺配置客服升级渠道和接收人；
2. 用一条超出 AI 授权边界的测试会话触发升级；
3. 确认负责人收到包含店铺、买家、订单、原因和上下文的通知；
4. 从渠道中回复或提交飞书表单；
5. 回到 客服 → 客服升级，确认处理记录和状态已经更新。

完整处理方式见 客服升级与人工审核。

#常见问题

渠道显示已配置但收不到消息

先检查账户是否在线、接收人是否仍存在，以及店铺选择的是不是同一个账户。Telegram 还要检查配对是否批准；微信需确认登录后已经发送初始消息。

飞书能收到消息但不能提交升级卡片

重新打开飞书连接引导，按提示补齐应用权限并刷新连接。仍失败时，可以暂时到 App 的客服升级详情提交决定。

Telegram 群组里机器人没有响应

核对 TK Copilot 的群组策略、允许名单和是否要求提及，同时检查 BotFather 的隐私模式。

更多底层配置可参考 OpenClaw 的 飞书文档、Telegram 文档 和 微信文档。