调用CreateRobotTask发起智能语音机器人外呼任务-语音服务-阿里云-语音服务(VS)-阿里云帮助中心

发起智能语音机器人外呼任务。

接口说明

智能语音机器人功能升级，老功能将于 2023.12.31 停止服务，新功能请登录智能联络中心控制台，在智能外呼机器人页面开通使用。老客户（语音服务已开通该功能的客户）目前可继续使用该功能，为避免给您带来业务损失，请在 2023.12.31 前完成业务迁移。
本接口用于直接使用控制台预设的机器人话术发起机器人外呼任务。在智能语音交互通话中，支持使用控制台预设的机器人话术，或在每轮通话中通过回调接口返回业务方设置的回应方式。

QPS 限制

单用户调用频率：100 次/秒。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

dyvms:CreateRobotTask

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
TaskName	string	是	任务名称。支持中文和英文，不超过 30 个字符。	任务测试
DialogId	integer	是	指定机器人 ID，即话术 ID。表示选择哪个机器人话术发起呼叫。您可以登录语音服务控制台，选择智能语音机器人>话术管理查看话术 ID。	1000023****
CorpName	string	否	公司名称。需和资质管理页面中的企业名称完全一致。	阿里巴巴通信技术（北京）有限公司
Caller	string	是	外呼主叫号码。必须是已购买的号码，多个号码使用半角逗号（,）隔开。您可以登录语音服务控制台，在语音号码>真实号管理页面查看已购买的号码。	0571****5678
NumberStatusIdent	boolean	是	是否启用号码状态（早媒体）识别标识。取值： false（默认值）：不启用。 true：启用。说明设为 true 会记录通话未接听的原因。	true
RetryType	integer	是	是否自动重拨。取值： 1：重拨。 0：不重拨。	1
RecallStateCodes	string	否	需要重拨的通话状态。多个状态使用半角逗号（,）分隔。取值： 200010：关机。 200011：停机。 200002：占线。 200012：呼损。 200005：无法接通。 200003：无应答。	200010,200011
RecallTimes	integer	否	重拨次数。	1
RecallInterval	integer	否	重拨间隔。单位：分钟，必须大于 1。说明最大间隔为 30 分钟。	5
IsSelfLine	boolean	否	是否调用自有线路。取值： false（默认值）：不调用。 true：调用。说明设为 true 不会对主叫号码做校验。	false

返回参数

名称	类型	描述	示例值
	object	返回数据。
Code	string	请求状态码。返回 OK 代表请求成功。其他状态码，请参见 API 错误码。	OK
Message	string	状态码的描述。	OK
Data	string	机器人呼叫任务的唯一任务 ID。任务 ID 可以通过 QueryRobotTaskDetail 接口查询任务详情。	400111****
RequestId	string	请求 ID。	D9CB3933-9FE3-4870-BA8E-2BEE91B69D23

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "Message": "OK",
  "Data": "400111****",
  "RequestId": "D9CB3933-9FE3-4870-BA8E-2BEE91B69D23"
}

错误码

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

变更历史

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