# 集成钉钉

URL: https://docs.ones.cn/admin/account-integration/third-party-integration/dingtalk

# 1.集成能力

通过自建应用集成钉钉后，支持：

| 功能名称 | 功能说明 |
| --- | --- |
| 用户目录同步 | 同步钉钉组织架构至ONES，实现统一账号管理 |
| 登录验证 | 通过钉钉登录到ONES，实现安全快捷地单点登录 |
| 消息通知 | ONES消息通知到钉钉，并点击查看详情页面 |

# 2.功能入口

管理员可在【配置中心】页面，点击「添加账号集成」并选择「钉钉」进行添加集成配置。

![集成钉钉 配图 1](https://docs.ones.cn/assets/images/f1bca6219af60d95-565ee0b66922d1d08bc0b6c2e77f1347.png)

# 3.添加集成流程

### 3.1新建钉钉应用

打开系统的钉钉配置页面，同时进入 [钉钉开发者后台](https://open-dev.dingtalk.com/) ，点击「应用开发」>「创建应用」，应用名称等信息可按需自行填写。

![集成钉钉 配图 2](https://docs.ones.cn/assets/images/3d6f5a120eb45f81-294b90e55475bb673db95448c2334a41.png)

### 3.2创建后，选择网页应用进入

![集成钉钉 配图 3](https://docs.ones.cn/assets/images/329d4cb9d5c6d380-b1e0dcd57da21e56380d696c1edd5f50.png)

### 3.3配置应用首页与回调地址

- 配置应用首页地址与PC端首页地址
1. 打开钉钉应用的「网页应用」
2. 将系统后台的「应用首页地址」，复制至钉钉应用的「应用首页地址」和「PC端首页地址」中，保存生效
![集成钉钉 配图 4](https://docs.ones.cn/assets/images/5c35fb28c58b04da-84868e5f3ef46a451361409597e8ffc4.png)

- 配置安全设置
1. 打开钉钉应用的「安全设置」
2. 将系统后台的「授权回调域」，复制至钉钉应用的「重定向URL（回调域名）」中，保存生效
![集成钉钉 配图 5](https://docs.ones.cn/assets/images/09002be8872accdd-82d713c2762e401c9b7ddc227d5d5cc2.png)

### 3.4配置应用权限

进入「权限管理」，申请获取以下权限：

通讯录个人信息读权限

调用SNS API时需要具备的基本权限

邮箱等个人信息

成员信息读权限

企业员工手机号信息

通讯录部门信息读权限

通讯录部门成员读权限

企业已安装的应用列表查询权限

![集成钉钉 配图 6](https://docs.ones.cn/assets/images/50bdd4f2c35a885e-a325827ddb9ffd1c8cea1d5459e04276.png)

### 3.5发布应用版本

进入「版本管理与发布」，创建新版本，按需配置应用可见范围，保存并发布应用

![集成钉钉 配图 7](https://docs.ones.cn/assets/images/80be666dcbc8cf60-52c64f711272d981746714bf77544a99.png)

### 3.6将发布后的应用凭证信息复制粘贴至系统中

![集成钉钉 配图 8](https://docs.ones.cn/assets/images/523355b07ea4a5b2-a230c65714c1c2611cff9caa7f5bb794.png)

### 3.7用户属性映射

![集成钉钉 配图 9](https://docs.ones.cn/assets/images/adc69bbf16292933-603806c51aaab6a1470a4e6877d4d8ad.png)

目前系统支持同步的字段包含：用户名、邮箱、工号、公司、职位，对应钉钉用户属性值见： [用户信息](https://open.dingtalk.com/document/orgapp/user-information-update)

注意确认企业分辨当前在钉钉中使用的是「员工邮箱：email」还是「企业邮箱：org_email」，并填入「钉钉用户属性-邮箱」

### 3.8点击添加，可开启集成相关功能

![集成钉钉 配图 10](https://docs.ones.cn/assets/images/df79d855a7db8ae1-56ea1b0de310924580506157a3db9992.png)

# 4.使用集成

### 4.1开启「用户目录同步」与「登录验证」后

##### 4.1.1ONES获取邮箱，根据邮箱进行「新成员账号自动创建」或「现有成员账号自动绑定」

- 当该邮箱在组织中无匹配邮箱，将进行「新成员账号自动创建」
- 当该邮箱在组织中有匹配邮箱，将进行「现有成员账号自动绑定」

##### 4.1.2「成员管理」页面：将出现「已激活成员」并归属对应「钉钉组织架构树中」

![集成钉钉 配图 11](https://docs.ones.cn/assets/images/fc990d5143ca6c5c-65a4a77849e69b7b9d4d45df904d7532.png)

##### 4.1.3成员首次登录

不管首次登录发生在「4.1.3中的任意登录路径」（下图以浏览器访问登录链接为例）

- 进行「现有成员账号自动绑定」的账号，成员可直接登入系统
- 进行「新成员账号自动创建」的账号，成员需完成「验证邮箱」后，才可登入系统
![集成钉钉 配图 12](https://docs.ones.cn/assets/images/e73510f3833efea0-8be39d3aae8175b9df4b6943d90ba22f.png)

##### 4.1.4登录路径

成员可通过以下路径进行钉钉登录：

- 浏览器访问登录链接（登录链接可在集成页面复制）
- 浏览器访问组织中的工作项或wiki链接
- 钉钉PC客户端应用访问「消息通知」或「应用主页」
- 钉钉移动客户端应用访问「消息通知」或「应用主页」

### 4.2开启消息通知后

开启钉钉消息通知后，还需要在对应ONES Project和ONES Wiki业务中勾选对应的通知方式，详见 [消息通知](https://docs.ones.cn/admin/account-integration/what-is-account-integration/notifications/)