# 从企业微信实时同步

来源快照：`result_data_new_260518.json`

- 来源 ID：`1240748861578403851`
- 模块：云桥
- 目录：其他补充说明
- space ID：`1159147935877833073`
- 原文链接：未提供
- 产品基线：未提供

## 正文

**从企业微信实时同步功能**

一、

# **功能需求背景**

企业微信通讯录同步需要支持实时更新，所以需要支持企业微信回调事件，当企业微信通讯录新增成员或部门时，将以事件的形式推送到配置的回调URL，保证通讯录同步，达到实时更新E10通讯录的目的。

二、

# **功能配置说明**

1.

需要配置企业微信的通讯录密钥：访问对应企业微信团队的【通讯录管理】，点击【接口参数设置】，接口权限选择读写，将企业微信管理后台【管理工具】-【通讯录同步】中的secret复制填写到通讯录密钥中，点击保存。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1240752413496082442&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

2.

需要配置回调URL：点击企业微信管理后台【管理工具】-【通讯录同步】中的设置接收事件服务器按钮，进入设置接收事件服务器配置界面，将以下信息复制到对应文本框中并点击【保存】。注意：若不需要开启企业微信实时回调功能，则不需要配置回调URL，企业微信接收事件服务器一旦配置，不支持删除，只能编辑修改。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1240752417749106700&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1240754281609314308&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

3.

在使用该功能之前需要先执行一下【从企业微信同步组织用户绑定关系】。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1240752417811611655&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

4.

开启实时同步。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1240752413441974274&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

三、

# **功能逻辑说明**

1.

企业微信通讯录实时回调是通过企业微信通讯录密钥获取部门信息和用户信息，即能获取到全部部门和用户信息；【从企业微信同步组织用户绑定关系】功能，是根据接口参数设置中选择应用的应用可见范围来获取部门和用户信息；在使用企业微信通讯录实时回调功能会根据应用的可见范围做判断，即不在应用可见范围内的部门和用户信息变更不会同步到云桥。注意：在使用企业微信通讯录实时回调功能时，建议配置的应用可见范围设置为通讯录全部部门。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1240752422031081476&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

若接口参数配置的应用可见范围不是全部部门，进行相关操作之后的效果说明如下：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1240752417669832706&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

操作部门

企业微信修改应用范围内的部门A，更换部门A的层级之后，部门A不在应用可见范围内了，云桥本地部门A不会删除；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1240752426183442436&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

在应用范围外创建部门A，云桥本地不会创建部门A；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1240752413441974276&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

操作用户

修改应用范围内的用户A，更换用户A的部门之后，用户A不在应用可见范围内了，云桥本地用户A不会删除；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1240752413496082437&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

在应用范围外创建用户A，云桥本地不会创建用户A；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1240752422031081474&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

2.

只有创建部门、删除部门、变更部门层级、创建用户、删除用户、变更用户部门共六类事件才会触发企业微信实时回调，例如单独修改部门名称或用户名称等事件，不会触发企业微信实施回调，即不会实时更新云桥通讯录或E10 通讯录数据。

3.

创建用户或者变更用户部门，可以通过开启【用户自动绑定】来实现自动关联对应的OA用户的功能：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1240754900261593093&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

4.

是否更新E10 通讯录数据：默认不更新，需要实时更新E10 通讯录数据则开启如下开关：是否同步到e-cology （具体逻辑可参考[是否同步到OA](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?freepass_doc=1&id=1172472406387802184&space_id=1159147935877833073 "是否同步到OA")）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1240752422124183561&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

四、

# **注意事项**

1.

使用企业微信实时同步功能，需要先执行【从企业微信同步组织用户绑定关系】，若需要同步到OA 也需要先手动执行同步，维护好部门的关联和用户的关联；

2.

企业微信应用可见范围变更之后，需要先手动执行一下同步，以保证后续实时同步正常执行；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1240752426268155906&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

3.

【从企业微信同步组织用户绑定关系】同步到OA选择的【顶级部门】，此处的配置有变更，需要先手动执行一下同步，以保证后续实时同步正常执行；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1240752421951799296&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)
