1、接口描述

功能说明： 通过此接口在AICC新增任务 ,AI外呼是围绕着任务进行的，用户将话术（AI的对话逻辑），线路（AI外呼的外显号码），并发（AI外呼同时进行的个数）外呼时段等必要属性通过新建任务的动作赋予任务后可以通过开启，暂停，修改任务等方式控制AI外呼的过程。1分钟内最多创建30个任务 请求地址： https://open-api.soboten.com/apiOpen/v1/job/create 请求方法： POST

2、请求头

请求头参数获取详见权限认证

参数名	类型	是否必填	描述
appkey	String	是	ISV账号信息里获取
timestamp	Long	是	生成验签字段时使用的时间戳
signature	String	是	验签字段，获取方法详见权限认证

3、输入参数

任务基础属性相关配置

参数名	类型	是否必填	描述	示例
robotCallJob	Object	是	该组参数负责确定任务的基本属性
+name	String	是	任务名称（单个账户下任务名称需要保持唯一性）	"创建任务测试"
+dialogFlowId	Long	是	话术id，可以通过界面查询或者话术接口获取，[话术列表查询接口](../../04.AI引擎接口/01.行业语音 Agents接口/01.获取行业语音 Agents列表接口.md)	1444
+mode	String	是	任务启动方式，共有两种方式，MANUAL为手动启动，需要调用启动任务接口或者在界面上手动启动任务，AUTO为自动启动，需要在建立任务时设定任务开始时间（startTime）以自动启动任务	"AUTO"
+startTime	String	否	任务自动启动日期，该字段仅在任务启动方式（mode）为自动启动（AUTO）时必传，其他时候非必传且无效	“2021-12-22 00：00：00”
+dailyStartTime	String	是	可拨打开始时间，默认不可以早于9点，可以联系商务同学调整	“09:00”
+dailyEndTime	String	是	可拨打结束时间，默认不可以晚于20点，可以联系商务同学调整	“20:00”
+phoneType	String	是	任务使用的线路类型，常规客户仅支持“LANDLINE”（即线路），如果客户有对接通讯网关可选择”MOBILE“（网关卡线），如果客户需要使用外呼策略组请选择“CALL_POLICY_GROUP"类型，并阅读外呼策略组模块相关说明	“LANDLINE”
+robotCount	Integer	是	任务使用的AI并发数，可使用的并发数请咨询业务同学或某某对应的服务同学	5

线路属性选择相关配置

参数名	类型	是否必填	描述	示例
jobPhoneNumberIdList	List	是	线路id，当线路类型（phoneType）为线路（LANDLINE）时，可通过请联系智齿商务人员或售后人员获取，一般同一账户仅有一条线路，遇到多条线路时请联系某某服务同学获取支持，务必不要随机选择。	[56731]
concurrencyQuota	Integer	是	线路并发数，默认与任务使用的AI并发数(robotCount)相同	5

外呼时段补充配置（设定较为复杂的外呼时间规则时可使用以下参数，注意以下参数仍配置在robotCallJob参数组中（实际可外呼时段取所有限制条件限制的最小时段）

参数名	类型	是否必填	描述	示例
robotCallJob	Object	是	该组参数负责确定任务的基本属性
+endTime	String	否	外呼结束时间，该时间点后任务会被系统挂起停止外呼（设定仅到日，当日23：59停止外呼）	"2022-02-07 10:00:00"
+inactiveTimeList	List	否	不可拨打时间段，每日该时间段内任务会被挂起，最多可以设置三个不可拨打时间段	[{"startTime":"12:00", "endTime":"13:00"},{"startTime":"14:00", "endTime":"15:00"},{"startTime":"16:00", "endTime":"17:00"}]
+inactiveDateList	List	否	不可拨打日期，该日期段内任务会被挂起，最多可以设置三个不可拨打日期段	[{"startDate":"2022-02-05","endDate":"2022-02-07"},{"startDate":"2022-02-08","endDate":"2022-02-09"},{"startDate":"2022-02-10","endDate":"2022-02-11"}]
+daysOfWeek	List	否	周可拨打时段，时段外的时间，任务会被挂起，星期几不传，星期几就是时段外	["MONDAY","TUESDAY"]

任务挂机短信模块,外呼后给客户发送短信的相关配置可以使用以下参数,注意以下参数仍配置在robotCallJob参数组中

参数名	类型	是否必填	描述	示例
robotCallJob	Object	是	该组参数负责确定任务的基本属性

4、输出参数

参数名	类型	描述	示例
code	Integer	响应码	200
data	Object
+robotCallJobId	Long	刚刚创建的任务ID	578253
requestId	String	请求Id	pb8Aeiyh
resultMsg	String	响应说明	创建成功
host	String	业务主机名	prod-web-7
errorStackTrace	String	异常堆栈	null

5、示例

输入示例：

{
  "robotCallJob": {
    "name":"新建任务测试4",
    "dialogFlowId":1444,
    "mode":"AUTO",
    "startTime":"2022-02-08 10:00:00",
    "dailyStartTime":"09:00",
    "dailyEndTime":"20:00",
    "phoneType":"LANDLINE",
    "robotCount":5,
    "endTime":"2022-02-07 10:00:00",
    "inactiveTimeList":[{"startTime":"12:00", "endTime":"13:00"},{"startTime":"14:00", "endTime":"15:00"},{"startTime":"16:00", "endTime":"17:00"}],
    "inactiveDateList":[{"startDate":"2022-02-05","endDate":"2022-02-07"},{"startDate":"2022-02-08","endDate":"2022-02-09"},{"startDate":"2022-02-10","endDate":"2022-02-11"}],
    "daysOfWeek":["MONDAY","TUESDAY"],
    "smsTemplateId": 9755,
    "smsAlertLevelCode": [0,1],
    "smsPushType": "DISTINCT_PUSH",
    "smsPushAnswered": true,
    "redialSettingList": [{
    "redialCondition":["CALL_LOSS","NO_ANSWER"],
    "redialInterval":30,
    "redialTimes":2,
    "connectRedialCondition":[0,1],
     }],
    "redialType":"FIRST_CALL",
    "csStaffGroupId":2113,
    "isPrior":"true",
    "earlyWarningAlertUsers":[1875],
    "description":"测试备注",
    "customerWhiteGroupIds":[20393],
     "wechatPushConditionList":[{
        "intentLevelCodes":[0,1],
        "durationThreshold":30,
        "userIds":[124809],
        "wechatSendMethod":"SENDTOONE",
        "transferCustomer":"true"
     }],
     "flashMessageTemplateId":1024,
     "reSendSmsTemplateIds":[9755],
     "enableReSendSms":true,
     "botSmsTemplateId":1023
  },
  "jobPhoneNumberIdList":[56731],
  "concurrencyQuota":5
}

输出示例：

{
    "code": 200,
    "data": {
        "robotCallJobId": 578253
    },
    "requestId": "pb8Aeiyh",
    "resultMsg": "创建成功",
    "host": "prod-web-7",
    "errorStackTrace": null
}