获取任务详情
最后更新:2024/1/8企业可通过此接口获取跟进任务和超级群发详情
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/task/follow_up/query_task_detail_info
Query参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"template_id": 1254676189925432389
}
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| template_id | long | 是 | 任务ID |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": {
"template_id": 21,
"template_name": "test_1027fd64538b",
"template_type": 1,
"priority": 1,
"create_user_id": "test_d82e59962f3a",
"delay_type": 1,
"create_time": 79,
"update_time": 61,
"end_time": 75,
"send_time": 86,
"status": 1,
"task_mode": 1,
"source": 1,
"error_info": "test_c108e2cb617f",
"filter_type": 1,
"explain": {
"content": "test_bd1d8c54e6fe",
"materials": [
{
"id": 47,
"type": 1,
"act_child_type": 1,
"send_type": 1,
"combination_id": "test_532c7dd83fa9",
"package_config_id": "test_032185b7424a",
"is_poster": true
}
]
},
"verbal_wrap": {
"verbal_type": 1,
"materials": [
{
"id": 1,
"type": 1,
"act_child_type": 1,
"send_type": 1,
"combination_id": "test_34e3c427384b",
"package_config_id": "test_add133889e47",
"is_poster": false
}
]
},
"filter_range_info": "test_a08e263134a8"
}
}
参数说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | int | 返回码 |
| msg | string | 对返回码的文本描述内容 |
| data | object | |
| template_id | long | 任务id |
| template_type | int | 任务类型.1-跟进客户,2-跟进客户群,3 超级群发 |
| template_name | string | 任务名称 |
| priority | int | 优先级,1-低,2-中,3-高,4-一星,5-二星,6-三星,7-四星 |
| create_user_id | string | 创建人id |
| delay_type | int | 发送类型.1-立即发送,2-定时发送 |
| create_time | long | 创建时间,时间戳,精度:秒 |
| update_time | long | 更新时间,时间戳,精度:秒 |
| end_time | long | 任务执行结束时间,时间戳,精度:秒 |
| send_time | long | 发送时间,时间戳,精度:秒 |
| status | int | 任务状态;0.未开始.1-创建中,2-进行中,3-已结束,4-已失效,-1-创建失败 |
| task_mode | int | 任务模式.1-常规模式,2-数据同步模式 |
| task_ext_type | int | open接口任务类型 |
| source | int | 任务的来源.1-标准创建,2-openAPI创建,3-sop创建 |
| error_info | string | 当任务的状态status = -1时,会有这个失败的错误原因 |
| explain | object | 任务说明对象查看详细字段 |
| verbal_wrap | object | 任务话术对象查看详细字段 |
| filter_range_info | string | 筛选范围,数据格式:json |
| filter_type | int | 筛选过滤类型, 1-指定条件筛选群 2-指定客户群关系对,需根据「获取员工执行情况」和「获取员工的客户群送达情况」来获取 3-指定条件筛选客户 4-指定客户关系对,需根据「获取员工执行情况」和「获取员工的客户群送达情况」来获取 |
| 参数 | 类型 | 说明 |
|---|---|---|
| verbal_title | string | 话术标题内容 |
| materials | array | 素材集合,集合内部对象为object类型查看详细字段 |
| 参数 | 类型 | 说明 |
|---|---|---|
| content | string | 任务说明文本内容 |
| materials | array | 任务说明素材集合,集合内部对象为object类型查看详细字段 |
| 参数 | 类型 | 说明 |
|---|---|---|
| id | long | 主键id |
| uuid | string | 加密主键 |
| type | int | 素材类型.1-海报, 2-文本, 3-图片, 4-文章, 5-语音, 6-视频, 7-文件, 8-小程序, 9-外部链接, 10-优惠券, 11-商品, 12-活动(actChildType:1-拼团,2-秒杀,3-抽奖) |
| act_child_type | Int | 活动素材子类型,1-拼团,2-秒杀,3-抽奖.当type=12时有值 |
| combination_id | string | 关联的组合素材id |
| package_config_id | string | 组合素材分类id |
| send_type | int | 发送形式.1-轨迹形式, 2-普通形式. |
| is_poster | bool | true为标识为海报图片素材 false为普通素材图片 |
filter_range_info字段参数(filter_type = 1)
| 参数 | 类型 | 说明 |
|---|---|---|
| group_owner_range | object | 群主范围查看详细字段 |
| group_name_list | array | 群名关键词 |
| include_tags | object | 客户包含标签查看详细字段 |
| chat_id_list | array | 群聊id集合 |
| is_all_customer | bool | 是否所有客户 |
| is_all_customer_group | bool | 是否所有客户群 |
filter_range_info字段参数(filter_type = 3)
| 参数 | 类型 | 说明 |
|---|---|---|
| add_user_range | object | 添加人范围查看详细字段 |
| add_time_range | object | 添加时间范围查看详细字段 |
| include_tags | object | 客户包含标签查看详细字段 |
| exclude_tags | object | 客户剔除标签查看详细字段 |
| locations | array | 所在地区信息数组查看详细字段 |
| chat_list | array | 所在群聊数组查看详细字段 |
| sex | string | 性别:ALL-全部;M-男;F-女;UNKNOW-未知; |
| age_range | string | 年龄范围,用\"~\"分隔;例如:25~30 |
| remark_key_words | array | 备注名关键词集合 |
| description_key_words | array | 描述关键词集合 |
| is_all_customer | bool | 是否所有客户 |
| is_all_customer_group | bool | 是否所有客户群 |
| 参数 | 类型 | 说明 |
|---|---|---|
| user_id_list | array | 员工ID列表 |
| dept_id_list | array | 部门ID列表 |
| user_tags | object[] | 员工标签列表 |
| 参数 | 类型 | 说明 |
|---|---|---|
| tag_id | string | 标签id |
| tag_name | string | 标签名称 |
| 参数 | 类型 | 说明 |
|---|---|---|
| start_time | long | 查询开始时间 |
| end_time | long | 查询结束时间 |
| 参数 | 类型 | 说明 |
|---|---|---|
| operator | int | 标签集合内的运算规则 (1:满足任意一个标签;2:同时满足所有标签;3:无标签客户;4:且或标签) |
| tag_list | array | 标签集合查看详细字段 |
| 参数 | 类型 | 说明 |
|---|---|---|
| tag_id | string | 标签id |
| tag_name | string | 标签名称 |
| tag_type | int | 标签的类型(客户标签才有),1:企业标签,2.个人标签,3.业务标签 |
| strategy_id | int | 业务标签规则组(客户标签才有) |
| 参数 | 类型 | 说明 |
|---|---|---|
| region_code | string | 地区编码 |
| region_remark | string | 省市区之间用英文半角逗号分隔;例如:北京市,北京市,东城区 |
| 参数 | 类型 | 说明 |
|---|---|---|
| chat_id | string | 群聊id |
| chat_name | string | 群聊名称 |