使用CreateTask创建智能联络机器人呼叫任务-智能联络中心-阿里云-智能联络中心(AICCS)-阿里云帮助中心

创建智能联络机器人呼叫任务。

接口说明

您可以调用此接口创建任务，也可以在智能联络中心控制台>智能外呼机器人（标准版）>任务管理>单击创建任务进行创建。
调用此接口后，返回参数的 Data 为机器人呼叫任务的唯一任务 ID。

QPS 限制

单用户调用频率：不限流。
API 频率：500 次/秒。

说明

如果多个用户的总调用超过 API 频率也会触发流控。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

aiccs:CreateTask

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
TaskName	string	是	任务名称。支持中文和英文，0～30 个字符。	测试任务
RobotId	string	是	指定机器人 ID（话术 ID）。表示选择哪个机器人话术发起呼叫。您可在控制台的话术管理页面，获取话术 ID。	12****
Caller	string	是	外呼主叫号码。说明必须是已购买的号码，多个号码用英文逗号（,）隔开。	0571**5678,0571**5679
CallString	string	否	呼叫字符（被叫信息和参数列表）。取值： LIST：`05715678**,05715679` JSON：`{"ParamNames":["name","age"],"CalleeList":[{"Callee":"1810000","Params":["张三","20"]},{"Callee":"1810001**","Params":["李四","21"]}]}`。其中 ParamNames 代表参数名称列表；Params 代表参数值列表。说明参数名称列表和参数值列表顺序需要对应。最多 1000 个被叫号码。	{"ParamNames":["name","age"],"CalleeList":[{"Callee":"1810000**","Params":["张三","20"]},{"Callee":"1810001**","Params":["李四","21"]}]}
CallStringType	string	是	呼叫字符串类型。取值： LIST JSON	JSON
RetryFlag	integer	否	是否自动重拨。取值： 1：重拨。 0：不重拨。	1
RetryCount	integer	否	重拨次数。	2
RetryInterval	integer	否	重拨间隔。单位：分钟，必须大于 1。	2
RetryStatusCode	string	否	需要重拨的通话状态。多个状态使用英文逗号（,）分隔。取值： 200010：关机。 200011：停机。 200002：占线。 200012：呼损。 200005：无法接通。 200003：无应答。	200010,200011
StartNow	boolean	否	是否立即启动。 true：是。 false：否。	是
WorkTimeList	string	是	工作时间列表（精确到分钟）。	10:00-12:00,13:00-14:00
WorkDay	string	是	工作日期。取值： 1：星期一。 2：星期二。 3：星期三。 4：星期四。 5：星期五。 6：星期六。 7：星期天。	1
SeatCount	string	是	并发数量（坐席数量）。	3

返回参数

名称	类型	描述	示例值
	object	返回数据。
RequestId	string	请求 ID。	EE338D98-9BD3-4413-B165
Message	string	状态码描述。	OK
Data	integer	机器人呼叫任务的唯一任务 ID。	12****
Code	string	请求状态码。返回 OK 代表请求成功。	OK
Success	boolean	接口调用是否成功。 true：成功。 false：失败。	true

示例

正常返回示例

JSON格式

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

错误码

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

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

变更历史

更多信息，参考变更详情。