2.0任务创建
接口
/agent-api/new/user/{user_id}/task请求方式
POST路由参数
参数 | 类型 | 示例 | 解释 | 必填 |
user_id | string | 5832d184-dd53-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 | 测试任务 | 任务名称 | 是 |
random_assignment_number | int | 0 | 固定为0 | 否 |
recycle_limit | int | 1 | 呼叫失败最大重拨次数[弃用，有且只能为0] | 否 |
remark | string | 第一个任务 | 任务描述 | 否 |
auto_recycle_rule_id | int | 1 | 重呼规则id | 否 |
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" } ] | 任务假期休息时间 | 否 |
task_extras.line | array | [ "29c39ec4-b292-4af9-a88b-922d61866sub"], | 线路id （初始化接口获取） | 是 |
task_extras.interval_time | int | 0 | 呼叫时间间隔 （默认为0） | 否 |
请求示例
💡 注意：
1.除了必填以外,不用的参数可以不传 (line 和 holiday 参数除外，不传线路信息也需传递空数组)
2.请特别注意，为了方便2.0外呼任务,可使用旧时间组 (dial_time_id)，进行创建或更新2.0任务操作，但时间组中工作时间的更新，目前并未与使用其的任务同步。
{
"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", // 结束时间 （必填）
"holiday": [ // 假期时间 （选填）可设置多个 （如果不传，也需传递空数组）
{
"start": "2024-11-01 13:25",
"end": "2024-11-03 13:25"
}
],
"line": [], //line参数除外，不传线路，也需传递空数组
"interval_time": 0 // 呼叫间隔 （选填,默认为 0）
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
字段分析：
maximumcall 为所选线路的总并发数，每条所选线路使用的并发为平均并发数，即设置总并发数，必须为设置线路数量整除。 平均并发数(不得超过选用线路的residue值)
返回参数
{
"code": 200,
"status": "success",
"message": "创建任务成功",
"data": {
"id": "ec33b068-4aa1-40da-abe5-8f411b6f88d5"
}
}
2
3
4
5
6
7
8
