企业微信

企业微信接入包括身份登录、组织与成员同步、应用消息。当前后台将扫码登录和应用服务放在同一配置卡片中，网页登录另有独立卡片。

当前配置入口

进入 基础设施 → 配置管理 → 第三方登录，编辑 企业微信（扫码登录与应用服务）。

字段	内容
企业 ID（CorpId）	企业微信的企业标识
Client Secret	自建应用的 Secret
Agent ID	同一自建应用的 AgentId
开启状态	控制该配置是否可用

扫码登录、部门与成员同步、应用消息共用此配置。关闭后这些能力均不可用；修改后在后续调用中生效。企业微信（网页登录） 是另一项配置，需要使用时也要按其字段配置。

接入步骤

1. 登录企业微信管理后台，创建自建应用，取得 CorpId、AgentId 和应用 Secret。
2. 按所用能力配置应用可见范围、网页授权可信域名、授权登录回调域和企业可信 IP。
3. 在卷王填入同一企业和应用的参数，启用并保存。
4. 配置应用主页为实际可访问的卷王地址，使用可见范围内的测试成员验证。

外部平台配置要求以企业微信开发文档为准。不要把应用 Secret 放入应用主页 URL 或问卷参数。

组织与成员同步

在 基础设施 → 定时任务 新建企业微信同步任务，处理器为 weComSyncJob。

• 参数留空或 dept,user：同步部门和用户。
• 参数 dept：只同步部门。
• 参数 user：只同步用户；同步过程仍会读取部门信息。

首次先手动执行一次，查看任务日志，再核对 系统管理 → 部门管理、用户管理。之后根据组织变动频率安排周期。应用可见范围或通讯录权限不足时，不能把“任务已执行”理解为全员都已同步。

项目内使用

内部问卷在 设置 → 回收设置 中启用登录限制，再按需要配置白名单。应用消息属于通知能力，仍需单独配置模板、接收范围和触发规则，参见消息通知。

故障检查

先核对企业 ID、AgentId 和 Secret 是否来自同一应用，再检查可信域名、服务器出口 IP、应用可见范围及通讯录权限。网页登录失败时还要检查独立的网页登录配置，不能仅检查扫码登录卡片。