# IM 双向通信

IM 双向通信让智能体接入企业微信、飞书或 Slack。用户在 IM 中发送消息，智能体在原会话中回复，也可以处理平台支持的文件并返回产物。在 MOI 中打开对应会话，可查看对话记录和处理结果；文件收发需要平台支持并授予相应权限。

## 支持的平台

本期开放三个平台的长连接接入方式。长连接由 MOI 主动维护，无需公网域名、回调 URL 或工具实例。

| 平台 | 接入方式 | 需要准备 | 详细步骤 |
| --- | --- | --- | --- |
| 企业微信智能机器人 | 长连接 | 企业微信账号（扫码授权） | [企业微信配置指南](wecom.md) |
| 飞书应用机器人 | 长连接 | App ID、App Secret | [飞书配置指南](feishu.md) |
| Slack App / Bot | 长连接 | App ID、App-Level Token、Bot Token | [Slack 配置指南](slack.md) |

## 与「工具库」的区别

[工具库](../../tools/index.md)中的飞书、企业微信、Slack 工具用于「智能体主动调用平台能力」，例如发送应用消息、查询通讯录；IM 双向通信用于「平台用户主动找智能体对话」。前者需要创建工具实例并绑定到智能体，后者只需要在本页完成连接配置，两者互不影响。

## 前置条件

- 目标智能体已存在，且当前工作区至少有一个可用的智能体对话模型；配置连接时需要为该智能体选择运行模型。
- 企业微信：准备可登录的企业微信账号，用于扫码并确认授权。
- 飞书或 Slack：具备在对应平台创建和配置应用的权限。

## 配置入口

1. 在顶部切换到**智能体**，再在左侧点击**智能体**，打开智能体列表。
2. 找到目标智能体卡片，点击卡片右上角的**⋯**菜单，选择**IM 双向通信**。

```{figure} /assets/images/agents/guide-5-hd/im-connection-entry.png
:alt: 在 MOMO 超级智能体卡片右上角的更多操作菜单中选择 IM 双向通信。
:class: agent-guide-image
:figclass: agent-guide-shot

在目标智能体卡片的更多操作菜单中打开 IM 双向通信。
```

打开配置窗口后，选择平台。企业微信使用扫码授权；飞书和 Slack 按各自配置指南填写凭据。选择运行模型后，点击**保存并继续**，进入**启用平台长连接**步骤。

保存后，MOI 开始建立长连接。**连接已建立**表示连接已接通；**已收到真实消息**表示 MOI 已收到来自 IM 的消息。向机器人发送一条测试消息，并在原会话中确认收到智能体回复，才能验证完整的对话过程。连接状态与常见问题的处理方法见[连接状态与问题排查](troubleshoot.md)。

## 连接后的使用

配置完成后即可在 IM 私聊、群聊中与智能体对话：发送文本和文件、使用 `!moi` 会话命令、接收智能体生成的产物。详见[连接后的使用方式](usage.md)。

```{toctree}
:maxdepth: 1
:hidden:

企业微信配置指南 <wecom>
飞书配置指南 <feishu>
Slack 配置指南 <slack>
连接后的使用方式 <usage>
连接状态与问题排查 <troubleshoot>
```