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

## 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://article.qg.net/5eecdaf48460cde51783becd1eac8be309c716fa337344ea75b8339e1c4c24834eb57e596dccb0158d68742cd653602aaac77b6f1abe50dfed0f600a59aaecf9412db7aacc830fd4770e9cfe199caa4288409be93e6a39d8b1f7a025c7310661?imageSlim)

![img](https://article.qg.net/5eecdaf48460cde51783becd1eac8be309c716fa337344ea75b8339e1c4c24834eb57e596dccb0158d68742cd653602a0524375348f90ffd3ab372d8b757a5f89dc55c4c34adadf61fe86735cb791b87fd6f1264f469e2603064d2f892883dec?imageSlim)

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

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a822951806323f8965c9c8c2a72ee42b3c7efdc162b5e725e37a348da502ce5f1ab5f71f737449375259facc3e1885f3e.png?imageSlim)

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

1.应用创建成功后，会自动进入该应用详情页面，选择【权限管理】，权限范围选择【全部员工】，找到并勾选【通讯录个人信息读权限】→点击【申请权限】；

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a358e919a3f95be9a9ddaefc9ae57d4cd88dff9fb388af6e244726caef88ad9991712354d59c3789d0e3395102a80318d.png?imageSlim)

2.点击【通讯录管理】，勾选需要开通的权限，请详细核对并开通，缺少权限将导致部分业务数据无法同步，勾选后点击“批量申请”，系统提示“申请成功”，则完成应用权限开通申请。

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a473a1bc8310192c0d42894f9fc6de50095fb8952542941a829e5a9ed85dbf237e27f4f6507dba3c983197092068be99b.png?imageSlim)

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

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

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a6d6e809e475597e64b4b33654ecca066791d476f4456de0e4c28a297551ab9f3f07b7fd6a68970f7b18253aa396144d5.png?imageSlim)

### 1.3 设置重定向URL

点击【安全设置】，在【重定向URL（回调域名）】中填写飞跨浏览器的首页链接：https://www.feikua.net/ 点击保存。

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a358e919a3f95be9ab8c690b69c82b87f6e1fb0ba1b23ea15bd16fa0da5df57cccc60dfe872002bad69254e8b32997a48.png?imageSlim)

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

1.记录所属组织的CorpId：点击右上角的图标，复制组织的CorpId

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a27905087190dd0b915bc86b97d461d9f52c9f0e074b57f05c32901be1803b17ccaee85cbc9df6b084ae881ad15320357.png?imageSlim)

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

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a7a5c135778ee098c38ea27bc2d5cfaabf9bc688f362906fbbfce48968a5b824182efd80111d908c9a06d407b33959795.png?imageSlim)

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

1.登录飞跨浏览器在主控台点击【团队管理】→【成员管理】→【【钉钉同步】进行配置；

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a358e919a3f95be9abc22bb5fdce45d1c43cb3b00d630575e9abb52fcdaeb9b1a41215152826b99ca6994d7fcbea71672.png?imageSlim)

2.分别按照上面复制的参数值添加相关配置，点击保存设置，出现保存成功后即可。

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a7a5c135778ee098cbe646972f51a13b23a60d67479c44c497e7dd592845aa69d413fde76836c324630ca620bedf8b28e.png?imageSlim)

**注意**：该方式到此步骤就已经成功配置完成了，**企业成员使用打钉扫码登录后，即可自动添加成员至团队列表**。

### 1.6 钉钉成员登录方式

1.在登录页选择【钉钉】登录；

![image-20260811113731177](https://article.qg.net/Uploads/image/2026-08-11/113732c0ddea9.png?imageSlim)

2.输入【团队名称/主账号手机号】，点击下一步；

![image-20260811113823306](https://article.qg.net/Uploads/image/2026-08-11/113824aef4361.png?imageSlim)

3.使用钉钉扫码即可成功登录。

![image-20260811113934827](https://article.qg.net/Uploads/image/2026-08-11/113935dcc55fa.png?imageSlim)

## 2 方式二：钉钉和飞跨同步方式-企业组织导入

使用企业组织导入方式后，企业成员使用钉钉扫码登录后，自动添加成员至团队列表。

### 2.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://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602aaac77b6f1abe50df86fdfcfedafdcc5411a8a39328d369462e68715ffbd8af0408aadf8f21e72543cb27e372af891793.png?imageSlim)

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

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

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

### 2.3 设置重定向URL

点击【安全设置】，在【重定向URL（回调域名）】中填写飞跨浏览器的首页链接：https://www.feikua.net/ 点击保存。

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

1.记录所属组织的CorpId：点击右上角的图标，复制组织的CorpId

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

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

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

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a27905087190dd0b9df430cac33837ce98a7c54f5c9bc6d80a287aaae20b610c9d971a8a9602f80b6ee08f287c78fab9a.png?imageSlim)

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

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a27905087190dd0b9d98afc849087fdff57b0ad8decc704f94688dd59866edeeec7e4f591e23992aa599596be3016f407.png?imageSlim)

3.发布成功后，复制 RobotCode

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a822951806323f89643582a42f7e16b95c7bacb25f86053d61fd438c21eb7b1bf067d81c8705687f53be83dea24a73d3e.png?imageSlim)

### 2.6 创建版本并发布

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

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602aaac77b6f1abe50df0fe64050d8fa9af01938da3a3441ad315634eb0b2958650909c1c4d1c6be4fb041114c29a0865461.png?imageSlim)

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

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602aa3ba6b64951bcf7e9af87adff2429c02570ee7f77af8edd287bd0eb92d7651c654497063b268235e43f2d1e600a9fbf6.png?imageSlim)

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

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a15464a86392b1bf5c578cb7f3b055c2b829c4cee45d429e514b9bd6e67c6d8c3cbc34404f2ee30448e7d21d1b40c0c01.png?imageSlim)

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a15464a86392b1bf56eb9518c168a8b967659ec1e804cb2fb8f0e5b18f2b7f88464bb55292d110b36eb87fe038d836e08.png?imageSlim)

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

1.登录飞跨浏览器在主控台点击【团队管理】→【成员管理】→【【钉钉同步】进行配置；

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

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a8169d9d9ddf3b83f2a68d73d38dc29ffdae101ae47e04e0394f1c4a56f627417f5b97996b1591ba8e958a6fe3e1772e3.png?imageSlim)

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

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

1.在配置事件与回调配置时，需要飞跨提供同步参数![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a0d50ecb3f30f832e2ebac5ff7643ca5cedaf1450c1146b996584d9e8b32a6eb67e6e7cecaa2386e3857baa3444984073.png?imageSlim)

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

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

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a473a1bc8310192c0322714368bbc7330d5ce7baa674506828eec32108a1ad4880d5f82ec17c66e97fc8f4301fbc973eb.png?imageSlim)

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

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a15464a86392b1bf516fb331eb6aa2e6009a370fe074e1556c59394d778881906d7645654a9e1244e7613139c5bdfa596.png?imageSlim)

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

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

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

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a358e919a3f95be9a5a3c5eb77a2ff873305287001fd5587e245c7a315585307fafe9c9e2d57338032e0994899c0e00e1.png?imageSlim)

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

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a27905087190dd0b924a161842b66517754cedfa86afe631df19ca7e5917d96da9bdc9c64184e22944f88180222333487.png?imageSlim)

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

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

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

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

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

员工入职

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

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

![img](https://article.qg.net/5eecdaf48460cde5b8937be60ec8079286827ed9d9535c1a75b8339e1c4c24834eb57e596dccb0158d68742cd653602a358e919a3f95be9a56c9368932c7ccb3f00fa9d22ed98585de0d96b55b0ad897e986969794e5fea35e1192dc48f9dbb3.png?imageSlim)

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

员工离职

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