Skip to main content

企业微信

企业微信集成适合在企业内部统一身份体系下使用卷王,支持自建应用、组织同步和企业微信内免登录。

使用场景

  • 员工在企业微信工作台中直接打开问卷系统
  • 把企业微信成员和组织架构同步到卷王
  • 让内部问卷、考试、审批类场景统一走企业身份体系

操作步骤

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

登录 企业微信管理后台,进入 应用管理,创建自建应用。

1736301163683

创建完成后,记录这些关键信息:

  • AgentId
  • CorpId
  • 应用 Secret

其中 CorpId 也可以在 我的企业企业信息 中查看。

1736301675007

2. 配置可信域名和授权信息

进入应用的开发者接口设置,补齐以下配置:

  • 网页授权及 JS-SDK 的可信域名
  • 企业微信授权登录 的回调域
  • 企业可信 IP

这样做的目的,是确保卷王能安全地调用企业微信登录和 JS-SDK 能力。

3. 在卷王后台填写企业微信配置

进入卷王后台的 基础设施配置管理第三方登录,打开企业微信配置页面。

1752646554999

填写:

  • Appid / 企业 ID
  • AgentId
  • Secret

如果你的部署方式是命令行启动,也可以通过启动参数传入:

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

4. 同步账号和组织机构

如果你希望卷王里的用户和组织结构自动跟企业微信保持一致,可以新建同步任务。

常见做法:

  • 在基础设施里新建定时任务
  • 处理器名称使用 weComSyncJob
  • 通过 CRON 设置同步频率

1736312172177

首次配置完成后,可以先手动执行一次,确认同步结果。

1736312225544

5. 配置企业微信内免登录

在卷王中获取企业微信免登录地址后,把它填到企业微信应用主页。

之后员工在企业微信工作台中打开该应用,就可以直接进入卷王系统。

常见问题

企业微信集成只做登录,不做组织同步可以吗?

可以。登录和组织同步不是强绑定关系,你可以先完成登录接入,再决定是否需要同步组织架构。

为什么企业微信内打开后没有自动登录?

通常要检查应用主页、授权回调域、可信域名和后台配置是否一致,其中任一配置错误都可能导致免登录失败。