获取去重后的客户列表
最后更新:2023/01/05企业可通过此接口获取按去重后的客户列表(按企业内第一添加人去重,仅返回客户的第一添加人与其给客户的备注信息)。
第一添加人:企业内第一个添加客户为好友的员工(若该员工与客户解除好友关系,则顺延为下一个添加的员工)
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/customer/info/list
参数示例:
{
"userids": [
"wmJYSuBgAAFyDEU2SLeCVZbblxaxzX4w",
"ozynqfsdf2dkjsfsdfhsdf-nuasdBBB",
"woAJ2GCAAAXtWyujaWJHDDGi0mACHAAA",
"ozynqsulJFCZ2z1aYeS8h-nuasdAAA"
],
"type": 2,
"current_index": 1,
"page_size": "100"
}
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
userids | string[] | 否 | 企业客户的userid,多个userid用逗号隔开。 一次不超过100个 |
current_index | int | 否 | 页码。默认值为1 |
page_size | int | 否 | 列表返回长度。默认值为20,最大值为100 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": {
"total": 4,
"records": [
{
"external_userid": "wmJYSuBgAAFyDEU2SLeCVZbblxaxzX4w",
"name": "凉夏",
"type": 1,
"gender": 2,
"add_user_id": "YunHanceshi",
"avatar": "http://p.qlogo.cn/bizmail/IcsdgagqefergqerhewSdage/0",
"corp_full_name": "极速快递",
"add_time": 1608269181797
},
{
"external_userid": "woAJ2GCAAAXtWyujaWJHDDGi0mACHAAA",
"name": "西西",
"type": 1,
"gender": 2,
"add_user_id": "YunHanceshi",
"avatar": "http://p.qlogo.cn/bizmail/IcsdgagqefergqerhewSdage/0",
"corp_full_name": "极速快递",
"add_time": 1608269181797
}
]
}
}
返回说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 出错返回码,为0表示成功,非0表示调用失败 |
msg | string | 返回码描述 |
data | Page | 分页对象 |
total | int | 总量 |
records | Customer[] | 客户列表 |
external_userid | string | 外部联系人id |
name | string | 姓名 |
type | int | 外部联系人的类型,1表示该外部联系人是微信用户,2表示该外部联系人是企业微信用户 |
gender | int | 外部联系人性别 0-未知 1-男性 2-女性 |
add_user_id | string | 添加人账号id |
avatar | string | 头像地址完整url |
corp_full_name | string | 公司全称 |
add_time | long | 添加时间 |