根据三方客户id批量查询自建客户数据
最后更新:2023/11/22重要通告:2023年12月1日00:00后购买安装的企业将无法调用此接口,具体原因可咨询相关产品人员或开发人员
企业可通过此接口批量获取自建客户数据(一次最多不超过50个)。
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/customer/list/selfCustomers
参数示例:
{
"external_userid_list": [
"wmDkH9EAAAd3viRGyp-upCB5hd2UQGEg",
"ozynqsulJFCZ2z1aYeS8h-nuasdAAA"
],
"userid": "admin"
}
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
external_userid_list | string[] | 是 | 三方客户id集合(最多传50个) |
userid | string | 否 | 三方用户id |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": [
{
"origin_external_userid": "admin",
"name": "段鹏飞",
"unionid": "oLRmLxD8mdtZjzGK6p-QRxFGWmdU",
"type": 1,
"gender": 2,
"follow_users": [
{
"origin_userid": "admin",
"userid": "admin",
"tags": [
{
"group_name": "标签分组名称",
"tag_name": "标签名称",
"tag_id": "etAJ2GCAAAXtWyujaWJHDDGi0mACHAAA",
"type": 1
}
]
}
]
}
]
}
返回说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 出错返回码,为0表示成功,非0表示调用失败 |
msg | string | 返回码描述 |
data | SelfCustomerInfoResponse | 返回码描述 |
origin_external_userid | string | 自建应用的userid |
name | string | 客户名称 |
unionid | string | 外部联系人在微信开放平台的唯一身份标识(微信unionid),通过此字段企业可将外部联系人与公众号/小程序用户关联起来。仅当联系人类型是微信用户,且企业或第三方服务商绑定了微信开发者ID有此字段。 unionid从2022年6月20后产生的客户不再返回 |
type | int | 客户类型,1:微信用户, 2:企业微信用户 |
gender | int | 客户性别 0-未知 1-男性 2-女性 |
follow_users | FollowUser[] | 外部联系人所在企业的主体名称,仅当联系人类型是企业微信用户时有此字段 |
origin_userid | string | 自建用户id |
userid | string | 三方用户id |
tags | Tag[] | 该成员添加此外部联系人所打标签 |
group_name | string | 该成员添加此外部联系人所打标签的分组名称 |
tag_name | string | 该成员添加此外部联系人所打标签名称 |
type | int | 该成员添加此外部联系人所打标签类型, 1-企业设置, 2-用户自定义 |
tag_id | string | 该成员添加此外部联系人所打企业标签的id |