[TOC] **请求方式**: POST(**HTTPS**) **请求地址**: https://qyapi.weixin.qq.com/cgi-bin/kf/customer/batchget?access\_token=ACCESS\_TOKEN **请求示例**: ~~~ { "external_userid_list": [ "wmxxxxxxxxxxxxxxxxxxxxxx", "zhangsan" ]} ~~~ **参数说明：** | 参数 | 是否必须 | 说明 | | --- | --- | --- | | access\_token | 是 | 调用接口凭证 | | external\_userid\_list | 是 | external\_userid列表 | **权限说明**: 仅允许微信客服的Secret所获取的access\_token调用。 **返回结果**: ~~~ { "errcode": 0, "errmsg": "ok", "customer_list": [ { "external_userid": "wmxxxxxxxxxxxxxxxxxxxxxx", "nickname": "张三", "avatar": "http://xxxxx", "gender": 1, "unionid": "oxasdaosaosdasdasdasd" } ], "invalid_external_userid": [ "zhangsan" ]} ~~~ **参数说明**: | 参数 | 类型 | 说明 | | --- | --- | --- | | errcode | int | 返回码 | | errmsg | string | 错误码描述 | | customer\_list | array | 返回结果 | | customer\_list.external\_userid | string | 微信客户的external\_userid | | customer\_list.nickname | string | 微信昵称 | | customer\_list.avatar | string | 微信头像。第三方不可获取 | | customer\_list.gender | int | 性别 | | customer\_list.unionid | string | unionid，需要绑定微信开发者帐号才能获取到，查看[绑定方法](https://www.kancloud.cn/book/dabashan/qiwei/edit#unionid_40) | ### 如何获取微信客户的unionid 1. 在微信客服管理后台的「开发配置」处，点击“绑定”去到微信公众平台进行授权，支持绑定公众号和小程序（需要同时绑定微信开放平台）；绑定的公众号或小程序主体需与企业微信主体一致，暂且支持绑定一个 2. 绑定完成后，即可通过此接口获取微信客服所对应的微信unionid 3. 第三方服务商若需要unionid，则只需要在服务商自身微信客服管理后台的「开发配置」处绑定微信开发者ID；第三方调用接口返回的unionid是该服务商所关联的微信开发者帐号的unionid。也就是说，同一个微信客户，企业自己调用，与第三方服务商调用，所返回的unionid不同；不同的服务商调用，所返回的unionid也不同