员工跟进列表
最后更新: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 | 提醒内容 |