通讯录同步概述

概述

通讯录同步是将专属集成平台中的组织架构和用户信息推送到下游应用系统（如钉钉、企业微信、AD/LDAP 等）的功能。数据流向为：专属集成平台 → 下游系统。平台作为用户数据的主数据源和统一管理中心，通过通讯录同步将用户数据自动分发到各个下游业务系统，确保多系统间身份数据的一致性。

核心价值

多系统数据一致：确保下游系统使用统一的、最新的用户信息

集中管控：从专属集成平台统一管理多个系统的身份数据

账号自动创建：新用户添加到平台后自动在下游系统创建对应账号

权限自动分配：基于组织架构和角色自动在下游系统分配权限

减少运维负担：无需在多个系统中重复维护相同的组织和用户信息

前提条件

平台管理员权限：拥有专属集成平台的管理员权限

下游系统管理员权限：拥有目标下游系统的管理员权限，用于创建应用和配置 API 授权

网络要求：确保专属集成平台服务器可以访问下游系统的 API 接口

下游系统配置完成：已在下游系统准备好应用的认证信息（如 AppKey、AppSecret 等）

快速入门

步骤 1：选择目标系统

根据业务需求，确定需要将平台用户数据推送到哪些下游系统。参考上方支持的目标系统列表。

步骤 2：创建同步任务

在专属集成平台中，进入「用户中心 → 通讯录同步」，点击「添加连接器」按钮，选择对应的目标系统类型。

步骤 3：配置并执行同步

依次完成：目标连接配置 → 字段映射 → 同步规则设置 → 测试执行。具体配置请参考各目标系统的配置文档。

重要：首次同步前，建议先在测试环境或小范围内验证配置正确性，避免大规模数据误同步。

数据流向

专属集成平台（用户中心）                  下游系统
       │                                    │
       ├── 组织架构数据 ─────────────────→  钉钉通讯录
       ├── 用户数据     ─────────────────→  企业微信通讯录
       ├── 用户数据     ─────────────────→  AD/LDAP 目录
       └── 用户数据     ─────────────────→  其他业务系统

数据从平台单向推送到下游系统。平台是数据的所有者和维护点，下游系统作为数据的接收者。

提示：如需将第三方身份源系统的数据拉取到平台，请使用通讯录集成功能（数据方向相反：上游系统 → 平台）。

常见概念

概念	说明
同步任务（连接器）	在平台中创建的一条同步配置，定义了从平台到某个下游系统的数据推送规则
字段映射	将平台的用户/组织属性与下游系统字段建立对应关系，确保数据正确转换
同步范围	指定哪些用户/部门数据参与同步，支持全量和部分两种模式
同步方式	包括自动增量（仅同步变更）、自动全量（定期全量同步）和手动全量三种
删除阈值	安全保护机制：当待删除用户比例超过阈值时暂停删除，需管理员确认后才执行
强制创建	开启后，同步时若下游系统不存在对应记录，则强制创建；关闭则跳过

概述#

核心价值#

前提条件#

快速入门#

步骤 1：选择目标系统#

步骤 2：创建同步任务#

步骤 3：配置并执行同步#

数据流向#

常见概念#

概述