获取商机跟进记录
企业可通过此接口获取商机跟进记录
请求方式: 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) |