SolonCode Web 内置了强大的 IM 连接通道。启动 Web 模式后，通过简单的绑定操作，即可在飞书、钉钉或微信的私聊窗口中直接与 SolonCode AI 交互。


核心特性

* **多端同步**：消息在 IM 窗口与 Web 界面实时流转，确保上下文始终一致。
* **一会话多通道**：（以会话为单位）支持一个 SolonCode 会话同时绑定多个 IM 应用，实现多端协同。
* **持久化连接**：系统自动保存凭据，重启 SolonCode 后通道自动恢复，无需重复配置。
* **双向流转**：IM 端发送指令，AI Agent 实时响应；AI 的回复也会精准分发至所有绑定通道。


平台功能对比：

| 平台       | 连接方式    | 绑定方式 |  备注 |
|--------|---------|---------|------|
| **飞书** | WebSocket + Protobuf | App ID + App Secret | 可流式输出（推荐）  |
| **钉钉** | WebSocket | AppKey + AppSecret | 可流式输出（推荐）  |
| **微信** | HTTP 长轮询 | 扫码登录 | 一问一答为好  |





### 1、绑定飞书

基于飞书开放平台的应用凭证（App ID + App Secret）连接，需要先在 [飞书开放平台](https://open.feishu.cn/) 创建一个应用机器人。

#### 前置准备

1. 登录飞书开放平台，创建一个企业自建应用
2. 开启应用的 **机器人** 能力
3. 记录应用的 **App ID** 和 **App Secret**
4. 配置应用的事件订阅方式为 **WebSocket 长连接**

#### 操作步骤

1. 点击飞书连接按钮
2. 填写 App ID 和 App Secret，点击绑定。
3. 在飞书中找到机器人，发送一条消息。<mark>【重要】</mark>

收到第一条消息后，系统自动提取用户身份完成绑定。绑定成功后，前端界面会同步更新状态。



#### 示意图：


<img src="/img/148d11cd8c68485097b92cecdae30d5e.png" width="400" />



### 2、绑定钉钉

基于钉钉开放平台的应用凭证（AppKey + AppSecret）进行连接，需要先在 [钉钉开放平台](https://open-dev.dingtalk.com/) 创建一个机器人应用。

#### 前置准备

1. 登录钉钉开放平台，创建一个企业内部应用
2. 开启应用的 **机器人** 能力
3. 记录应用的 **AppKey** 和 **AppSecret**
4. 配置消息接收模式为 **Stream 模式**

#### 操作步骤

1. 点击钉钉连接按钮
2. 填写 AppKey 和 AppSecret，点击绑定
3. 在钉钉中找到机器人，发送一条消息。<mark>【重要】</mark>

收到第一条消息后，系统自动提取用户身份完成绑定。绑定成功后，前端界面会同步更新状态。




#### 示意图：


<img src="/img/b76833ebea674c1d9d9e2868aa59a4f8.png" width="400" />




### 3、绑定微信

微信通道采用扫码绑定方式，无需任何开发者配置，打开即用。

#### 操作步骤

1. 点击微信连接按钮
2. 用微信扫码（成功后，即绑定当前会话）


微信二维码有时效性，如过期请重新点击连接按钮获取。Token 过期后系统会自动解绑并通知前端。


#### 示意图：


<img src="/img/81b0ad6d94b04a83b29f439537731b2d.png" width="400" />


### 常见问题

**Q: 一个 Web 会话可以同时绑定多个 IM 吗？**

是的。同一个会话可以同时绑定微信、飞书、钉钉，AI 的回复会分发到所有已绑定的通道。

**Q: 重启 SolonCode 后需要重新绑定吗？**

不需要。所有通道的凭据都会持久化到本地，重启后自动恢复。

**Q: 如何解绑？**

在各通道的连接面板中点击「解绑」按钮即可。也可以随时重新绑定新的会话。

**Q: 微信 Token 过期了怎么办？**

系统会自动检测 Token 过期并解绑，前端会收到通知。重新点击连接按钮扫码即可。