渠道
接入企业微信智能机器人
如何在 Buda 中配置和使用企业微信智能机器人 (API 模式),通过长连接实现流式打字机回复。
接入企业微信智能机器人 (Bot 模式)
通过创建企业微信的智能机器人 (API 模式),您可以让 Buda Agent 以打字机的效果(流式分片)在企业微信中回复用户。Buda 使用长连接接入,只需配置机器人 ID 与 Secret,无需配置接收消息 URL 或域名。
步骤 1:添加智能机器人
- 登录 企业微信管理后台。
- 在左侧菜单进入 安全与管理 -> 管理工具,在 智能专区 AI+ 下点击 智能机器人。(管理工具直达链接)
- 在弹窗「你需要一个什么样的机器人」中,点击底部的 手动创建,进入创建页面。
- 【关键步骤】 在「创建智能机器人」页面向下滚动到 更多设置,底部有「如需使用自有系统获取成员与机器人的聊天并输出回复,可切换至 API 模式创建」— 点击 API 模式创建。只有 API 模式才支持由 Buda 接管对话与流式回复。
- 进入 API 配置页后,在 连接方式 中选择 使用长连接(无需域名或 IP 即可接收消息并返回结果)。不要选「使用 URL 回调」。
- 填写机器人名称、头像和可见范围,保存完成创建。
步骤 2:获取机器人 ID 与 Secret
- 在 API 配置页的 配置方法 区域可见 Bot ID(可复制)和 Secret(点击「点击获取」获取)。
- 将 Bot ID 和 Secret 复制保存,下一步在 Buda 中填写。
步骤 3:在 Buda 中配置通道
- 打开 Buda 的 频道设置 (Channels) 页面。
- 点击 添加频道,提供商选择 企业微信智能机器人 (Bot)。
- 在 Buda 中填入 机器人 ID 和 Secret,点击保存。
- 保存后 Buda 会自动通过 WebSocket 长连接接入企业微信。
步骤 4:开始使用
在企业微信工作台的搜索框中输入机器人名称,找到该应用后发送消息即可。回复会先显示流动的「...」占位,随后以流式打字机效果输出内容。