问卷系统集成企业微信指南
概述
本文档介绍如何将问卷系统与企业微信集成，包括以下内容：
- 在企业微信中自建应用。
- 在问卷系统中配置企业微信。
- 配置同步企业微信账号和组织机构。
- 在企业微信中使用问卷系统并实现自动免登录。
1. 在企业微信中自建应用
步骤 1：进入企业微信管理后台
- 登录 企业微信管理后台。
- 进入“应用管理”模块。
步骤 2：创建自建应用
- 点击“自建应 用”。
- 填写应用信息：
- 应用名称：例如“问卷系统”。
- 应用 Logo：上传符合企业形象的图标。
- 可见范围：选择应用可见的部门或成员。
- 保存后，系统会生成以下重要信息：
- AgentId（应用 ID）
- CorpId（企业微信 ID）
- 应用 Secret（应用密钥）
请妥善保存这些信息，后续需要在问卷系统中配置。
每个企业都拥有唯一的 corpid，获取此信息可在管理后台“我的企业”－“企业信息”下查看“企业 ID”（需要有管理员权限）
步骤 3：设置授权域名
- 进入企业微信管理后台。
- 在“应用管理”中选择刚创建的应用。
- 进入“开发者接口”模块。
- 在**“网页授权及 JS-SDK”**部分，添加可信域名，例如
wj.surveyking.cn。- 作用：可信域名用于确保问卷系统的 JS-SDK 和网页授权功能能够正常调用企业微信的接口。
- 在**“企业微信授权登录”**部分，点击 Web 网页，添加授权回调域，例如
wj.surveyking.cn。- 作用：授权回调域用于实现企业微信的免登录功能，确保用户通过企业微信访问问卷系统时自动完成登录。
- 在**“企业可信 IP”**部分，添加当前服 务器的外网 IP。
- 作用：企业可信 IP 用于限制访问企业微信接口的来源 IP，提升系统安全性。
- 确保问卷系统的域名已经正确配置并保存设置。
配置可信域名是确保问卷系统能够与企业微信安全交互的重要步骤。
2. 在问卷系统中配置企业微信
步骤 1：进入问卷系统的企业微信配置页面
- 登录问卷系统后台。
- 进入“基础设施” -> “第三方登录”模块。
步骤 2：填写企业微信配置信息
- 填写以下字段：
- Appid：企业微信后台生成的企业 ID。
- AgentId：自建应用生成的应用 ID。
- 应用 Secret：自建应用生成的密钥。
- 点击“保 存”并启用配置。
步骤 3：应用启动时添加企业微信的配置参数
java -jar surveyking-server.jar --wx.cp.corpId=企业ID --wx.cp.corpSecret=秘钥 --wx.cp.agentId=应用id
3. 配置同步企业微信账号和组织机构
步骤 1：启用账号和组织同步功能
-
在问卷系统的“基础设施”模块，新建定时任务。
-
配置定时任务：
- 通过 CRON 表达式来设置同步频率（例如
0 0 2 * * ?表示每天凌晨两点自动同步）。 - 处理器名字固定为
weComSyncJob
- 通过 CRON 表达式来设置同步频率（例如
步骤 2：执行首次同步
- 在操作，更多里面点击“执行一次”，系统会开始从企业微信中同步成员账号和组织机构信息。
- 同步完成后，可以在问卷系统的用户管理和组织管理模块中查看同步的数据。
4. 在企业微信中使用问卷系统并实现自动免登录
步骤 1：获取问卷系统的企业微信登录地址
- 在问卷系统的“企业微信集成”模块，获取“企业微信免登录地址”。
- 复制此链接。
步骤 2：配置免登录地址到企业微信应用
- 回到企业微信管理后台。
- 在“应用管理” -> “自建应用”中选择刚创建的应用。
- 设置“应用主页”：将问卷系统的免登录地址粘贴到应用主页配置中。
- 保存配置。
步骤 3：在企业微信中使用问卷系统
- 打开企业微信客户端。
- 在“工作台”中找到刚创建的应用（例如“问卷系统”）。
- 点击进入后，系统会自动登录并跳转到问卷系统的首页。
总结
通过上述配置，问卷系统已成功集成企业微信，实现了账号和组织机构的同步，以及在企业微信中自动免登录的功能。用户可以通过企业微信便捷地访问问卷系统，提高了使用体验和工作效率。