Skip to main content

钉钉

钉钉集成适合在企业内部统一身份体系下使用卷王。配置完成后，员工可以从钉钉工作台免登录进入系统，也可以在钉钉内打开问卷链接并完成免登录答题。

使用场景​

  • 员工从钉钉工作台直接进入卷王
  • 把钉钉用户和组织机构同步到卷王
  • 内部问卷、考试、测评需要按钉钉成员身份登录答题

配置前准备​

先准备好卷王系统主页地址，例如：

http://192.168.1.5:8000

正式环境建议使用 HTTPS 域名。内网测试时，要确保使用钉钉的电脑或手机能够访问这个地址。

你还需要准备：

  • 钉钉企业管理员或开发者权限
  • 可创建企业内部应用的钉钉组织
  • 卷王后台管理员账号

操作步骤​

1. 在钉钉管理后台创建应用​

登录 钉钉管理后台，进入应用列表，创建企业内部应用。

1782185852821

点击 添加。

1782185808176

2. 获取应用凭证​

应用创建完成后，进入 应用设置，点击 去开发。

1782185872717

在应用首页记录以下信息：

  • Client ID
  • Client Secret

Client Secret 是应用密钥，只需要填写到卷王后台，不要泄露给普通用户或写入公开页面。

1782185918383

在管理后台右上角点击企业图标，下拉菜单中可以查看 CorpId。

1782186170754

3. 配置安全设置中的重定向 URL​

进入应用的 安全设置，在 重定向 URL（回调域名） 中添加卷王系统地址。

例如：

http://192.168.1.5:8000

正式环境填写实际访问域名，例如：

https://survey.example.com

如果测试环境和正式环境地址不同，需要分别添加。多个重定向 URL 可以按钉钉页面提示使用英文分号分隔。

1782188315028

4. 开通接口权限​

进入应用的权限管理页面，开通通讯录和基础能力相关权限。建议至少添加以下权限：

  • Contact.User.Read
  • qyapi_get_department_list
  • qyapi_get_member
  • qyapi_get_department_member
  • open_app_api_base
  • qyapi_base

输入权限码后，逐个点击开通。如果钉钉后台提示需要管理员审批，请先完成审批再继续。

1782186103262

5. 添加网页应用能力​

进入应用能力配置，添加 网页应用。这个能力用于在钉钉客户端中打开卷王并完成免登录。

1782186218982

网页应用创建完成后，配置应用首页地址。这里填写前面准备好的卷王系统主页地址，例如：

https://survey.example.com

内网测试时，也可以填写能够被钉钉客户端访问的内网地址。

1782186274821

6. 发布应用版本​

钉钉应用的设置需要发布版本后才会生效。权限、首页地址和网页应用能力都配置完成后，发布一次新版本。

1782186330252

7. 在卷王后台填写钉钉配置​

登录卷王后台，进入 基础设施 → 配置管理 → 第三方登录，打开钉钉配置。

填写刚才获取到的：

  • Client ID
  • Client Secret
  • CorpId

保存配置后，确认钉钉登录已启用。

1782186426746

8. 同步用户和组织机构​

如果需要把钉钉通讯录同步到卷王，进入 基础设施 → 定时任务，新建钉钉同步任务。

常用配置：

  • 任务名称：钉钉同步
  • 处理器的名字：dingtalkSyncJob
  • 处理器的参数：留空即可同步部门和用户；也可以填写 dept,user
  • CRON 表达式：按实际需要设置，例如每天早上同步一次

1782186509514

任务创建完成后，在操作中选择 执行一次，可以立即开始同步。

1782186534220

同步完成后，可以到 用户管理 和 组织机构 中查看同步结果。通过钉钉同步创建的用户，默认授予普通角色；如需管理权限，可以在用户管理中单独调整。

1782186641463

9. 添加到钉钉工作台​

回到钉钉工作台，在 全员常用 中添加刚才创建的自建应用。

1782186736633

添加完成后，员工点击该应用即可从钉钉进入卷王。如果用户已经同步并绑定到卷王账号，系统会自动完成登录。

1782186777389

10. 在钉钉内免登录答题​

问卷发布后，在问卷设置中开启登录限制。员工在钉钉内打开问卷链接时，可以使用钉钉身份免登录答题。

1782186929178

常见问题​

钉钉工作台打开应用后没有自动登录怎么办？

先检查钉钉应用是否已经发布版本，再检查网页应用首页地址、Client ID、Client Secret、CorpId 是否和卷王后台配置一致。同时确认用户是在钉钉客户端内打开应用，而不是复制链接到普通浏览器打开。

如果仍然无法自动登录，还需要检查 安全设置 中的 重定向 URL（回调域名） 是否已经添加卷王系统地址。

同步任务执行后没有用户或部门怎么办？

优先检查通讯录权限是否已经开通并审批通过，尤其是 qyapi_get_department_list、qyapi_get_member 和 qyapi_get_department_member。然后确认定时任务处理器名称是 dingtalkSyncJob，处理器参数留空或填写 dept,user。

只想同步用户或只想同步部门可以吗？

可以。处理器参数填写 user 时只同步用户，填写 dept 时只同步部门。首次接入建议使用留空或 dept,user，先把组织和用户一起同步完整。

为什么钉钉内打开问卷链接仍然要求登录？

确认问卷已经开启登录限制，并且链接是在钉钉客户端内打开。还需要检查当前钉钉成员是否已经同步到卷王，或是否已经和卷王账号完成绑定。

相关链接​