流失客户列表
企业可通过此接口获取指定成员流失的客户列表。
请求方式: GET(HTTPS)
请求地址: https://open.wshoto.com/openapi/customer/info/outflow/list
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
loss_type | int | 否 | 查询类型 0-全部,1-客户删除员工,2-员工删除客户 |
tagid | string | 否 | 标签id |
userid | string | 否 | 企业成员的userid |
add_start_date | long | 否 | 添加开始时间,时间戳(毫秒),精确到天 |
add_end_date | long | 否 | 添加结束时间,时间戳(毫秒),精确到天 |
loss_start_date | long | 否 | 删除开始时间,时间戳(毫秒),精确到天 |
loss_end_date | long | 否 | 删除结束时间,时间戳(毫秒),精确到天 |
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,
"tag_id": [
"etvvCXcAAAvOuy3C-eqDZLXyyqOKxYzQ"
],
"del_time": 1658417991
},
{
"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,
"tag_id": [
"etvvCXcAAAZHYVzWCdeCCnTcIM2vtRPw"
],
"del_time": 1658418000
}
]
}
}
返回说明:
参数 | 类型 | 说明 |
---|---|---|
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 | 添加时间 |
tag_id | array | 标签id |
del_time | long | 删除时间 |