获取商机跟进记录

企业可通过此接口获取商机跟进记录

请求方式: POST(HTTPS)

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

Query参数:

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

参数示例:

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

返回值:

{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "total": 1,
    "records": [
      {
        "follow_id": 1537309758273788929,
        "stage_id": "1531601499997297665",
        "opportunity_id": 1535988810946098178,
        "opportunity_name": "裤子",
        "record_type": 3,
        "contact_type": "企微联系",
        "follow_content": "<div></div>",
        "location_lat": "",
        "location_lng": "",
        "location_name": "",
        "user_id": "YuanYe",
        "gmt_create": 1655358182,
        "attachment": [],
        "field_map": null
      }
    ]
  }
}

返回说明:

参数 类型 说明
code int 出错返回码,为0表示成功,非0表示调用失败
msg string 返回码描述
data object 商机跟进列表
  follow_id long 跟进id
  stage_id string 商机阶段id
  opportunity_id long 商机id
  opportunity_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 ""