钉钉

钉钉接入用于企业身份登录，以及把部门和成员同步到卷王。登录配置、通讯录同步和项目的登录限制分别管理。

配置入口

管理员进入 基础设施 → 配置管理 → 第三方登录 → 钉钉登录，点击编辑。

卷王字段	填写内容
Client ID	钉钉企业内部应用的客户端标识
Client Secret	同一应用的密钥
Corp ID	钉钉企业的组织标识
开启状态	完成配置后启用

截图中的应用未启用，凭据未填写。

在钉钉准备应用

1. 在 钉钉开放平台创建企业内部应用，取得应用凭据和企业 CorpId。
2. 为需要的功能申请权限。组织同步调用部门列表和成员列表接口，必须同时开放相应通讯录权限及应用可见范围。
3. 配置网页应用首页为实际卷王地址，例如 https://survey.example.com。按发起登录时的实际回调地址登记安全设置，测试域名与正式域名分别登记。
4. 发布应用版本，确认测试成员处于应用可见范围。
5. 在卷王保存对应配置，再从钉钉客户端打开应用验证登录。

具体授权和应用发布流程参见钉钉网页应用免登说明。

同步部门与用户

在 基础设施 → 定时任务 新建任务，选择钉钉同步处理器 dingtalkSyncJob。

处理器参数	含义
留空或 dept,user	同步部门与用户，适合首次接入
dept	仅同步部门
user	仅同步用户；仍需要读取部门列表来遍历成员

先执行一次，查看任务日志，再到 系统管理 → 部门管理、用户管理 核对结果。确认无误后设置同步周期。同步创建的普通用户不会因此自动获得管理员权限。

项目中如何使用

需要按员工身份回收时，在项目 设置 → 回收设置 配置登录限制。把填写链接放入钉钉应用或发送给成员；成员账号需要已同步或完成绑定。匿名问卷不会因为配置了钉钉，就自动变成实名问卷。

排查顺序

• 没有登录入口：检查是否启用配置，并刷新登录页。
• 授权失败：核对应用凭据、回调地址、应用发布状态和成员可见范围。
• 同步为空或失败：查看定时任务日志，检查通讯录权限、企业标识和接口访问条件。
• 已授权但无法进入项目：检查卷王账号状态、项目登录限制和白名单。