员工跟进列表

最后更新:2025/09/12

企业可通过此接口查询员工跟进记录

请求方式: POST(HTTPS)

请求地址: https://open.wshoto.com/openapi/crm/follow/list

Query参数:

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

Body参数:

{
  "target_type": 1,
  "target_id_list": [
    "123",
    "456"
  ],
  "id_list": [
    "789"
  ],
  "follow_user_ids": [
    "user123"
  ],
  "follow_dep_ids": [
    1001,
    1002
  ],
  "follow_type_list": [
    1,
    2
  ],
  "follow_type_name": "电话跟进",
  "title": "系统跟进",
  "follow_time_start": "2025-01-01",
  "follow_time_end": "2025-02-07",
  "current_index": 1,
  "page_size": 20
}
参数 类型 必填 说明
current_index int 当前页,默认值为1
page_size int 每页大小,默认值为20,最大为100
target_type int 跟进对象类型:1-客户跟进,3-商机跟进,4-线索跟进,9-订单跟进,10-群跟进,11-联系人跟进,12-企业跟进
target_id_list string[] 跟进目标ID列表
id_list string[] 跟进ID列表
follow_user_ids string[] 跟进人ID列表
follow_dep_ids long[] 跟进人所在部门列表
follow_type_list long[] 跟进方式ID列表
follow_type_name string 跟进方式名称
follow_time_start string 跟进时间开始,格式为yyyy-MM-dd
follow_time_end string 跟进时间结束,格式为yyyy-MM-dd

返回值:

{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "total": 1,
    "records": [
      {
        "id": 1234567890,
        "follow_user_id": "user123",
        "content": "跟进内容",
        "target": {
          "contact_id": "contact123",
          "external_id": "external123",
          "company_id": "company123",
          "chat_id": "chat123",
          "clue_id": "clue123",
          "is_ai": false
        },
        "business_type": 1,
        "business_id": "business123",
        "follow_type": 1,
        "follow_type_desc": "电话跟进",
        "field_map": {
          "custom_field_1": "自定义字段值"
        },
        "attachment_list": [
          {
            "cos_url": "https://example.com/file.jpg",
            "file_extension": "jpg",
            "material_id": "material123",
            "name": "附件名称",
            "type": "image"
          }
        ],
        "location": {
          "location_lat": "39.9042",
          "location_lng": "116.4074",
          "location_address": "北京市朝阳区"
        },
        "follow_time": 1707292800000,
        "remind": {
          "is_remind": 1,
          "time": 1707379200000,
          "before": 3600000,
          "user_ids": [
            "user123"
          ],
          "content": "提醒内容"
        }
      }
    ]
  },
  "sub_code": "00000"
}

参数说明:

参数 类型 说明
code int 返回码
msg string 对返回码的文本描述内容
data object 结果
 total long 总条数
 records object[] 跟进记录信息
  id long 跟进ID
  follow_user_id string 跟进人ID
  content string 跟进内容
  target object 跟进对象
   contact_id string 联系人ID
   external_id string 外部联系人ID
   company_id string 企业ID
   chat_id string 群聊ID
   clue_id string 线索ID
   is_ai boolean 是否ai跟进
  business_type int 关联业务类型
  business_id string 关联业务ID
  follow_type long 跟进方式ID
  follow_type_desc string 跟进方式描述
  field_map map 自定义字段
  attachment_list object[] 附件列表
   cos_url string 附件URL
   file_extension string 文件扩展名
   material_id string 素材ID
   name string 附件名称
   type string 附件类型
  location object 跟进地址信息
   location_lat string 跟进地址纬度
   location_lng string 跟进地址经度
   location_address string 跟进地址名称
  follow_time long 跟进时间戳
  remind object 跟进提醒信息
   is_remind int 是否提醒,0-不提醒,1-提醒
   time long 下次跟进时间戳
   before long 开始前提醒时间间隔
   user_ids string[] 提醒人ID列表
   content string 提醒内容

results matching ""

    No results matching ""