企业微信通道配置

企业微信支持两种接入方式，推荐使用智能机器人模式。

模式	说明	公网 IP	推荐
智能机器人	企微 5.0+ 新能力，WebSocket 长连接	不需要	推荐
自建应用	传统模式，Webhook 回调	需要	-

方式一：智能机器人（推荐）

1. 获取企业 ID

1. 登录 企业微信管理后台
2. 进入「我的企业」->「企业信息」
3. 复制页面中的 企业 ID（CorpID，以 ww 开头）

2. 创建智能机器人

1. 在管理后台进入「应用管理」->「智能机器人」
2. 点击「创建 AI 同事」，填写名称和描述
3. 创建完成后，记录以下信息：
   • Bot ID — 机器人唯一标识
   • Bot Secret — 机器人密钥

3. 在 OpenVort 中配置

登录 OpenVort Web 后台，进入「通道管理」，点击企业微信的「配置」按钮：

字段	值
企业 ID	管理后台复制的 CorpID
Bot ID	创建机器人时获取
Bot Secret	创建机器人时获取

保存后点击「测试连接」，显示成功即可。

环境变量方式：

OPENVORT_WECOM_CORP_ID=ww1234567890abcdef
OPENVORT_WECOM_BOT_ID=aibcQ9yMj...
OPENVORT_WECOM_BOT_SECRET=Dffk1RFkW7...

4. 连接方式

智能机器人模式使用 WebSocket 长连接，OpenVort 启动时自动连接企微服务器，无需配置公网地址或回调 URL。启动后可在「通道管理」中查看运行模式为 websocket。

---

方式二：自建应用

适用于企微 5.0 以下版本或需要更多自定义能力的场景。

1. 创建自建应用

1. 登录 企业微信管理后台
2. 进入「应用管理」->「自建」->「创建应用」
3. 填写应用名称、描述，选择可见范围
4. 创建完成后，在应用详情页获取：
   • AgentId — 应用详情页顶部
   • Secret — 应用详情页中的应用密钥

2. 配置接收消息（可选）

如果需要 Webhook 回调模式接收消息：

1. 在应用详情页 ->「API 接收消息」
2. 设置接收服务器 URL 为：https://your-domain/api/channels/wecom/callback
3. 记录生成的 Token 和 EncodingAESKey

3. 在 OpenVort 中配置

字段	值
企业 ID	管理后台复制的 CorpID
应用 Secret	自建应用的密钥
AgentId	自建应用详情页顶部
回调 Token	API 接收消息中获取（Webhook 模式）
回调 AES Key	API 接收消息中获取（Webhook 模式）

环境变量方式：

OPENVORT_WECOM_CORP_ID=ww1234567890abcdef
OPENVORT_WECOM_APP_SECRET=X8yMw8NvABM...
OPENVORT_WECOM_AGENT_ID=1000006
OPENVORT_WECOM_CALLBACK_TOKEN=your_token
OPENVORT_WECOM_CALLBACK_AES_KEY=your_aes_key

---

特色功能

流式输出

智能机器人模式支持原生 Stream 协议，AI 回复时用户可以实时看到内容逐字输出，而非等待完整回复。此功能无需额外配置。

语音消息

支持接收用户发送的语音消息，通过 ASR 自动转写为文字后交给 AI 处理。需要在 OpenVort 中配置语音识别服务。

通讯录同步

配置自建应用后，可启用企微通讯录同步，自动将企业成员和部门信息导入 OpenVort。在「通道管理」配置中填写 应用 Secret 和 AgentId 即可。

---

常见问题

Q: 智能机器人和自建应用可以同时使用吗？

可以。智能机器人用于消息收发，自建应用可额外提供通讯录同步能力。在 OpenVort 配置中，Bot 模式下展开「自建应用配置（可选）」即可补充填写。

Q: 测试连接失败怎么办？

1. 确认企业 ID、Bot ID、Bot Secret 填写正确
2. 检查网络连通性（OpenVort 服务器需能访问 qyapi.weixin.qq.com）
3. 确认机器人已发布，且当前用户在机器人可见范围内

Q: 消息发送成功但用户收不到？

检查机器人的可见范围设置，确认目标用户在范围内。企微管理后台 ->「智能机器人」-> 选择对应机器人 ->「可见范围」。