获取线索列表
最后更新:2025/01/15请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/crm/clue/page
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"follow_user_id": "",
"start_time": 1638785104000,
"end_time": 1638785104000,
"current_index": 1,
"page_size": 10,
"states": [
1,
2
],
"clue_pool_ids": [
1522843564091630593
],
"tag_relation_type": 1,
"tag_ids": "etvvCXcAAAZHYVzWCdeCCnTcIM2vtRPw"
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
follow_user_id | string | 否 | 跟进人id(分配的指定人员工id) |
start_time | long | 否 | 线索创建起始时间 |
end_time | long | 否 | 线索创建结束时间 |
current_index | int | 是 | 页码。默认值为1 |
page_size | int | 是 | 列表返回长度。默认值为20,最大值为100 |
states | int | 否 | 状态:0:未分配,1:待添加,2:待通过,3:待关联,4:已锁定,5:已转化 |
clue_pool_ids | array | 否 | 线索池ID |
tag_relation_type | int | 否 | 标签筛选类型 1 满足任意标签, 2 满足所有标签, 3 无标签 |
tag_ids | string | 否 | 标签ID,英文逗号分隔 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": [
{
"clue_id": 1539169150405479425,
"clue_name": "黄杉少女",
"mobile_phone": "15827238888",
"clue_corp_name": "日月光封装测试(上海)有限公司",
"tag_list": [
{
"tagId": "etvvCXcAAAZHYVzWCdeCCnTcIM2vtRPw",
"tagName": "小学"
}
],
"state": 1,
"follow_user_id": "wovvCXcAAAFa-yRtEAUjgQCyjqN9TJ7A",
"clue_pool_id": 1522843564091630593,
"clue_pool_name": "默认线索池",
"access_customer_channel": "广告-巨量引擎-头条",
"area": "湖北省-武汉市-洪山区",
"description": "这是描述",
"recovery_num": 0,
"recovery_remark": null,
"recovery_remark_type": "1",
"recovery_remark_input_text": "用户填写的退回原因文本内容",
"create_user_id": "wovvCXcAAAFa-yRtEAUjgQCyjqN9TJ7A",
"gmt_create": 1655801496,
"field_map": {
"mf_clue_52": [
{
"name": "选项1",
"id": "1539179902926138370"
},
{
"name": "选项2",
"id": "1539179902926138371"
}
],
"mf_clue_51": [
{
"name": "选项2",
"id": "1539179902561233923"
}
],
"mf_clue_1": "3234",
"mf_clue_53": [
{
"name": "分类1",
"id": "1539179903198768129"
},
{
"name": "分类1",
"id": "1539179903202962433"
}
],
"mf_clue_101": "2022-06-21"
},
"business_tags": {
"group_id": "sttFmKWgAAVTx9AZV2oSegA2yLjeSqPQ",
"group_name": "范围222",
"tag_name": "666",
"tag_id": "sttFmKWgAAHPu3UqphM2zjPOI7aLt-BQ",
"type": 3,
"strategy_id": 2,
"manage_group_name": "管理组222"
},
"external_user_id": "xxxxxxxxxxxxx",
"merge_time": 1655801496,
"last_follow_user_id": "xxxxxxxxxxxxxxx"
}
]
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码 |
msg | string | 对返回码的文本描述内容 |
data | array | |
clue_id | long | 线索id |
clue_name | string | 线索姓名 |
mobile_phone | string | 手机号码 |
clue_corp_name | string | 企业名称 |
tag_list | array | 标签 |
tag_id | string | 标签id |
tag_name | string | 标签名称 |
state | int | 线索状态 0 未分配 1 待添加 2 待通过 3 待关联 4 已锁定 5 已转化 |
follow_user_id | string | 跟进人 |
clue_pool_id | long | 所属线索池id |
clue_pool_name | string | 所属线索池名称 |
access_customer_channel | string | 获取渠道 |
area | string | 地区 |
description | string | 描述 |
recovery_num | int | 回收次数 |
recovery_remark | string | 退回原因文本 |
gmt_create | long | 线索创建时间 |
recovery_remark_type | string | 退回原因类型:1:手机号码为空号,2:无人接听,3:无意向,4:已购买其他产,,5:自动,收,6:其他,如果有自定义原因,则为其他值,多级值用","拼接 |
recovery_remark_input_text | string | 用户填写的退回原因文本内容 |
create_user_id | string | 线索创建人 |
external_user_id | string | 关联企微客户ID |
merge_time | long | 转化时间 |
last_follow_user_id | string | 最后跟进人id |
field_map | map | 自定义字段 |
business_tags | obj[] | 业务标签 |
group_id | str | 标签组id |
group_name | str | 标签组名称 |
tag_name | str | 标签名称 |
tag_id | str | 标签id |
type | int | 类型 |
strategy_id | long | 业务标签规则组(客户标签才有) |
manage_group_name | str | 管理组名称 |