[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,需要綁定微信開發者帳號才能獲取到,查看[綁定方法](http://www.hmoore.net/book/dabashan/qiwei/edit#unionid_40) |
### 如何獲取微信客戶的unionid
1. 在微信客服管理后臺的「開發配置」處,點擊“綁定”去到微信公眾平臺進行授權,支持綁定公眾號和小程序(需要同時綁定微信開放平臺);綁定的公眾號或小程序主體需與企業微信主體一致,暫且支持綁定一個
2. 綁定完成后,即可通過此接口獲取微信客服所對應的微信unionid
3. 第三方服務商若需要unionid,則只需要在服務商自身微信客服管理后臺的「開發配置」處綁定微信開發者ID;第三方調用接口返回的unionid是該服務商所關聯的微信開發者帳號的unionid。也就是說,同一個微信客戶,企業自己調用,與第三方服務商調用,所返回的unionid不同;不同的服務商調用,所返回的unionid也不同
