通过飞书下游同步功能，您可以将飞连中维护的组织架构和员工信息一键推送至飞书。适用于以飞连作为身份主数据源，并需同步至飞书进行业务协作的场景，避免跨平台重复维护账号的运维压力。

步骤一：在飞书开放平台配置应用 #

开始对接前，需先在飞书侧创建一个具备通讯录写权限的自建应用，并获取接入凭证。

1. 创建企业自建应用 #

1. 登录飞书开放平台。
2. 在开发者后台，选择企业自建应用，点击创建企业自建应用。
3. 输入应用名称、描述并上传图标，点击创建。

2. 配置应用权限 #

为确保飞连能够向飞书写入数据，需开通对应的通讯录权限。

1. 进入应用详情页，在左侧导航栏选择开发配置 > 权限管理。
2. 在权限配置页签下，开通以下权限：
   • 更新通讯录
   • 获取部门基础信息、获取通讯录部门组织架构信息
   • 获取用户基本信息、获取用户组织架构信息、获取用户邮箱信息、获取用户受雇信息、获取用户 user ID、获取用户手机号
   • 通过手机号或邮箱获取用户 ID
   • 搜索用户、获取通讯录基本信息
   • 更新用户 ID、获取角色权限
     您也可以通过权限页面的“批量导入”功能，将以下 JSON 代码直接导入：

   {
     "scopes": {
       "tenant": [
         "contact:contact",
         "contact:contact.base:readonly",
         "contact:contact:update_user_id",
         "contact:department.base:readonly",
         "contact:department.organize:readonly",
         "contact:role:readonly",
         "contact:user.base:readonly",
         "contact:user.department:readonly",
         "contact:user.email:readonly",
         "contact:user.employee:readonly",
         "contact:user.employee_id:readonly",
         "contact:user.id:readonly",
         "contact:user.phone:readonly"
       ],
       "user": [
         "contact:contact.base:readonly",
         "contact:user:search"
       ]
     }
   }
   

3. 发布应用并设置可用范围 #

1. 在左侧导航栏选择版本管理与发布，点击创建版本。

2. 在可用性状态中，必须选择“所有员工”。

   

   飞连在进行下游同步时，需对飞书的全量组织架构进行校验，以避免以下异常情况：

   • 飞连待同步的根部门在飞书中已存在。
   • 存在同名但不同层级的待同步部门。
   • 待同步根部门与现有部门名称冲突。

3. 保存并点击申请线上发布。待飞书管理员审核通过，状态变为“已上架”后即可使用。

4. 获取应用凭证 #

在凭证与基础信息页面，复制并记录已创建应用的 App ID 与 App Secret，用于后续飞连管理后台的配置。

步骤二：在飞连管理后台配置同步任务 #

完成飞书侧准备后，需在飞连后台建立同步链路并开启推送。

1. 创建下游同步数据源 #

1. 登录飞连管理后台，选择身份 > 账号配置。
2. 进入数据源同步页签，点击添加数据源。
3. 在弹窗中选择下游同步页签，点击飞书下游并点击创建。
   

2. 配置应用凭证与同步路径 #

在配置页面，完成以下设置：

• App ID / App Secret：填入上一步获取的凭证。
• 同步根目录：
  • 若不设置，飞连数据将直接同步至飞书的根目录下。
  • 若需同步到特定位置，请在此配置飞书侧已存在的部门作为同步的目标根目录。
• 单位：选择该数据源所属的飞连单位。
• 第三方权限探测：点击开始检测，飞连将自动验证 App ID、App Secret 的有效性，并探测飞书应用权限是否已正确开通。
  • 检测通过：显示“检测成功”后，点击下一步，进入字段映射配置。
  • 检测失败：请根据报错提示，回到飞书开放平台核对应用权限及版本上架状态。

3. 定义同步范围与字段映射 #

1. 在数据对象页面，选择需要推送到飞书的飞连部门或特定员工账号。
2. 根据业务需求配置属性字段映射。确保飞连字段（如姓名、手机号等）能准确对应飞书的通讯录字段。

4. 设置同步模式 #

目前飞书下游同步支持以下两种模式：

• 手动导入：配置完成后，由管理员手动触发推送。
• 定时导入：设置固定的时间周期（如每日凌晨），飞连自动执行全量数据比对与推送。

5. 完成配置并执行初次同步 #

1. 确认配置无误后点击完成配置。

2. 在数据源列表中，找到刚创建的飞书下游数据源，点击开始同步执行首次全量推送。

3. 同步任务开始后，您可以在飞连管理后台查看同步进度。

   
   • 若同步状态显示为 100%，代表数据已成功推送到飞书。
   • 您可以登录飞书管理后台查看通讯录，确认组织架构及员工信息是否已准确更新。