第三方应用开发
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
第三方应用开发
客户端API
JS-SDK
企业通讯录
选人接口
选人接口
最后更新:2024/05/13
wx.invoke("selectEnterpriseContact", {
                "fromDepartmentId": -1,// 必填,表示打开的通讯录从指定的部门开始展示,-1表示自己所在部门开始, 0表示从最上层开始
                "mode": "multi",// 必填,选择模式,single表示单选,multi表示多选
                "type": ["department", "user"],// 必填,选择限制类型,指定department、user中的一个或者多个
                "selectedDepartmentIds": ["2","3"],// 非必填,已选部门ID列表。用于多次选人时可重入,single模式下请勿填入多个id
                "selectedUserIds": ["lisi","lisi2"]// 非必填,已选用户ID列表。用于多次选人时可重入,single模式下请勿填入多个id
        },function(res){
                if (res.err_msg == "selectEnterpriseContact:ok")
                {
                        if(typeof res.result == 'string')
                        {
                                res.result = JSON.parse(res.result) //由于目前各个终端尚未完全兼容,需要开发者额外判断result类型以保证在各个终端的兼容性
                        }
                        
                        var selectedDepartmentList = res.result.departmentList;// 已选的部门列表
                        for (var i = 0; i < selectedDepartmentList.length; i++)
                        {
                                var department = selectedDepartmentList[i];
                                var departmentId = department.id;// 已选的单个部门ID
                                var departemntName = department.name;// 已选的单个部门名称
                        }
                        var selectedUserList = res.result.userList; // 已选的成员列表
                        for (var i = 0; i < selectedUserList.length; i++)
                        {
                                var user = selectedUserList[i];
                                var userId = user.id; // 已选的单个成员ID
                                var userName = user.name;// 已选的单个成员名称
                                var userAvatar= user.avatar;// 已选的单个成员头像
                        }
                }
        }
);
此接口在企业微信1.3.11及以后版本支持,微信6.5.10及以后版本支持(微信pc版暂不支持)。
user.name、user.avatar与department.name从2019年12月30日起,对新创建第三方应用不再返回,2020年6月30日起,对所有历史第三方应用不再返回,第三方页面需要通过通讯录展示组件来展示名字。
上一篇获取进入H5页面的入口环境
下一篇打开个人信息页接口
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们