更新任务
更新时间：2024-05-27
URL
https://aiob-open.baidu.com/api/v3/console/apitask/update
https://aicc.bce.baidu.com/api/v3/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" |
| dialStartDate | string | 是 | 任务呼叫开始日期 | "2020-10-12" |
| dialEndDate | string | 否 | 任务呼叫结束日期,如：XXXXX，默认为空，表示不限制终止时间 | "2020-10-12" |
| dialStartTime | string | 是 | 呼叫开始时间，时间范围为【09:00，21:00】 | "09:00" |
| dialEndTime | string | 是 | 呼叫结束时间，时间范围为【09:00，21:00】 | "21:00" |
| forbidDialDate | array | 否 | 禁呼日期， 99-节假日；1-周一；2-周二；3-周三；4-周四；5-周五；6-周六；0-周日，默认为空，表示不限制禁呼日期 | [99,6,0] |
| forbidDialTime | array | 否 | 禁呼时间，默认为空，表示不限制禁呼时间 | [{"forbidDialStartTime":"12:00","forbidDialEndTime":"13:00"},{"forbidDialStartTime":"14:00","forbidDialEndTime":"15:00"}] |
| callerNums | array | 否 | 主叫号码，默认为空，表示将随机获取可用号码进行外呼 | ["07567171348","07567171349"] |
| blackListStrategy | int | 否 | 1-触发黑名单后该号码组不再拨打；2-触发黑名单后该号码不再拨打；默认为空，即不过滤黑名单 | 1 |
| 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] |
| 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 |
响应参数
| 名称 | 类型 | 备注 |
|---|---|---|
| code | int | http响应码，比如200 |
| msg | string | 响应信息，成功为success，失败时为具体原因 |
请求示例
{
"taskId":"731346584781056", // 任务唯一标识，必填
"dialStartDate":"2021-05-31", // 任务开始日期，必填
"dialEndDate":"2021-06-01", // 任务结束日期，非必填，默认为空，即不限制呼叫终止日期
"dialStartTime":"10:00", // 任务开始时间，必填
"dialEndTime":"20:00", // 任务结束时间，必填
"forbidDialDate":[0], // 禁呼日期，非必填，99-节假日；1-周一；2-周二；3-周三；4-周四；5-周五；6-周六；0-周日
"forbidDialTime":[
{
"forbidDialStartTime":"11:00",
"forbidDialEndTime":"13:00"
}
], // 禁呼时间段，非必填
"callerNums":[
"07567171348"
], // 主叫号码，非必填默认为空，即主叫号码智能调度；
"blackListStrategy":1, // 黑名单策略，非必填，默认为空，即不过滤黑名单
"taskCapacity":1, // 任务通路数，非必填，默认为0，即空闲通路弹性调节
"isOpenEmptyNum":true, // 是否开启空号过滤，非必填，默认为「false」不开启
"isOpenPhoneDown":true // 是否开启停机过滤，非必填，默认为「false」不开启
"isOpenRepeatFilter": true,//是否开启重复号码过滤,true为开启，false为关闭
"numTypeFilterList": [1,2,3,4],//1-400号码；2-800号码；3-手机号码；4-固话；5-95号码；6-96号码；7-其他
"smsStrategyV1":
[
{
"smsAutographId": 3, // 短信签名id
"smsTemplateId": 6,//短信模板id
"smsStrategy": [1]
},
{
"smsAutographId": 3, // 短信签名id
"smsTemplateId": 6,//短信模板id
"smsStrategy": [ 2 ]
}
],
"taskDataCallback":true,
"callBackUrl":"http://www.url.com/path",
"callFinishTaskEnd":0
}返回列表
{
"code": 200,
"msg": "success",
"data": null
}