本产品及文档完善中,如果有什么问题请联系我们:18721583683(同微信)或chaho@qq.com
ITILDesk 支持与钉钉对接，实现钉钉扫码登录、通讯录同步与应用消息通知，将工单流转消息推送到员工钉钉。
对接能力
| 序号 | 能力 | 说明 |
|---|
| 1 | 扫码登录 | 员工使用钉钉扫码登录 ITILDesk |
| 2 | 通讯录同步 | 同步钉钉组织架构与成员到 ITILDesk |
| 3 | 消息通知 | 工单各环节推送钉钉应用消息（工作通知） |
| 4 | 身份关联 | 将钉钉用户与企业内账号自动匹配 |
前置准备
| 序号 | 准备项 | 说明 |
|---|
| 1 | 钉钉开放平台 | 具备应用创建与通讯录权限申请能力 |
| 2 | 应用凭证 | AppKey、AppSecret |
| 3 | 通讯录权限 | 申请通讯录读取权限并获取对应凭证 |
| 4 | 回调配置 | 事件订阅地址（如需要接收钉钉侧事件） |
配置步骤
| 序号 | 步骤 | 操作 |
|---|
| 1 | 创建应用 | 钉钉开放平台 → 应用开发 → 企业内部应用，创建应用 |
| 2 | 获取凭证 | 在应用详情中获取 AppKey 与 AppSecret |
| 3 | 申请权限 | 申请通讯录读取、消息推送等权限并发布上线 |
| 4 | 进入配置页 | ITILDesk 系统设置 → 集成配置 → 钉钉 |
| 5 | 填写凭证 | 填入 AppKey、AppSecret |
| 6 | 配置回调 | 配置事件订阅地址与加解密参数 |
| 7 | 测试与启用 | 【测试连接】通过后，开启同步与通知 |
配置项说明
| 序号 | 配置项 | 说明 |
|---|
| 1 | AppKey | 钉钉应用的唯一标识 |
| 2 | AppSecret | 钉钉应用密钥 |
| 3 | 通讯录凭证 | 通讯录同步专用凭证（如适用） |
| 4 | 事件订阅地址 | 平台生成的回调地址 |
| 5 | 加解密参数 | Token、EncodingAESKey（事件订阅用） |
| 6 | 消息模板 | 工单通知文案模板 |
验证方式
- 【测试连接】返回成功。
- 通讯录同步后成员出现在平台用户管理中。
- 员工使用钉钉扫码可登录平台。
- 触发工单流转，员工钉钉收到工作通知。
注意事项
- 钉钉应用需完成权限申请并发布上线，否则接口调用受限。
- 扫码登录依赖应用的可信域名配置。
- 消息推送使用应用工作通知能力，请确认应用拥有推送权限。
- 企业内应用需配置到对应组织范围，确保目标部门可见。