2.0任务修改
请求接口:
/agent-api/new/user/{user_id}/task/{task_id}
请求方式
PUT
路由参数
参数 | 类型 | 示例 | 解释 | 必填 |
user_id | string | 5832d184-dd53-42a0-8ace-0bf8d660f4cc | 用户id | 是 |
task_id | string | f232d184-dd54-42a0-8ace-0bf8d660f4cc | 任务id | 是 |
请求参数
参数 | 类型 | 示例 | 解释 | 必填 |
sub_user_id | string | 5b55bcca-d653-4a58-8f9a-437fb0601f8e | 子账户id(传递此参数则是对子账户操作) | 否 |
bridge_group_id | int | 1 | 使用转接组的id 不传这个键,则表示为空。传了则必填 | 否 |
destination_extension | int | 297 | 使用话术分组的id | 是 |
dial_time_id | int | 5 | 呼叫时间组ID | 是 |
maximumcall | int | 1 | 线路并发数 | 是 |
name | string | 测试任务 | 任务名称 | 是 |
remark | string | 第一个任务 | 任务描述 | 否 |
auto_recycle_rule_id | int | 1 | 重呼规则id | 否 |
elasticity_type | bool | false | 动态坐席 | 否 |
end_action | int | 1 | 任务结束动作 此动作不能与动态坐席同时开启 | 否 |
background_id | int | 25 | 背景音id | 否 |
llm_intention_id | int | 1 | 大模型质检配置id | 否 |
task_extras | array | 2.0 任务配置信息 | 是 | |
task_extras.start_time | string | 2024-11-01 13:25:26 | 任务开始时间 | 是 |
task_extras.stop_time | string | 2025-11-01 13:25:26 | 任务结束时间 | 是 |
task_extras.holiday | array | [ { "start": "2024-11-01 13:25", "end": "2024-11-03 13:25" } ] | 停止工作时间 | 否(注意不传也需要传空数组值) |
line | array | [ "29c39ec4-b292-4af9-a88b-922d61866sub"], | 线路id | 否 |
interval_time | int | 0 | 呼叫时间间隔 (默认为0) | 否 |
💡 注意:
1.除了必填以外,不用的参数可以不传 (line & holiday参数除外,不传线路信息也需传递空数组)
2.请特别注意,为了方便2.0外呼任务,可使用旧时间组 (dial_time_id),进行创建或更新2.0任务操作,但时间组中工作时间的更新,目前并未与使用其的任务同步。
2.0 任务更新需要暂停任务才可进行更新
如果使用2.0 任务,需暂停任务才可以修改 否则会出现以下报错
{
"code": 6007,
"status": "error",
"message": "2.0任务启动中,请先停止任务",
"data": []
}
2
3
4
5
6
请求示例:
{
"name": "测试api接口创建-222",
"destination_extension": 102, // 话术分组id
"maximumcall": 1, // 并发总数 (线路总并发)
"dial_time_id": 5, // 呼叫时间组
"background_id": 52, // 背景音id 需要提供背景音列表等接口
"task_extras": {
"start_time": "2024-11-01 13:25:26", // 开始时间 (必填)
"stop_time": "2025-11-01 13:25:26", // 结束时间
"line": [], //line参数除外,不传线路,也需传递空数组
"holiday": [ // 假期时间 (选填)可设置多个 (不传,也需传递空数组)
{
"start": "2024-11-01 13:25",
"end": "2024-11-03 13:25"
}
],
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
字段分析:
maximumcall 为所选线路的总并发数之和,每条所选线路使用的并发数为平均并发数,即设置总并发数,必须为设置线路数量整除。 平均并发数(不得超过选用线路的residue值)
返回参数
{
"code": 200,
"status": "success",
"message": "修改成功",
"data": ""
}
2
3
4
5
6