获取客户跟进&超级群发任务列表(新)
企业可通过此接口获取客户跟进&超级群发任务列表
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/task/follow_up/page_query_task_info_list
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"start_time": 1658557182,
"end_time": 1663913982,
"template_name": "template_name",
"current_index": 1,
"page_size": 10,
"status_list": [
"123"
],
"task_ext_type": "normal",
"task_type": 1,
"create_user_ids": [
"123"
]
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
start_time | long | 否 | 任务创建起始时间(年月日,时间戳,开始时间填写后,结束时间必填;开始-结束时间不可超过90天) |
end_time | long | 否 | 任务创建结束时间(年月日,时间戳,结束时间填写后,开始时间必填;开始-结束时间不可超过90天) |
template_name | string | 否 | 任务名称 |
current_index | int | 否 | 页码。默认值为1 |
page_size | int | 否 | 列表返回长度。默认值为20,最大值为100 |
status_list | array | 否 | 任务状态列表 0-未开始,1-创建中,2-进行中,3-已结束,4-已失效,-1.创建失败 |
task_ext_type | string | 否 | open接口任务类型,默认值normal,具体值open接口可以跟进业务自己指定。 |
task_type | int | 是 | 任务类型:1.跟进客户;2.跟进客户群;3 超级群发 |
create_user_ids | array | 否 | 创建人id集合 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": {
"total": 1,
"records": [
{
"template_id": 1561935932083487170,
"template_name": "每周会员日营销任务-测试",
"template_type": 1,
"priority": 2,
"create_user_id": "wovvCXcAAAxdLxG8LIIGhSiI8yUVWJGQ",
"delay_type": 1,
"create_time": 1661229520,
"update_time": 1661229520,
"end_time": 1661346513,
"status": 1,
"task_mode": 1,
"task_ext_type": "normal",
"source": 1,
"error_info": "当任务的状态status = -1时,会有这个失败的错误原因"
}
]
}
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码 |
msg | string | 对返回码的文本描述内容 |
data | object | |
total | long | |
records | object[] | |
template_id | long | 任务id |
template_name | string | 任务名称 |
template_type | int | 任务类型:1.跟进客户;2.跟进客户群;3 超级群发 |
status | int | 任务状态;0.未开始;1.创建中;2.进行中;3.已结束;4.已失效;-1.创建失败 |
source | int | 任务的来源:1-标准创建,2-openAPI创建,3-sop创建 |
delay_type | int | 发送类型;1-立即发送,2-定时发送; |
create_user_id | string | 创建人id |
priority | int | 优先级,1-低,2-中,3-高,4-一星,5-二星,6-三星,7-四星 |
update_time | long | 任务更新时间,时间戳,精度:秒 |
end_time | long | 任务结束时间,时间戳,精度:秒 |
create_time | long | 任务创建时间,时间戳,精度:秒 |
send_time | long | 任务发送时间,时间戳,精度:秒 |
task_mode | int | open接口任务模式.1-常规模式,2-数据同步模式 普通模式会发送待办和企微通知,数据同步模式不发送待办和企微通知。如果使用[数据同步模式],将忽略 sendNotify |
task_ext_type | string | open接口任务类型 |
error_info | string | 当任务的状态status = -1时,会有这个失败的错误原因 |