如何配置钉钉通讯录与飞跨浏览器自动同步-帮助中心-飞跨浏览器

## 1 钉钉和飞跨同步流程

### 1.1 创建钉钉企业自建应用

1.搜索“[钉钉开放平台](https://open.dingtalk.com/)”或者点击链接注册或者登录”[钉钉开发者后台](https://login.dingtalk.com/oauth2/challenge.htm?redirect_uri=https%3A%2F%2Fopen-dev.dingtalk.com%2Fdingtalk_sso_call_back%3Fcontinue%3Dhttps%3A%2F%2Fopen-dev.dingtalk.com%2F%3Fspm%3Ddd_developers.header.unLogin.openDevBtn&response_type=code&client_id=dingbakuoyxavyp5ruxw&scope=openid+corpid)”首页，点击【应用开发】，在"钉钉应用"列表页，点击【创建应用】；

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a60709c486a81f6b40b9ee6dcf0a336e05d39716f3aac30742b7c44c4320cecf002f1d67d9e4183fd401a2852dcf9d14f.png?imageSlim)

2.在弹出创建应用填写页面，按要求填写【应用名称】和【描述】，点击保存即可成功创建应用。

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a473a1bc8310192c0c47605cf80df2fd0ed0190faae21f7547ef7b75c1f2e294da1e90d65e4e145dfe16be4563e95daa9.png?imageSlim)

### 1.2 应用权限开通申请

1.应用创建成功后，会自动进入该应用详情页面，选择【权限管理】，权限范围选择【全部员工】，点击通讯录管理，勾选需要开通的权限，请详细核对并开通，缺少权限将导致部分业务数据无法同步，勾选后点击“批量申请”，系统提示“申请成功”，则完成应用权限开通申请。

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602aaac77b6f1abe50df5980852e4081084143d4f1dcee6001502f18992d7bcc2c220bd49c5d39984b9d4b85285356a2889e.png?imageSlim)

| 分类       | 权限名称             | 说明                                                         |
| ---------- | -------------------- | ------------------------------------------------------------ |
| 通讯录管理 | 企业员工手机号信息   | 必须勾选，用于短信通知账号初始密码及在飞跨创建的账号绑定登录手机号 |
|            | 通讯录部门信息读权限 | 必须勾选                                                     |
|            | 成员信息读权限       | 必须勾选                                                     |
|            | 通讯录部门成员读权限 | 必须勾选                                                     |

2.点击批量申请之后会跳出敏感权限申请确认，继续点击【去申请】，选择管理员，即可申请成功。

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a7a5c135778ee098caf1ea10e6bacb695bbd5c73ff8c3371d1f2601aeadbe33c54c8306593bde46ea0a1c57124a4e6e2d.png?imageSlim)

### 1.3 记录同步关键参数值（飞跨浏览器要求填写的同步参数）

1.记录所属组织的CorpId：进入钉钉开放平台首页，复制CorpID

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602afc228fb22ff2c4af22cb46abe5fe8277be266fc4b68e6c2f092efa448b0cb65fa104914c77ee711a8a09b0dfd929b0ca.png?imageSlim)

2.应用创建成功后，点击【应用开发】→【钉钉应用】，找到创建的应用，点击右边三点按钮选择【应用详情】。

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a27905087190dd0b92d019dd35607ce3f396b12dc667874944259cc786ec093d59d016c6fb2f32e8e04225a0469254077.png?imageSlim)

3.在应用详情列表页面，点击【凭证与基础信息】，复制相应的参数值：记录创建成功应用的AgentId、Client ID (原 AppKey 和 SuiteKey)、Client Secret (原 AppSecret 和 SuiteSecret)

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a0d50ecb3f30f832e90c505ccc9412e9557b066790c71dd2dc9cd3ff66b3e4bcc5e04e29cb90f91699188bc44e67e8d23.png?imageSlim)

### 1.4 添加机器人复制相应的参数值

1.在应用详情列表页面，点击【添加应用能力】添加机器人；

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a822951806323f8962ea911fc4fa10d61811b3b221b7b8262b5f5a5c9ddf1391f5acc138e7e05ffa18253e42fbd32af84.png?imageSlim)

2.配置机器人相关信息并发布

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a822951806323f896064c0cd6a9e1f2dd4f75164a84a3d1a42a44c5dcf325b546d82adaf92b4b98244e7908316c2af781.png?imageSlim)

3.发布成功后，复制 RobotCode

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a0d50ecb3f30f832e1cc6a17f16d306f445a54324930f6309fccf540d7c240bf9c567dedd9d3324d1a7bb4f76959b1ebf.png?imageSlim)

### 1.5 创建版本并发布

1.点击【版本管理与发布】，在右上角点击【创建新版本】；

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602afc228fb22ff2c4aff4564538a3f8a6571dd8c87c209b190bbd98f74846c263c61b296f107fc944220c04013851d258de.png?imageSlim)

2.应用版本号会自动生成，填写版本描述，应用范围可以根据实际情况填写，填完点击保存。

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a822951806323f8969ab79aaee366da29110fe59a3d30ad56b957fe3fb5eb88105ced56ebc26de99c597a456fa8ec4a9d.png?imageSlim)

3.保存后可直接发布，在【版本管理与发布】可以查看到发布的该版本。

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602afa4cc552274ccc03c0a13a22b9740e077e975a1b5c462349e03352a0cbba6973551bbaea21518486501a87a44fca7a61.png?imageSlim)

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a6d6e809e475597e6bf158e123f6548cfcc46fb7851545e6a6cfb1d2a23243f4cb3388f6a880fa854b92acbedd0fb69ec.png?imageSlim)

### 1.6 飞跨浏览器团队管理同步参数配置

1.登录飞跨浏览器在主控台点击【团队管理】→【成员管理】，点击添加成员的右侧下拉箭头，点击【钉钉同步】进行配置；

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a473a1bc8310192c0637801c9995029860ade2e50be6316ca0d85246da55dd0f7d2b033c0233a006441672339097c4663.png?imageSlim)

2.分别按照上面复制的参数值添加相关配置，保存设置。

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a0d50ecb3f30f832e2525495167cae7f65b24fde8898727540af304d19757e60a72635fa329b3b788f121a2eb7310c29a.png?imageSlim)

### 1.7 钉钉开放平台事件与回调设置

飞跨浏览器钉钉同步保存设置后，会出现飞跨的同步参数值，在钉钉开放平台进行”事件与回调配置“，并订阅通讯录事件；

1.在配置事件与回调配置时，需要飞跨提供同步参数![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a0d50ecb3f30f832eeea5d7b8c92cb7e5ba48a26b918029bb367741c4b991f37be6b12ec99f7330a340d8fafc16cd883c.png?imageSlim)

| **字段**     | **值**                                           | **说明** |
| ------------ | ------------------------------------------------ | -------- |
| 推送方式     | HTTP推送                                         |          |
| 加密 aes_key | SiOHMHApFGJVlixd9RdBF1HNxDSiWRYVq2xO5K7jJV3      | 固定值   |
| 签名 token   | taPbROC64bgjkS2OPd2jUGRfsk8qudg3Wo6BAg6afnlYqbjQ | 固定值   |
| 请求网址     | 复制飞跨钉钉通讯录同步配置页的“回调地址”         |         |

2.进入钉钉开放平台后台的【事件订阅】页面，把以上飞跨提供的参数值一一对应进行填写，然后点击”保存“，平台提示【修改成功】，完成配置。

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602aaac77b6f1abe50dfb2999708cd0ebef12279e4ba6e6bfd0ff86c9deaceb9f85c51102919a88ccf3e913dc666d742ab99.png?imageSlim)

3.完成以上配置后，开始事件订阅，把以下通讯录事件开启

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a8169d9d9ddf3b83ff1cfc718d354d39ffc2823aa178efbab26de2741fc9298c3dede4c7542a918b538c50188b6b162ea.png?imageSlim)

以上所开启的通讯录事件具体说明表如下：

| **事件类型** | **事件**           | **说明**                     |
| ------------ | ------------------ | ---------------------------- |
| 通讯录事件   | 通讯录用户增加     | 用于用户数据同步到飞跨时使用 |
|              | 通讯录用户离职     | 用于用户数据同步到飞跨时使用 |
|              | 通讯录企业部门创建 | 用于部门数据同步到飞跨时使用 |
|              | 通讯录企业部门修改 | 用于部门数据同步到飞跨时使用 |
|              | 通讯录企业部门删除 | 用于部门数据同步到飞跨时使用 |

4.配置好以上信息之后，回到飞跨浏览器，点击保存并同步，会提示：保存成功，已开始同步，请稍后查看同步结果。

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a8169d9d9ddf3b83ffcbd6017f44a66cd028f57df7200f7e2cd22faa4a2a497968877bb8e1fab245aa65d1b163e5bd0a2.png?imageSlim)

5.查看同步数据：在飞跨浏览器→团队管理→成员管理查看所有成员信息。

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602aa3ba6b64951bcf7efbeb2c675caa640a0db001fc0de8dcf7ff585ae94782e5057ccd45fe5de20586b001ddb9a37bba29.png?imageSlim)

## 2 部门及员工账号同步规则概览

以下表格阐述了钉钉与飞跨平台的部门及员工账号同步规则，涵盖同步规则、变动及限制，展示同步要点，确保数据一致性、准确性。

| 同步规则                                    | 规则说明                                                     | 举例                                                         | 备注                                                         |
| ------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 部门同步规则                                | 1.飞跨与钉钉同层级同名部门自动关联并同步更新                | 钉钉“研发中心”下的“研发部”与飞跨“研发中心”下的“研发部”自动关联 | 需精准匹配，微小差异（如“研发部门”与“研发部”）不会自动关联，需手动处理 |
 | | 2.允许不同层级部门名称相同。系统按层级区分 | 总部“销售部”与分公司“销售部”分层级展示，不会混淆关联         | 确保复杂多层级组织架构的准确适配                             |                                                              |
| 新增部门                                    | 钉钉新增加的部门同步后飞跨中创建对应的新部门                 | 钉钉新增“市场部”，飞跨同步创建                               | 确保飞跨架构不遗漏任何钉钉部门。                             |
| 删除部门                                    | 钉钉中被删除的部门，如果在飞跨上该部门没有关联成员，则同步删除；如果飞跨上的部门有关联成员则部门不允许被删除 | 钉钉删除无成员的“测试部”，飞跨同步删除；有成员的部门则保留   | 避免因部门删除导致管理问题                                   |
| 部门变动                                    | 钉钉中部门的任何变动（如名称或结构调整）都将更新飞跨平台中的相应部门信息 | 钉钉“销售部”改名为“市场销售部”，飞跨相应部门同步更新         | 确保部门信息实时更新                                         |
| 部门限制                                    | 飞跨支持最多10级的部门结构，而钉钉则支持多级部门结构。对于超出10级的部门，在同步到飞跨时，将其归并至第10级部门。 | 钉钉中某部门结构为12级，同步到飞跨时，第11级和第12级部门会被归并到第10级部门下。 | 确保复杂多层级组织架构的准确适配                             |
| 员工账号同步规则                            | 1. 手机号匹配优先：相同手机号自动绑定                        | 张三（手机号138xxxxxx01）钉钉账号与飞跨自动绑定。            | 手机号是首要关联依据。                                       |
 || 2. 钉钉有飞跨无的员工，飞跨创建相同账号     | 钉钉“马六”飞跨同步创建并入部门                               | 确保工账号一致。                                             |                                                              |
 || 3. 同名不同账号通过添加数字区分             | 钉钉两个“李四”，飞跨改名为“李四1”“李四2”。                   | 确保同名账号唯一性                                           |                                                              |
 || 4.飞跨同名账号无手机不自动匹配，保持原状。 | 飞跨“王五”无手机，同步后保持不变。                           | 确保无手机账号正常使用。                                     |                                                              |
| 员工入职                                    | 钉钉中入职的员工，同步后飞跨自动创建新的员工账号             | 钉钉入职员工“赵敏”，飞跨同步创建账号                         | 及时更新员工信息                                             |
| 员工离职                                    | 钉钉员工离职，同步后飞跨相应的员工账号被禁用，但员工账号所授权的权限不回收 | 钉钉书删除员工“钱七”，飞跨对应账号被禁用                     | 方便在飞跨上做交接                                           |
| 员工变动                                    | 钉钉书中部门的任何变动（如名称或结构调整）都将更新飞跨平台中的相应部门信息 | 在钉钉中，某员工”钱七“从“市场部”调至“销售部”，飞跨平台会同步这一变动，及时更新该员工所属部门信息 | 确保其在飞跨平台中的部门归属与钉钉保持一致                   |

员工入职及离职同步规则详解

本节详细说明了钉钉与飞跨平台在员工入职和离职时的同步规则，包括自动创建账号、短信通知、账号关联、禁用账号及移除授权等具体操作及作用，是对同步规则的进一步细化和补充。

员工入职

员工同步成功，自动在飞跨添加新员工，角色设为“钉钉同步的默认角色”，权限包括查看账号列表和添加插件。

一旦新员工账号在飞跨浏览器中创建，系统将自动发送钉钉消息通知给新员工。短信中包含打开网页链接、团队名称、登录手机号码、登录密码，以便新员工能够登录并修改密码。

![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602aaac77b6f1abe50df3fd75092b54f72b26b751a57014b218f5f31c9d22265fe56fe4b12451b524df21d9b5e82b49c841a.png?imageSlim)

如果飞跨浏览器中已经存在与新员工手机号相同的账号，系统将直接将新员工信息与该账号关联。

员工离职

- 禁用该员工飞跨账号，账号所授权的权限不回收。
- 移除所有账号授权，交接账号需提前在飞跨上操作。