跳到主要内容

问卷系统集成企业微信指南

概述​

本文档介绍如何将问卷系统与企业微信集成，包括以下内容：

  1. 在企业微信中自建应用。
  2. 在问卷系统中配置企业微信。
  3. 配置同步企业微信账号和组织机构。
  4. 在企业微信中使用问卷系统并实现自动免登录。

1. 在企业微信中自建应用​

步骤 1：进入企业微信管理后台​

  1. 登录 企业微信管理后台。
  2. 进入“应用管理”模块。 1736301163683

步骤 2：创建自建应用​

  1. 点击“自建应用”。
  2. 填写应用信息：
    • 应用名称：例如“问卷系统”。
    • 应用 Logo：上传符合企业形象的图标。
    • 可见范围：选择应用可见的部门或成员。
  3. 保存后，系统会生成以下重要信息：
    • AgentId（应用 ID）
    • CorpId（企业微信 ID）
    • 应用 Secret（应用密钥）

请妥善保存这些信息，后续需要在问卷系统中配置。

每个企业都拥有唯一的 corpid，获取此信息可在管理后台“我的企业”－“企业信息”下查看“企业 ID”（需要有管理员权限）

1736301675007

步骤 3：设置授权域名​

  1. 进入企业微信管理后台。
  2. 在“应用管理”中选择刚创建的应用。
  3. 进入“开发者接口”模块。
  4. 在**“网页授权及 JS-SDK”**部分，添加可信域名，例如 wj.surveyking.cn。
    • 作用：可信域名用于确保问卷系统的 JS-SDK 和网页授权功能能够正常调用企业微信的接口。
  5. 在**“企业微信授权登录”**部分，点击 Web 网页，添加授权回调域，例如 wj.surveyking.cn。
    • 作用：授权回调域用于实现企业微信的免登录功能，确保用户通过企业微信访问问卷系统时自动完成登录。
  6. 在**“企业可信 IP”**部分，添加当前服务器的外网 IP。
    • 作用：企业可信 IP 用于限制访问企业微信接口的来源 IP，提升系统安全性。
  7. 确保问卷系统的域名已经正确配置并保存设置。

配置可信域名是确保问卷系统能够与企业微信安全交互的重要步骤。

2. 在问卷系统中配置企业微信​

步骤 1：进入问卷系统的企业微信配置页面​

  1. 登录问卷系统后台。
  2. 进入“基础设施” -> “第三方登录”模块。

1736302921832

步骤 2：填写企业微信配置信息​

  1. 填写以下字段：
    • Appid：企业微信后台生成的企业 ID。
    • AgentId：自建应用生成的应用 ID。
    • 应用 Secret：自建应用生成的密钥。
  2. 点击“保存”并启用配置。

步骤 3：应用启动时添加企业微信的配置参数​

java -jar surveyking-server.jar --wx.cp.corpId=企业ID --wx.cp.corpSecret=秘钥 --wx.cp.agentId=应用id

3. 配置同步企业微信账号和组织机构​

步骤 1：启用账号和组织同步功能​

  1. 在问卷系统的“基础设施”模块，新建定时任务。

  2. 配置定时任务：

    • 通过 CRON 表达式来设置同步频率（例如 0 0 2 * * ? 表示每天凌晨两点自动同步）。
    • 处理器名字固定为 weComSyncJob

    1736312172177

步骤 2：执行首次同步​

  1. 在操作，更多里面点击“执行一次”，系统会开始从企业微信中同步成员账号和组织机构信息。
  2. 同步完成后，可以在问卷系统的用户管理和组织管理模块中查看同步的数据。

1736312225544

4. 在企业微信中使用问卷系统并实现自动免登录​

步骤 1：获取问卷系统的企业微信登录地址​

  1. 在问卷系统的“企业微信集成”模块，获取“企业微信免登录地址”。
  2. 复制此链接。

步骤 2：配置免登录地址到企业微信应用​

  1. 回到企业微信管理后台。
  2. 在“应用管理” -> “自建应用”中选择刚创建的应用。
  3. 设置“应用主页”：将问卷系统的免登录地址粘贴到应用主页配置中。
  4. 保存配置。

步骤 3：在企业微信中使用问卷系统​

  1. 打开企业微信客户端。
  2. 在“工作台”中找到刚创建的应用（例如“问卷系统”）。
  3. 点击进入后，系统会自动登录并跳转到问卷系统的首页。

总结​

通过上述配置，问卷系统已成功集成企业微信，实现了账号和组织机构的同步，以及在企业微信中自动免登录的功能。用户可以通过企业微信便捷地访问问卷系统，提高了使用体验和工作效率。