聊天集成

聊天集成让团队不用打开 Multica，也能直接向智能体提问、在群聊中 @它，或从聊天窗口创建 issue。

目前支持飞书/Lark、Slack、钉钉和企业微信。它们使用相同的会话、身份和执行机制，但安装方式不同。

选择平台

新连接目前只开放中国大陆版飞书；已有的国际版 Lark 连接仍可继续使用和管理。

每个 Bot 绑定一个 Multica 智能体。需要在同一个聊天平台中使用多个智能体时，要分别连接多个 Bot。

钉钉和企业微信由社区维护：随每个版本发布，但没有官方支持 SLA。遇到问题请提交 GitHub issue。

企业微信目前只处理文字消息。语音、图片和文件消息会收到一句说明，不会转交给智能体。

详细步骤：

• 飞书 / Lark Bot 接入
• Slack Bot 接入
• 钉钉 Bot 接入

消息的执行流程

1. Multica 根据 Bot 找到对应的工作区和智能体。
2. 在群聊或频道中，只有明确 @ Bot 的消息会继续处理；私聊不需要 @。
3. Multica 校验发送者的账号绑定和工作区成员身份。
4. 消息进入一段智能体对话，并创建一次执行任务。
5. 智能体的回复回到原来的私聊或讨论串。

没有 @ Bot 的频道消息不会触发智能体，也不会被加入它的对话上下文。

普通消息按上述流程处理。/issue 是命令，不是对话轮次：Multica 会在原平台返回处理结果，但不会把命令加入 Multica Chat。Slack 原生 slash 命令仍按独立的异步创建任务流程处理。

会话隔离

• 飞书/Lark 按聊天区分会话；同一个聊天中的后续消息会继续原会话。
• Slack 私聊按频道区分；频道中的每个 thread 分别保存一段会话。
• 钉钉按 conversation 区分会话；每个单聊或群聊分别延续自己的会话。
• 企业微信按聊天区分会话；每个单聊或群聊分别延续自己的会话。

在频道中继续追问时仍需再次 @ Bot。智能体只收到发给自己的消息，不会自动读取整个频道的历史。

账号绑定

成员第一次向 Bot 发消息时，会收到一个账号绑定链接。登录 Multica 后，平台账号与当前工作区成员关联。

绑定完成后，Multica 才会运行智能体。每条消息都会重新检查账号绑定和工作区成员身份；离开工作区后，不能继续通过 Bot 使用它。

管理连接

工作区 owner 和 admin 可以连接或断开 Bot；飞书/Lark Bot 的连接和断开还对智能体所有者开放。普通成员可以查看已经连接的集成并使用自己有权调用的智能体。

断开后，Bot 不再接收新消息。已有的 Multica 对话和执行记录仍然保留。

自托管

自托管部署需要先为对应平台配置一个 32 字节加密密钥，Multica 才会开放连接入口：

MULTICA_LARK_SECRET_KEY=<base64 编码的 32 字节密钥>
MULTICA_SLACK_SECRET_KEY=<base64 编码的 32 字节密钥>
MULTICA_DINGTALK_SECRET_KEY=<base64 编码的 32 字节密钥>
MULTICA_WECOM_SECRET_KEY=<base64 编码的 32 字节密钥>

这些密钥用于加密保存 Bot 凭据。生成、保存和轮换方法见环境变量。Multica Cloud 已完成这项配置。

企业微信还要求后端只部署单个副本：它的出站只有一条路径，即某个进程持有的 WebSocket，因此在其他副本上产生的回复会被丢弃。在跨副本出站路由实现之前，请不要对启用企业微信的后端做多副本部署。

接下来

• 飞书 / Lark Bot 接入
• Slack Bot 接入
• 钉钉 Bot 接入
• 与智能体对话