企业OA系统与钉钉通讯录实现同步

前提条件

完成创建应用的流程。

步骤一：获取应用凭证

1. 选择目标应用，进入应用详情页，单击基础信息 > 凭证与基础信息。

2. 获取应用 Client ID 和 Client Secret。

步骤二：添加接口权限

单击开发配置 > 权限管理，在权限搜索框中输入qyapi_manage_addresslist，并申请权限。

步骤三：获取应用访问凭证accessToken

根据步骤一中 的 Client ID 和 Client Secret，获取应用访问凭证获取企业内部应用的access_token。

步骤四：通讯录同步相关流程

1. 钉钉通讯录信息同步到企业OA系统通讯录：

   实现同步的关键在于钉钉通讯录内的信息有相关变动，要同时保证企业OA系统通讯录也有响应的操作。

   1. 先参考获取企业下所有员工信息文档，把当前钉钉组织架构信息全部获取到企业OA系统通讯录内。

   2. 使用钉钉提供的事件订阅功能，并订阅通讯录事件，钉钉通讯录内的变动会对应推送相关的回调事件信息。通讯录事件推送信息格式参考通讯录。

      

   3. 企业OA系统，接收并处理钉钉推送的通讯录事件，同步更新企业OA系统的通讯录信息。

2. 企业OA系统通讯录信息更新到钉钉通讯录：

   当企业OA系统通讯录的信息发生变动，需要同步更新钉钉通讯录信息，确保通讯录信息一致。

   1. 企业OA系统通讯录内创建了部门，调用创建部门接口，根据企业自有OA系统内该部门层级和部门名称，在钉钉客户端内创建同样的部门层级和部门名称。

      Loading...
      说明

      钉钉通讯录的部门ID是自动生成的，不支持设置。在进行通讯录更新时，建议以部门名称作为标识同步到钉钉，并同时保存对应的钉钉通讯录的部门ID值，便于后续操作使用。

   2. 企业OA系统通讯录添加角色，根据企业OA系统内的角色信息。

      1. 调用服务端API-创建角色组接口，创建角色组信息。

         Loading...

      2. 调用服务端API-创建角色接口，创建企业角色信息。

         Loading...

   3. 调用创建用户接口，把企业OA系统内各个部门内的员工创建添加到钉钉对应的部门内，本步骤添加用户的同时，可以同时添加该员工的角色信息。

      Loading...