获取线索列表

最后更新:2026/08/13

请求方式: POST(HTTPS)

请求地址: https://open.wshoto.com/openapi/crm/clue/page

Query参数:

参数 类型 必填 说明
access_token string 调用接口凭证

Body参数:

{
  "follow_user_id": "",
  "start_time": 1638785104,
  "end_time": 1638975104,
  "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 线索创建起始时间(时间戳:秒)(开始时间和结束时间范围不可超过90天)
end_time long 线索创建结束时间(时间戳:秒)(开始时间和结束时间范围不可超过90天)
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": {
    "total": 1,
    "records": [
      {
        "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 obj
  total long 总行数
  records array 数据列表c
    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
    contact_name string 跟进状态,已跟进OR未跟进
    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 管理组名称

results matching ""

    No results matching ""