获 取客户基础信息
POST
/cgi-bin/kf/customer/batchget
服务端API第三方应用开发企业内部开发
如何获取微信客户的unionid
1.
2.
3.

注:第三方服务商调用上述接口时,获取到的unionid是第三方服务商主体下的unionid。如果第三方服务商已通过其他方式获取到企业主体下的unionid,可调用 外部联系人unionid转换 接口,将对应的unionid换成服务商名下的external_userid,基于external_userid识别同一客户。
原文档地址:
https://open.work.weixin.qq.com/api/doc/90001/90143/95149
https://open.work.weixin.qq.com/api/doc/90000/90135/95159
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/kf/customer/batchget?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
"external_userid_list": [
"wmxxxxxxxxxxxxxxxxxxxxxx",
"zhangsan"
],
"need_enter_session_context": 0
}'
响应示例响应示例
{
"errcode": 0,
"errmsg": "ok",
"customer_list": [
{
"external_userid": "wmxxxxxxxxxxxxxxxxxxxxxx",
"nickname": "张三",
"avatar": "http://xxxxx",
"gender": 1,
"unionid": "oxasdaosaosdasdasdasd",
"enter_session_context": {
"scene": "123",
"scene_param": "abc",
"wechat_channels": {
"nickname": "进入会话的视频号名称",
"scene": 1
}
}
}
],
"invalid_external_userid": [
"zhangsan"
]
}
请求参数
Query 参数
access_token
调用接口凭证
示例值:
{{accesstoken}}
Body 参数application/json
返回响应
修改于 2022-12-01 09:46:43