获取客户基础信息

权限说明:

企业需要使用“微信客服”secret所获取的accesstoken来调用（accesstoken如何获取？）

第三方应用需具有“微信客服权限->获取基础信息”权限

代开发自建应用需具有“微信客服权限->获取基础信息”权限

如何获取微信客户的Unionid

企业内部开发和第三方应用开发，获取Unionid的方式不同。

企业内部开发

在企业微信管理后台“应用管理-微信客服-通过API管理微信客服”处，点击“绑定”去到微信公众平台进行授权，支持绑定公众号和小程序（需要同时绑定微信开放平台）；绑定的公众号或小程序主体需与企业微信主体一致，暂且支持绑定一个

绑定完成后，当客户进入客服会话或发起咨询时，即可通过此接口获取微信客服所对应的微信unionid

第三方应用开发

企业授权第三方应用管理指定的客服帐号的会话消息时，当微信客户进入该客服会话或发起咨询时，第三方可获取该客户的external_userid

第三方需自行通过其他已有的方式获取客户的Unionid

再通过Unionid与external_userid关联接口，将获取到的Unionid和external_userid实现关联识别。

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

调用接口凭证

必需

示例值:

Body 参数application/json

external_userid_list

array[string]

必需

external_userid列表可填充个数：1 ~ 100。超过100个需分批调用。

need_enter_session_context

integer

可选

是否需要返回客户48小时内最后一次进入会话的上下文信息。 0-不返回 1-返回。默认不返回

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

错误码描述

必需

customer_list

array [object {6}]

返回结果

必需

external_userid

string

可选

微信客户的external_userid

nickname

string

微信昵称

可选

avatar

string

可选

微信头像。第三方不可获取

gender

integer

性别

可选

unionid

string

可选

unionid，需要绑定微信开发者帐号才能获取到，查看绑定方法。第三方不可获取

enter_session_context

object

可选

48小时内最后一次进入会话的上下文信息。请求的need_enter_session_context参数设置为1才返回

invalid_external_userid

array[string]

必需

如何获取微信客户的Unionid#

企业内部开发#

第三方应用开发#

请求参数

返回响应

如何获取微信客户的Unionid

企业内部开发

第三方应用开发