调用CreateTask创建任务。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateTask

系统规定参数。取值:CreateTask

TaskName String 测试任务

任务名称。支持中文和英文,0~30个字符。

RobotId String 123456

指定机器人ID(话术ID)。表示选择哪个机器人话术发起呼叫。

Caller String 0571****5678,0571****5679

外呼主叫号码。

说明 必须是已购买的号码,多个号码用英文逗号(,)隔开。
CallString String {"ParamNames":["name","age"],"CalleeList":[{"Callee":"181XXXX0000","Params":["张三","20"]},{"Callee":"181XXXX0001","Params":["李四","21"]}]}

呼叫字符(被叫信息和参数列表)。取值:

  • LIST0571****5678,0571****5679
  • JSON{"ParamNames":["name","age"],"CalleeList":[{"Callee":"181XXXX0000","Params":["张三","20"]},{"Callee":"181XXXX0001","Params":["李四","21"]}]}。其中ParamNames代表参数名称列表;Params代表参数值列表。
说明 参数名称列表和参数值列表顺序需要对应。
CallStringType String JSON

呼叫字符串类型。取值:

  • LIST
  • JSON
RetryFlag Integer 1

是否自动重拨。取值:

  • 1:重拨。
  • 0:不重拨。
RetryCount Integer 2

重拨次数。

RetryInterval Integer 2

重拨间隔。单位:分钟,必须大于1。

RetryStatusCode String 200010,200011

需要重拨的通话状态。多个状态使用英文逗号(,)分隔。取值:

  • 200010:关机。
  • 200011:停机。
  • 200002:占线。
  • 200012:呼损。
  • 200005:无法接通。
  • 200003:无应答。
StartNow Boolean

是否立即启动。

WorkTimeList String 10:00-12:00,13:00-14:00

工作时间列表。

WorkDay String 1

工作日期。代表星期几。

SeatCount String 3

并发数量(坐席数量)。

返回数据

名称 类型 示例值 描述
RequestId String EE338D98-9BD3-4413-B165

请求ID。

Data Long 123456

机器人呼叫任务的唯一任务ID。

Code String OK

请求状态码。返回OK代表请求成功。

Message String OK

状态码描述。

Success Boolean true

接口调用是否成功。

示例

请求示例

http(s)://aiccs.aliyuncs.com/?Action=CreateTask
&TaskName=测试任务
&RobotId=123456
&Caller=0571****5678,0571****5679
&CallString={"ParamNames":["name","age"],"CalleeList":[{"Callee":"181XXXX0000","Params":["张三","20"]},{"Callee":"181XXXX0001","Params":["李四","21"]}]}
&CallStringType=JSON
&RetryFlag=1
&RetryCount=2
&RetryInterval=2
&RetryStatusCode=200010,200011
&StartNow=false
&WorkTimeList=10:00-12:00,13:00-14:00
&WorkDay=1
&SeatCount=3
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateTaskResponse>
    <RequestId>EE338D98-9BD3-4413-B165</RequestId>
    <Data>123456</Data>
    <Code>OK</Code>
    <Message>OK</Message>
    <Success>true</Success>
</CreateTaskResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "EE338D98-9BD3-4413-B165",
  "Data" : 123456,
  "Code" : "OK",
  "Message" : "OK",
  "Success" : true
}

错误码

HttpCode 错误码 错误信息 描述
400 PermissionInsufficient Insufficient permissions. Please contact the Alibaba Cloud account administrator. 权限不足,请联系主账号管理员
400 ParameterError The parameter is invalid. 参数错误

访问错误中心查看更多错误码。