微信配置¶
企业微信配置，通过配置的方式，将平台应用绑定企业微信，在企业微信或微信端上面使用平台应用。
域管理 → 微信配置。顶部工具栏仅 保存（滚动下方内容时工具栏保持不动）。同步、测试扫码在对应分组内容区。
分组与字段¶
开启「手工配置模式(企业微信)」后按能力分组。某分组勾选 开启 后，该组字段为必填。
启用企业微信¶
| 字段 | 说明 |
|---|---|
| 企业微信CorpID | 企业微信ID，在企业微信后台企业信息处查看（必填）。 |
| 企业微信认证文件 | 企业微信后台下载的 WW_verify_xxx.txt。上传后可通过 https://域名/WW_verify_xxx.txt 完成可信域名校验。 |
| 外网访问系统地址 | 平台外网访问地址，不支持 IP 方式，微信认证需要已备案域名。 |
双向同步（读/写）通讯录¶
勾选开启后填写 通讯录Secret（企业微信后台通讯录同步 API 处获取）。组内按钮（从左到右）：验证链接、同步本地组织架构到企业微信、从企业微信同步组织架构本地。
单向同步（读）通讯录¶
勾选开启后填写开通通讯录权限的 应用AgentId、应用Secret。组内按钮（从左到右）：验证、从企业微信同步组织架构本地。**验证**用启用组中的 CorpID 与本组应用 Secret 向企业微信换 access_token，成功即通过（不登录、不返回 token）。
扫码登录¶
勾选开启后填写开通扫码登录权限的 应用AgentId、应用Secret、扫码CallbackUrl（格式如 http://www.xxx.com/signon/runtime/login/wxqrcodelogin）。组内 测试扫码 可弹出二维码验证配置，扫完只显示成功/失败，不会登录系统。CallbackUrl 的域名须与企业微信应用「授权回调域」一致。
已启用的软件列表¶
为要进工作台或发消息的软件填写应用 AgentId / Secret，并可生成跳转链接。
配置步骤¶
第一步： 选择「手工配置模式(企业微信)」，填写企业微信 CorpID。
第二步： 如需 OBPM→微信写组织，开启双向同步并填写通讯录 Secret。
第三步： 填写平台外网访问地址。
第四步： 上传企业微信下发的 WW_verify_xxx.txt（在「启用企业微信」组）。
备注： 上传后访问地址为站点根路径
https://域名/WW_verify_xxx.txt。不上传会导致企业微信无法完成可信域名校验，在线拍照/在线录音等 JS-SDK 能力也无法使用。
第五步： 如需微信→OBPM 读组织，开启单向同步并填写开通通讯录权限的应用 AgentId / Secret。
第六步： 如需 PC 扫码登录，开启扫码登录并填写 AgentId / Secret / CallbackUrl；可用 测试扫码 验证。同时须在自建应用中设置企业微信授权登录。
第七步： 配置可信域名（网页授权及 JS-SDK）。
第八步： 在软件列表中配置各应用 AgentId / Secret。
第九步： 生成跳转链接，配置到企业微信菜单或工作台应用主页。
第十步： 点击顶部 保存。
常见问题¶
问：访问应用出现空白页？
答：出现这种情况，可以直接点击企业微信号右上角设置菜单，复制当前链接，然后在手机浏览器中打开，看看是否显示 timeout？如果是，是由于平台或者企业微信号中用户数据没有对应起来导致，例如：平台用户里面用张三这个用户，而企业微信号里面没有张三这个用户所以才会出现这个情况，直接点击对应同步分组内的「从企业微信同步组织架构本地」按钮即可。如果不是，请联系论坛值班同事。
问：测试扫码不出码或扫完失败？
答：请先保存扫码登录配置。CallbackUrl 须含协议和域名，且该域名已配为企业微信应用授权回调域。测试扫码的回调打到该域名下的管理接口，不是本机 Vite 端口。