创建任务V2

更新时间：2025-09-04

URL

https://aiob-open.baidu.com/api/v4/console/apitask/create

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

参数名称	类型	是否必须	说明	示例
taskName	string	是	任务名称	"呼叫任务123_测试"
robotId	string	否	外呼机器人唯一标识，以“,”分割当传入多个robotId时为多机器人模式（ABTest模式下仅支持2-3个机器人顺序协同模式下仅支持2～最大重呼次数[maxRetryTimes]个机器人）注意：更新任务仅支持原机器人模式，即单机器人模式下不可传入多个robotId，多机器人模式下不可传入单个robotId	“90132624528086591”
taskRobotCallStrategy	Integer	否	多机器人策略类型，默认为1，仅在多机器人模式下生效 0-ABTest模式； 1-顺序协同模式（该模式下拨打策略不能为0-批量）	1
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
finalStrategy	int	否	终态策略，0-存在接通 1-全部接通 2-存在完成 3-全部完成，默认为0，即存在接通	1
callStrategy	int	否	拨打策略：0-批量 1-逐个/轮流 2-逐个/顺序，默认为1，即逐个/轮流	1
retryTimes	int	否	重试次数，整数，且 N ≤ 3，默认为空，表示不重试	3
retryInterval	int	否	重试间隔时间，单位min，0≤ N ≤720	20
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
callOnePhoneTimeLimit	int	否	是否开启对单被叫的呼叫次数限制	0/1
soundRecord	int	否	是否录音	0/1
priority	int	否	优先级：1: 高优先级，2：中优先级，3：低优先级	3

*注：任务名称不可重复，格式：支持中英文、数字以及下划线，且不能以下划线开头，不超过40字
[maxRetryTimes]为固定配置，默认为3，如需更改请联系运营。

响应参数

名称	类型	备注
code	int	http响应码，比如200
msg	string	响应信息，成功为success，失败时为具体原因
data	obj	成功时为任务ID

data数据

名称	类型	备注
taskId	string	任务唯一标识，如：”731346584781056”

请求示例

                Javascript
                
            

                    {
  "taskName": "api测试创建V2-3", // 任务名称，必填
  "robotId": "f4c7584c-9acf-4b8f-975e-27b879a8e2c7", // 机器人唯一标识，必填
  "dialStartDate": "2025-10-27", // 任务呼叫开始日期，必填
  "dialEndDate": "2026-10-27", // 任务呼叫结束日期，非必填，未填写时表示不限制终止时间
  "dialWeeklyInfo": [            // 每周拨打时间段，周一到周日，数组长度=7
    [
      ["8:00", "12:00"],
      ["13:00", "16:00"]
    ], // 周一
    [
      ["9:00", "17:00"]
    ], // 周二
    [], // 周三（为空表示当天不拨打）
    [
      ["10:00", "15:00"]
    ], // 周四
    [
      ["8:30", "11:30"],
      ["14:00", "18:00"]
    ], // 周五
    [
      ["9:00", "12:00"]
    ], // 周六
    [] // 周日
  ],
  "callerNums": ["07567171348"], // 主叫号码，非必填，不填写时将随机获取可用号码进行外呼
  "blackListStrategy": 1, // 黑名单策略：1-号码组不再拨打；2-号码不再拨打；空值=不过滤
  "finalStrategy": 0,     // 终态策略：0-存在接通即可；1-全部接通
  "callStrategy": 0,      // 拨打策略：0-批量；1-逐个/轮流；2-逐个/顺序
  "retryTimes": 3,        // 重试次数
  "retryInterval": 5,     // 重试间隔（单位分钟），0 < N ≤ 720
  "isSetCapacity": 0,     // 通路数类型：0-空闲通路弹性调节；1-最低保障通路；2-固定通路
  "taskCapacity": 1,      // 通路数大小，0 表示系统根据可用通路实时调节
  "isOpenEmptyNum": false, // 是否开启空号校验，必填
  "isOpenPhoneDown": false, // 是否开启停机校验，必填
  "isOpenRepeatFilter": true, // 是否开启重复号码过滤，true 为开启
  "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]   // 短信触发策略：1-接通后挂机触发；2-未接通后挂机触发
    },
    {
      "smsAutographId": 3,
      "smsTemplateId": 6,
      "smsStrategy": [2]
    }
  ]
}
            

返回结果

                Javascript
                
            

                    {
    "requestId": "f9aba95b45a045b5870b9d254b045d58",
    "time": 1751021023126,
    "code": 200,
    "msg": "OK",
    "data": {
        "taskId": "4750992899997696"
    }
}
            

更新任务V2

批量获取任务拨打明细

百度智能云

客悦·智能外呼平台 AIOB

客悦·智能外呼平台 AIOB

创建任务V2

URL

HTTP Method

请求参数

响应参数

请求示例

返回结果