# 客户基本信息获取 <br> [<h2>微信客服官方API文档入口</h2>](https://open.work.weixin.qq.com/kf/doc/92512/93143/93304) <br> <br> **请求方式**: 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/wikizhima/wechatkf-api/2376732) | ### 如何获取微信客户的unionid 1. 在微信客服管理后台的「开发配置」处，点击“绑定”去到微信公众平台进行授权，支持绑定公众号和小程序（需要同时绑定微信开放平台）；绑定的公众号或小程序主体需与企业微信主体一致，暂且支持绑定一个 2. 绑定完成后，即可通过此接口获取微信客服所对应的微信unionid 3. 第三方服务商若需要unionid，则只需要在服务商自身微信客服管理后台的「开发配置」处绑定微信开发者ID；第三方调用接口返回的unionid是该服务商所关联的微信开发者帐号的unionid。也就是说，同一个微信客户，企业自己调用，与第三方服务商调用，所返回的unionid不同；不同的服务商调用，所返回的unionid也不同  <br> <br> ## 微信客服第三方服务商 - 芝麻客服接入指南 <br> 1. 登陆 [芝麻客服官网](https://xiaokefu.com.cn/index/wechatkefu)，点击 [一键接入微信客服组件](https://xiaokefu.com.cn/app/selectionWechatKf)。 </h>  </h> </h> 2. 点击 下一步 ，然后企业微信管理员扫码即可。 </h>  </h> </h>