Connector — 多平台 IM 接入

Connector 是数字员工接入外部即时通讯（IM）平台的通道。通过 Connector，数字员工可以接收和回复飞书、企业微信等平台上的消息，将数字员工的能力延伸到日常办公 IM 中。

概述

Connector 与数字员工绑定：每个 Connector 归属于一个数字员工，该数字员工发布的平台账号收到的消息会路由到对应数字员工处理。

当前支持的平台：

平台	类型标识	说明
飞书	feishu	通过飞书开放平台自建应用接入（WebSocket 长连接）
企业微信	wecom	通过企业微信机器人接入

更多平台（钉钉、微信、邮件）正在规划中。

创建 Connector

Connector 的创建入口位于数字员工详情页的 Connector 菜单项（数字员工必须已发布）。

点击 新建 Connector，选择平台类型并填写对应配置：

飞书

需要先在飞书开放平台创建自建应用，获取：

• App ID：应用凭证（格式 cli_xxxxx）
• App Secret：应用密钥
• 验证令牌（可选）：事件订阅的 verification token

创建后，需要在飞书开放平台的事件订阅中配置回调地址（用于验证）或启用长连接模式。平台通过 WebSocket 长连接接收飞书消息事件。

企业微信

需要先创建企业微信群机器人，获取：

• Bot ID：机器人 ID
• Secret：机器人密钥

默认工作站（灵活工作模式）

如果数字员工处于灵活工作模式，可以选择 默认工作站：该 Connector 收到的消息统一在指定工作站上执行工具调用。

管理 Connector

Connector 列表展示名称、类型、关联数字员工、启用状态、运行状态与创建者。

对每个 Connector 可以执行：

• 启动 / 停止：控制 Connector 运行状态（停止后不再接收消息）
• 启用 / 禁用：控制 Connector 配置生效状态（禁用会自动先停止）
• 删除：删除 Connector（会先尝试停止）

管理员视图

租户管理员在后台管理的 Connectors 页面可以查看租户内所有 Connector 并执行同样的管理操作。

消息能力

Connector 支持的消息类型：

• 文本消息：常规对话
• 图片消息：自动下载图片内容供数字员工理解（飞书通过消息资源端点下载）
• 文件消息：自动下载文件内容（飞书通过消息资源端点下载）
• 引用消息：企业微信支持引用消息上下文

群聊

同一群聊中可以配置多个机器人（同一数字员工的多个 Connector 或多个数字员工），系统会为每个机器人维护独立的会话上下文，避免消息串扰。

定时任务通知

数字员工的定时任务执行结果可以通过 Connector 推送到 IM 平台（在定时任务配置中选择通知渠道）。