[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也不同