智慧硬件开发 服务端API 通讯录管理 概述
概述

目录

  • 开始开发
  • 扩展属性的添加方法
  • 成员对外信息的添加方法
  • 组织架构信息权限
  • 通讯录同步相关接口,可以对部门、成员、标签等通讯录信息进行查询、添加、修改、删除等操作。

    开始开发

    使用通讯录管理接口,原则上需要使用 通讯录管理secret,也可以使用 应用secret
    但是使用应用secret只能进行“查询”、“邀请”等非写操作,而且只能操作应用可见范围内的通讯录。

    获取通讯录管理secret的方法如下:
    1、进入企业微信管理后台,在“管理工具” -- “通讯录同步”开启“API接口同步”
    2、开启后,可设置通讯录API的权限:读取或者编辑通讯录
    3、使用通讯录同步的secret进行开发。点击查看 示例代码

    只有管理员才可以看到“管理工具” - “通讯录同步”这个工具,其他分级管理员无操作权限。当企业开启API接口编辑通讯录后,可接收成员变更个人信息的事件。

    扩展属性的添加方法

    登录管理后台->我的企业->通讯录管理->成员资料显示栏,点击修改按钮,会看到下图所示修改页面,点击“添加自定义信息”按钮,即可添加。

    成员对外信息的添加方法

    登录管理后台->外部联系人管理->成员对外信息,点击编辑来添加对外成员的属性,支持文本、链接、小程序类型
    管理端添加方法

    组织架构信息权限

    企业授权安装第三方应用之后,第三方应用仅能获取到可见范围内的组织架构信息,同时无法获取部门的负责人以及成员的直属上级。企业微信提供了一种新的通讯录权限:组织架构信息权限,第三方应用申请了该权限,企业授权之后,第三方应用即拥有了以下几个权限:

    1. 获取整个企业完整的组织架构的权限。第三方应用可以调用获取子部门ID列表接口获取根部门下的完整子部门ID(不要求部门在应用的可见范围之内),再根据每个子部门的ID调用获取单个部门详情接口,获取每个部门的详情,包括部门的负责人(要求负责人在应用可见范围之内)。
    2. 获取成员直属上级的权限。第三方应用调用读取成员获取部门成员详情异步导出成员详情接口时,如果该成员在应用可见范围,且其直属上级也在应用可见范围,则接口返回direct_leader字段。
    上一篇
    注册完成回调事件
    下一篇
    创建成员