接入指引

企业在人事管理场景中，存在将已有的通讯录数据写入到企业微信的需求。企业微信禁止服务商通过客户企业的“企业管理后台 - 管理工具 - 通讯录同步”的secret功能直接获取企业通讯录数据。

因此为满足人事类应用服务商为企业提供通讯录写入服务的需求，企业微信面向第三方服务商提供授权能力“通讯录编辑授权”：经企业授权后，第三方服务商可通过接口编辑企业通讯录信息，包括对成员和部门进行新增、修改、删除操作。

通讯录编辑权限

经客户企业授权后，服务商可获得如下权限：

1. 可读取全公司范围内的成员open_userid和部门ID
   
2. 可新增和修改全公司范围内员工的以下信息：
   账号、姓名、别名、性别、头像、手机号、座机、邮箱、企业邮箱、地址、职务、部门、主部门、部门负责人、直属上级、自定义属性、视频号名称、对外身份和对外职务
   
3. 可执行以下操作：
   新增成员、删除成员、新增部门、删除部门

开通条件

第三方服务商开通“通讯录编辑授权”需同时满足以下三个条件：

1. 服务商需完成认证
2. 服务商需上线应用分类为“人力资源”的第三方应用或模板分类为“人力资源”的代开发模板
3. 服务商历史未开通“第三方通讯录应用”

配置指引

1.配置参数

符合开通条件的服务商可在「服务商助手 - 工具 - 通用配置 - 通讯录编辑授权」配置参数，配置完成并勾选《服务商开通授权承诺》后可开通。不满足开通条件的服务商，服务商助手将不会展示开通入口。

服务商需要配置的参数如下：

2. 提交审核

配置参数后，需提交企业微信审核。审核通过后，服务商可点击“发布”并生成授权二维码用于企业授权。若需要修改参数，可在编辑保存后重新提交审核。

3. 企业授权

客户企业扫码授权服务商通讯录编辑权限时，需同时满足以下条件：

1. 当前企业未开启“企业管理后台 - 管理工具 - 通讯录同步”的api接口同步
2. 当前企业未授权其他服务商通讯录编辑权限或第三方通讯录应用
3. 当前企业已安装该服务商分类为“人力资源”的第三方应用或代开发应用

仅支持：企业超级管理员通过企业微信客户端扫码授权。

接口说明

该授权仅用于需要将通讯录数据同步到企业微信的场景，接口能力仅支持写入成员和部门信息以及读取成员和部门ID，具体可调用的API以及可接收到的变更回调通知在下文中列举，其他未列举的接口均不能调用。

接口调用凭证

企业同意并完成“通讯录编辑授权”后，服务商通过永久授权码换取企业凭证后调用接口，以及通过“通讯录编辑授权”中的回调配置接收通讯录变更通知（注意不是使用“人力资源”应用）。

允许调用的接口

ID查询接口

支持服务商通过ID查询接口获得成员和部门ID列表，可用于实现增量写的比对功能。

• 获取成员ID列表
  

  可用于获取企业所有成员的open_userid。

• 获取部门ID列表
  

  可用于获取企业所有部门ID

ID转换接口

• userid转换
  

  可用于将userid转换为open_userid

成员管理接口

• 创建成员
• 更新成员
• 删除成员

部门管理接口

• 批量删除成员
• 创建部门
• 更新部门
• 删除部门

异步导入接口

• 增量更新成员
• 全量覆盖成员
• 全量覆盖部门
• 获取异步任务结果

允许接收的回调通知

成员变更事件

• 新增成员事件
  

  成员属性仅回调UserId/OpenUserId/Department三个字段

• 更新成员事件 （仅在成员转移部门时回调）
  

  仅在成员转移部门时回调，且成员属性仅回调UserId/OpenUserId/Department三个字段

• 删除成员事件

部门变更事件

• 新增部门事件
  

  部门属性仅回调Id/ParentId两个字段

• 更新部门事件
  

  仅在变更父部门时回调，且部门属性仅回调Id/ParentId两个字段

• 删除部门事件