获取客户跟进记录

最后更新:2023/12/11

企业可通过此接口获取客户跟进记录

请求方式: POST(HTTPS)

请求地址: https://open.wshoto.com/openapi/crm/follow/customer/list?access_token=x

Query参数:

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

参数示例:

{
  "current_index":1,
  "page_size":10,
  "user_id":"",
  "external_user_id":"",
  "follow_id":null,
  "start_time":null,
  "end_time":null
}
参数 类型 必填 说明
current_index int 页码。默认值为1
page_size int 列表返回长度。默认值为20,最大值为100
user_id string 员工id(员工id和客户id必须同时为空或者同时不为空)
external_user_id string 客户id(员工id和客户id必须同时为空或者同时不为空)
follow_id long 跟进id
start_time long 开始时间(单位:秒),时间区间不能超过30天
end_time long 结束时间(单位:秒),时间区间不能超过30天

返回值:

{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "total": 1,
    "records": [
      {
        "follow_id": 1538877699425540097,
        "external_user_id": "wovvCXcAAAgMMKzBHESPYl5Moh7mP8ZQ",
        "external_user_name": "吴陈迪",
        "record_type": 1,
        "contact_type": "企微联系",
        "follow_content": "jz企微联系跟进测试3",
        "location_lat": "1",
        "location_lng": "2",
        "location_name": null,
        "user_id": "chen-di",
        "gmt_create": 1655732009,
        "attachment": [
          {
            "cos_url": "https://javatest-1253767630.cos.ap-shanghai.myqcloud.com/appww078fe5f69b4761f6/2022/06/920068e6-6895-4175-83b5-faec6c82c809.pdf",
            "file_extension": "pdf",
            "name": "920068e6-6895-4175-83b5-faec6c82c809.pdf",
            "type": null
          }
        ],
        "field_map": null
      }
    ]
  }
}

返回说明:

参数 类型 说明
code int 出错返回码,为0表示成功,非0表示调用失败
msg string 返回码描述
data object 客户跟进列表
  follow_id long 跟进id
  external_user_id string 客户id
  external_user_name string 客户名称
  record_type int 类型信息
1:客户跟进,3:商机跟进,4:未关联的线索跟进,8:线索跟进
  contact_type string 跟进方式
系统: 拜访、企微联系、电话联系、其他跟进、线上会议、打电话、加好友(企微加好友)、加好友(发短信加好友)
自定义字段:传递企业配置的自定义字段
  follow_content string 跟进内容
  location_lat string 拜访位置纬度
  location_lng string 拜访地址经度
  location_name string 拜访位置名称
  user_id string 跟进人id
  gmt_create long 创建时间(单位:秒)
  field_map map 自定义字段
  attachment object 本地文件
    cos_url string 文件路径
    file_extension string 文件后缀(pdf,xls,xlsx,doc,docx,ppt,pptx)
    name string 文件名
    type string 文件类型(web,file,video,image)

results matching ""

    No results matching ""