获取线索列表

最后更新: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 管理组名称

results matching ""

    No results matching ""