首页 / 文档 / 通道 / 企微智能机器人

企微智能机器人

将 通千算智 接入企业微信智能机器人(长连接模式)

通过企业微信智能机器人接入通千算智,支持企业内部单聊和内部群聊,无需公网 IP,使用 WebSocket 长连接模式,支持Markdown渲染和流式输出。

智能机器人与企业微信自建应用是两种不同的接入方式。智能机器人使用 WebSocket 长连接,无需服务器公网 IP 和域名,配置更简单。

一、接入方式

方式一:扫码一键接入(推荐)

无需提前创建机器人,启动 通千算智 后打开 Web 控制台(本地链接:http://127.0.0.1:9899/),选择 通道 菜单,点击接入通道,选择企微智能机器人,切换到「扫码接入」模式,使用企业微信扫码即可自动完成机器人创建和接入。

扫码成功后,可在企业微信工作台 - 智能机器人页面对机器人进行进一步配置,包括修改名称、头像、可见范围等。

方式二:手动创建接入

需要先在企业微信中创建智能机器人并获取 Bot ID 和 Secret,再通过 Web 控制台或配置文件接入。

步骤一:创建智能机器人

  1. 打开企业微信客户端,进入工作台,点击智能机器人:

  1. 点击创建机器人 - 手动创建:

  1. 右侧窗口拖到最下方,选择API模式创建:

  1. 设置机器人名称、头像、可见范围,并选择长连接模式,记录下 Bot ID 和 Secret 信息后点击保存。

步骤二:接入 通千算智

日志显示 [WecomBot] Subscribe success 即表示连接成功。

除长连接外,也支持回调(HTTP 回调)模式:创建机器人时选择「使用 URL 回调」,将接收消息 URL 设为 http(s)://<域名或IP>:9892/wecombot,并复制该页面的 Token 和 EncodingAESKey。该模式需公网可达,且不支持文件发送与定时推送,一般推荐使用长连接。对应 config.json 配置如下:

json
{
  "channel_type": "wecom_bot",
  "wecom_bot_mode": "webhook",
  "wecom_bot_token": "YOUR_TOKEN",
  "wecom_bot_encoding_aes_key": "YOUR_ENCODING_AES_KEY",
  "wecom_bot_port": 9892
}

二、功能说明

功能 支持情况
单聊 ✅
群聊(@机器人) ✅
文本消息 ✅ 收发
图片消息 ✅ 收发
文件消息 ✅ 收发
流式回复 ✅
定时任务主动推送 ✅

三、使用

在企业微信中搜索创建的机器人名称,即可开始单聊对话。

如需在企微内部群聊中使用,将机器人添加到群中,@机器人发送消息即可。