渠道能力
飞书、企业微信、钉钉和 WhatsApp 渠道的功能与权限支持情况。
Mopheus 通过统一的渠道引擎接入飞书、企业微信、钉钉和 WhatsApp。各渠道均支持 通过机器人或关联账号与智能体对话、账号绑定，以及将工单状态和评论推送回来源会话； 平台相关的消息上下文和消息展示能力存在差异。
安装记录与外发管理
工作区成员可以在集成列表中查看已安装的渠道记录。列表只显示渠道、智能体或团队、安装显示名以及连接状态，不显示凭据、外部用户绑定信息或消息内容。
安装者和具有相应渠道权限的成员会看到不同的操作：
- 安装者可以修改安装显示名、查看详情、断开连接和删除安装记录。
- 具有
channel:bind权限的成员可以配置或修改安装显示名。 - 具有
channel:delete权限的成员可以查看详情、断开连接和删除安装记录。 - 具有
channel:unbind-user权限的成员可以解绑渠道账号；self_only只能解绑自己的绑定，any可以解绑安装下的任意绑定。默认只有 owner 和 admin 获得any规则。 - 没有管理权限的成员仍可看到安装记录，但不能进入详情或执行管理操作。
安装详情包含已绑定用户、待绑定用户、外发消息记录和入站审计。入站审计只展示渠道类型、外部会话标识、事件类型、丢弃原因和时间，不展示原始消息正文或凭据。
智能体回复、工单状态变化和工单评论会先进入外发记录，再由当前维持渠道连接的服务实例发送。发送失败的记录会保留状态和错误信息；只有未过期的失败记录可以手动重发。绑定提示也有有效期，过期后不会继续发送。
断开安装会取消尚未发送的外发任务；删除安装会同时删除其外发记录、入站审计和绑定数据。删除后，原外部会话不能继续通过该安装发送消息。
自定义 HTTP 桥接
在「设置 → 集成 → 自定义应用」创建安装，选择负责的智能体或团队，并保存创建后仅显示一次的 Bridge Token 和事件流地址。安装列表和详情可查看状态与消息记录，但不会再次显示令牌。
自定义应用使用安装令牌和持续返回 NDJSON 的 HTTP 事件流。外部中转程序主动打开 GET /api/v1/channel/bridge/stream，向 /api/v1/channel/bridge/messages 提交入站消息，再向 /api/v1/channel/bridge/deliveries/{deliveryId}/result 提交外发结果。Mopheus 不调用中转程序的回调地址。图片和文件通过桥接资源上传与投递下载接口传递。仓库中的 examples/channel-bridge/ 和 scripts/test-channel-bridge.sh 提供示例与测试脚本。
外部用户通过应用发送的一次性 /channel/bind 链接绑定账号；不同自定义安装的用户绑定互不共享。V1 处理新消息，不处理编辑和撤回。外发为至少一次投递，中转程序应按 deliveryId 和 partId 持久记录平台发送结果，避免重试时重复发送。
能力对比
| 能力 | 飞书 | 企业微信 | 钉钉 | 说明 | |
|---|---|---|---|---|---|
| 私聊和群聊文本消息 | 支持 | 支持 | 支持 | 支持 | 群聊消息需要满足平台的 @ 机器人规则（WhatsApp 关联设备 bot 模式支持群聊）。 |
| 群聊 @ 机器人过滤 | 支持 | 支持 | 支持 | 支持 | 企业微信只向机器人推送已触达的群聊消息；钉钉与 WhatsApp（bot 模式）使用 @ 提及或引用规则判断。 |
| 交互式卡片回复 | 支持 | 不支持 | 不支持 | 不支持 | 飞书使用交互式卡片承载 Markdown；企微、钉钉和 WhatsApp 发送格式化文本消息。 |
| 线程回复 | 支持 | 不支持 | 不支持 | 不支持 | 飞书会保留话题和线程标识。 |
| 引用回复和合并转发展开 | 支持 | 不支持 | 不支持 | 仅引用回复 | 飞书补充被引用或转发的内容；WhatsApp 关联设备支持提取引用消息文本与缓存媒体。 |
| 群聊最近上下文预取 | 支持，需要权限 | 不支持 | 不支持 | 不支持 | 仅群聊中 @ 机器人时触发，当前最多预取 10 条。 |
| 平台实时历史消息 | 支持 | 不支持 | 不支持 | 不支持 | 当前只有飞书接入了平台消息列表接口。 |
| 入站图片和文件 | 支持 | 支持 | 支持 | 支持 | 媒体会下载并保存为 Mopheus 附件。 |
| 处理中提示 | 支持 | 不支持 | 支持 | 支持 | 由平台适配器提供。 |
| 消息编辑 | 支持 | 不支持 | 不支持 | 不支持 | 不是所有渠道都支持更新已发送消息。 |
| 流式更新同一张卡片 | 不支持 | 不支持 | 不支持 | 不支持 | 当前都是等待任务结果后一次发送最终消息，不会持续修改同一张卡片。 |
| 账号绑定和工单通知 | 支持 | 支持 | 支持 | 支持 | 使用统一的账号绑定和工单来源关联流程。 |
飞书群聊最近上下文
飞书收到群聊中 @ 机器人的消息后，Mopheus 会尝试从飞书消息列表中获取 触发消息之前的最近消息，并将其作为上下文提供给智能体。当前生产配置的 预取上限为 10 条；触发消息和直接引用的消息不会重复加入最近上下文。
这项能力需要在飞书应用权限管理中授予：
im:message.group_msg如果没有该权限，飞书消息本身仍可正常接收和处理，但最近上下文会被跳过。 这项预取不是读取 Mopheus 已保存的会话消息，而是实时调用飞书接口补充平台侧 的群聊内容。
引用回复、合并转发和最近群聊上下文是三种不同能力。前两者由当前消息显式 携带引用或转发关系时触发；最近上下文只在群聊 @ 机器人时触发。
更多配置步骤请参阅飞书集成、企业微信集成、钉钉集成和WhatsApp 集成。