企业微信基础配置

Forge Admin 支持与企业微信集成，实现组织架构同步和消息推送。

前置准备

1. 登录企业微信管理后台
2. 获取企业 ID（CorpID）
3. 创建自建应用，获取 AgentId 和 Secret

配置企业 ID 和 Secret

1. 进入 Forge Admin「系统管理」→「第三方配置」→「企业微信」
2. 填写以下信息：

字段	说明	获取位置
企业 ID	CorpID	我的企业 → 企业信息
应用 Secret	Secret	应用管理 → 自建应用
AgentId	应用 ID	应用管理 → 自建应用
Token	回调 Token	自建应用 → 接收消息 → 设置 API 接收
EncodingAESKey	加密密钥	同上

3. 点击保存

配置回调 URL

企业微信服务器通过回调 URL 向 Forge 推送事件（如通讯录变更）。

回调地址

https://your-domain.com/api/wecom/callback

配置步骤

1. 在企业微信管理后台的「接收消息」页面填写回调 URL
2. 填写 Token 和 EncodingAESKey（与 Forge 配置一致）
3. 点击保存，企业微信会向该 URL 发送验证请求
4. Forge 验证通过后保存成功

回调 URL 必须使用 HTTPS，且域名需在企业微信后台配置为可信域名。

通讯录同步

同步方向

方向	说明
企业微信 → Forge	从企业微信拉取组织架构到 Forge
Forge → 企业微信	将 Forge 的部门/用户推送到企业微信

配置通讯录同步

1. 在企业微信后台开启「通讯录同步」API 权限
2. 获取通讯录同步 Secret
3. 在 Forge 配置中填入同步 Secret
4. 设置同步策略：

策略	说明
全量同步	每次同步全部部门和用户
增量同步	仅同步变更部分
定时同步	按设定频率自动同步

手动同步

1. 进入「企业微信配置」页面
2. 点击「立即同步」
3. 查看同步日志确认结果

消息推送

配置完成后，Forge 的消息中心可以通过企业微信推送消息：

1. 进入「消息中心」→「消息渠道」
2. 新增企业微信渠道
3. 配置推送目标和模板
4. 消息触发时自动推送到企业微信

验证配置

# 测试企业微信连接
curl -s http://localhost:8580/system/wecom/test \
  -H "Authorization: Bearer $TOKEN" | jq .

# 返回成功说明配置正确

下一步

• 消息渠道配置
• 社交登录配置