更新任务V2
更新时间:2025-07-30
URL
https://aiob-open.baidu.com/api/v4/console/apitask/update
HTTP Method
POST
请求参数
Header
参数名称 | 是否必须 | 说明 | 示例 |
---|---|---|---|
Content-Type | 是 | application/json | application/json |
Authorization | 是 | 参考「生成认证Token」文档 | cc-api-auth-v1/5b050c050f5a4e74b8c20bf512e39c1d/2021-04-13T08:05:43Z/1800000/host;x-bce-date/746ed9ad706c379f31bafc292e3c720797e39bb7f08ce5f641d657e14e42dd33 |
Body
参数名称 | 类型 | 是否必须 | 说明 | 示例 |
---|---|---|---|---|
taskId | string | 是 | 任务ID,任务唯一标识 | "731346584781056" |
robotId | string | 否 | 外呼机器人唯一标识,以“,”分割 当传入多个robotId时为多机器人模式(ABTest模式下仅支持2-3个机器人 顺序协同模式下仅支持2~最大重呼次数[maxRetryTimes]个机器人) 注意:更新任务仅支持原机器人模式,即单机器人模式下不可传入多个robotId,多机器人模式下不可传入单个robotId |
“90132624528086591” |
dialStartDate | string | 是 | 任务呼叫开始日期 | "2020-10-12" |
dialEndDate | string | 否 | 任务呼叫结束日期,如:XXXXX,默认为空,表示不限制终止时间 | "2020-10-12" |
dialTimeType | int | 否 | 0:选项型,1:自定义呼叫 | 0 |
dialTimeInDay | int | 否 | 0:早九晚六,1:早就晚五,2:早十晚六,3:早十晚五 | 0 |
dialTimeType | int | 否 | 0:选项型,1:自定义呼叫 | 0 |
dialDayInWeek | int | 否 | 0:所有自然日,1:工作日,2:周末 | 0 |
dialNoonBreak | int | 否 | 0:不午休,1:午休一小时,2:午休两小时 | "2020-10-12" |
dialWeeklyInfo | sarray | 否 | array.size 必须等于 7 对应一周7天 按照下标对应星期几 示例中拨打策略为周一8:00-12:00,14:00-18:00,周二9:00-17:00,周六7:00-8:00,12:00-13:00,周三到周五、周日传空,不拨打 |
[ [["8:00","12:00"],["14:00","18:00"]], [["9:00","17:00"]], [], [], [], [["7:00","8:00"],["12:00","13:00"]], [] ] |
holidaySeason | array | 否 | 禁呼节假日 | [4747201282572288] |
connectedTimes | Integer | 否 | 最大接通次数(仅可设置为1 ~ 最大重呼次数[maxRetryTimes]+1) (仅在多机器人策略为顺序协同模式下生效) |
3 |
callerNums | array | 否 | 主叫号码,默认为空,表示将随机获取可用号码进行外呼 | ["07567171348","07567171349"] |
blackListStrategy | int | 否 | 1-触发黑名单后该号码组不再拨打;2-触发黑名单后该号码不再拨打;默认为空,即不过滤黑名单 | 1 |
isSetCapacity | int | 否 | 通路数类型,默认为空,即空闲通路弹性调节:0-空闲通路弹性调节;1-最低保障通路;2-固定通路; | 0 |
taskCapacity | int | 否 | 设置通路数大小,N为 整数,且 N ≤ 任务可用通路数和,默认为0,即空闲通路弹性调节 | 5 |
isOpenEmptyNum | boolean | 是 | 是否开启24小时空号检测 | false |
isOpenPhoneDown | boolean | 是 | 是否开启12小时内停机检测 | false |
isOpenRepeatFilter | boolean | 否 | 是否开启重复号码过滤,true为开启,false为关闭 | false |
numTypeFilterList | array | 否 | 号码类型过滤 1-400号码;2-800号码;3-手机号码;4-固话;5-95号码;6-96号码;7-其他 | [1,2,3] |
customForbiddenNumFilterStrategy | Integer | 否 | 自定义禁呼号码策略 1-触发自定义禁呼号码后号码组不再拨打;2-触发自定义禁呼号码后该号码不再拨打 | 1 |
customForbiddenNumList | array | 否 | 短自定义禁呼号码列表 | [“13899999999”,”18612312312”] |
smsStrategyV1 | array | 否 | 短信策略数组,短信策略数组,smsAutographId为短信签名ID,smsTemplateId为短信模板ID,smsStrategy为短信触发策略 | [{ “smsAutographId”: 3, “smsTemplateId”: 6,“smsStrategy”: [2]}] |
taskDataCallback | bool | 否 | 默认false 是否开启任务回调 | true |
callBackUrl | String | 否 | 任务级回调地址设置 | http://xxxxxxx.yyy.zzz/aaa |
callFinishTaskEnd | int | 否 | 任务拨号完成后是否进入完成状态 | 0/1 0:拨号完成后任务不结束 1:拨号完成后任务结束 默认值为1 |
*注:任务名称不可重复,格式:支持中英文、数字以及下划线,且不能以下划线开头,不超过40字
[maxRetryTimes]为固定配置,默认为3,如需更改请联系运营。
响应参数
名称 | 类型 | 备注 |
---|---|---|
code | int | http响应码,比如200 |
msg | string | 响应信息,成功为success,失败时为具体原因 |
请求示例
Javascript
1 {
2 "taskId":"731346584781056", // 任务唯一标识,必填
3 "dialStartDate":"2025-09-30", // 任务开始日期,必填
4 "dialEndDate":"2026-10-01", // 任务结束日期,非必填,默认为空,即不限制呼叫终止日期
5 "dialWeeklyInfo": [ // 每周拨打时间段,周一到周日,数组长度=7
6 [
7 ["8:00", "12:00"],
8 ["13:00", "16:00"]
9 ], // 周一
10 [
11 ["9:00", "17:00"]
12 ], // 周二
13 [], // 周三(为空表示当天不拨打)
14 [
15 ["10:00", "15:00"]
16 ], // 周四
17 [
18 ["8:30", "11:30"],
19 ["14:00", "18:00"]
20 ], // 周五
21 [
22 ["9:00", "12:00"]
23 ], // 周六
24 [] // 周日
25 ],
26 "callerNums":[
27 "07567171348"
28 ], // 主叫号码,非必填默认为空,即主叫号码智能调度;
29 "blackListStrategy":1, // 黑名单策略,非必填,默认为空,即不过滤黑名单
30 "isSetCapacity": 0,//通路数类型,默认为空,即空闲通路弹性调节:0-空闲通路弹性调节;1-最低保障通路;2-固定通路;
31 "taskCapacity":1, // 任务通路数,非必填,默认为0,即空闲通路弹性调节
32 "isOpenEmptyNum":true, // 是否开启空号过滤,非必填,默认为「false」不开启
33 "isOpenPhoneDown":true, // 是否开启停机过滤,非必填,默认为「false」不开启
34 "isOpenRepeatFilter": true,//是否开启重复号码过滤,true为开启,false为关闭
35 "numTypeFilterList": [1,2,3,4],//1-400号码;2-800号码;3-手机号码;4-固话;5-95号码;6-96号码;7-其他
36 "smsStrategyV1": [//短信策略集合
37 {
38 "smsAutographId": 3, // 短信签名id
39 "smsTemplateId": 6,//短信模板id
40 "smsStrategy": [//短信触发策略 1-接通后挂机触发;2-未接通后挂机触发
41 1 ]
42 },
43 {
44 "smsAutographId": 3, // 短信签名id
45 "smsTemplateId": 6,//短信模板id
46 "smsStrategy": [//短信触发策略 1-接通后挂机触发;2-未接通后挂机触发
47 2 ]
48 }
49 ]
50}
返回列表
Javascript
1 {
2 "code": 200,
3 "msg": "success",
4 "data": null
5 }