创建任务

1.1  请求地址

POST /api/application/{appid}/aicall/task/save?sig={SigParameter}

1.2  请求参数

属性类型约束描述说明
bot_idinteger必选机器人ID
机器人ID
task_name说明必选任务名称最大32个字符
task_descstring可选任务描述最大64个字符
start_datestring必选任务开始日期时间格式:2020-10-10。开始日期必须在创建任务当日或以后。
end_datestring必选任务结束日期时间格式:2020-10-10。结束日期必须在开始日期当日或以后。
max_concurrentinteger必选任务最大并发数最大不能超过应用并发数
min_concurrentinteger必选任务最小并发数最小为1
isrecordinteger必选是否录音是否录音 0:不录音 1:录音。缺省0。
disnumberstring可选外显号码显号
callerstring必选主叫号码主叫
call_policyarray可选呼叫策略
  1. 每{}表示一条禁呼策略
  2. 当多条禁呼策略发生冲突的时候,优先遵守影响范围最大的策略。
typeint必选呼叫类型0:禁呼
policyarray必选禁呼策略

每条策略最大255个字符,类型为string

默认禁呼策略为:

晨间禁呼(禁呼时段:00:00:00~09:00:00)

夜间禁呼(禁呼时段:21:00:00~23:59:59)

policy_typeint必选业务类型0:表示当日 1:表示周 2:表示日期
policy_namestring必选策略名称同一任务内的策略名称不可重复
policy_datestring必选禁呼时间

policy_type为0时,policy_date的格式为:起始时间,结束时间。时间格式为:09:00:00

policy_type为1时,policy_date需枚举出禁呼日期,例如工作日的格式为:周一,周二,周三,周四,周五,周六,周日

policy_type为2时,policy_date的格式为:起始日期时间,结束日期时间。日期格式为:2020-05-01

1.3  请求示例

  • POST /api/application/2015031400000011/aicall/task?sig=C1F20E7A973 HTTP/1.1
  • Host: 192.168.0.1:8883
  • Accept:application/json;
  • Content-Type: application/json;charset=utf-8;
  • Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmOAwN6MjAxMzAyMDExNTABCE=
  • Rand: 201803090129132330
  •   
  • {
  •     "bot_id": 2000,
  •     "task_name": "测试任务01",
  •     "task_desc": "用于测试创建任务2020-06-01",
  •     "start_date": "2020-10-10",
  •     "end_date": "2020-10-10",
  •     "max_concurrent": 1,
  •     "min_concurrent": 1,
  •     "isrecord": 0,
  •     "disnumber": "0101234567",
  •     "caller": "01012345678",
  •     "call_policy": [{
  •             "type": 0,
  •             "policy":"{\"policy_type\":0,\"policy_name\":\"晚间\",\"policy_date\":\"21:00:00,23:59:59\"}"
  •         },
  •         {
  •             "type": 0,
  •             "policy":"{\"policy_type\":1,\"policy_name\":\"双休\",\"policy_date\":\"周六,周日\"}"
  •         },
  •         {
  •             "type": 0,
  •             "policy":"{\"policy_type\":2,\"policy_name\":\"劳动节\",\"policy_date\":\"2020-05-01,2020-05-04\"}"
  •         }
  •     ]
  • }

1.4 响应包体

属性类型说明

code

string

请求状态码,取值:000000(成功)

msg

string

请求状态码描述,取值:sucess(成功)

data

object

结果集

taskIdstring创建任务的任务ID

1.5 响应示例

  • HTTP/1.1 200 OK
  • Content-Length: 641
  •   
  • {
  •     "code":"000000",
  •     "msg":"success",
  •     "data": {
  •         "taskId":"1234567890"
  •     }
  • }