获取客户基础信息

权限说明:

企业需要使用“微信客服”secret所获取的accesstoken来调用（accesstoken如何获取？）
第三方应用需具有“微信客服权限->获取基础信息”权限

如何获取微信客户的unionid

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

绑定完成后，即可通过此接口获取微信客服所对应的微信unionid

第三方服务商若需要unionid，则只需要在服务商自身企业微信管理后台的“应用管理-微信客服-通过API管理微信客服”处绑定微信开发者ID；第三方调用接口返回的unionid是该服务商所关联的微信开发者帐号的unionid。也就是说，同一个微信客户，企业自己调用，与第三方服务商调用，所返回的unionid不同；不同的服务商调用，所返回的unionid也不同

注：第三方服务商调用上述接口时，获取到的unionid是第三方服务商主体下的unionid。如果第三方服务商已通过其他方式获取到企业主体下的unionid，可调用外部联系人unionid转换接口，将对应的unionid换成服务商名下的external_userid，基于external_userid识别同一客户。

文档ID: 31072
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/95149
https://open.work.weixin.qq.com/api/doc/90000/90135/95159

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

external_userid_list

array[string]

必需

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

示例

{
  "external_userid_list": [
    "wmxxxxxxxxxxxxxxxxxxxxxx",
    "zhangsan"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

可选

customer_list

array [object {5}]

返回结果

可选

external_userid

string

可选

微信客户的external_userid

unionid

string

可选

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

gender

integer <int32>

性别

可选

nickname

string

微信昵称

可选

avatar

string

可选

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

errmsg

string

错误码描述

可选

invalid_external_userid

array[string]

可选

示例

{
  "errcode": 0,
  "customer_list": [
    {
      "external_userid": "string",
      "unionid": "string",
      "gender": 0,
      "nickname": "string",
      "avatar": "string"
    }
  ],
  "errmsg": "string",
  "invalid_external_userid": [
    "string"
  ]
}

如何获取微信客户的unionid#

请求参数

示例代码

返回响应

如何获取微信客户的unionid