调用接口BatchRobotSmartCall发起机器人外呼任务。

在智能语音交互通话中,支持使用控制台预设的机器人话术,或在每轮通话中通过回调接口返回业务方设置的回应方式。

接口BatchRobotSmartCall用于直接使用控制台预设的机器人话术,发起机器人外呼任务。

调用该接口前,请确认:

说明 请确保在使用该接口前,已充分了解语音服务产品的收费方式和价格

调试

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

请求参数

名称 类型 是否必选 示例值 描述
CalledNumber String 13700000000

被叫号码。仅支持中国大陆号码。

支持设置1~1000个被叫号码,号码之间使用英文逗号(,)分隔。

CalledShowNumber String 4001112222

被叫显号,必须是已购买的号码。

支持设置1~100个被叫显号,号码之间使用英文逗号(,)分隔。

您可以在语音服务控制台上查看已购买的号码。

DialogId String 1234567

指定机器人ID,即话术ID。表示选择哪个机器人/话术发起呼叫。

请在话术管理页面中查看话术ID

TaskName String 批量任务测试

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

AccessKeyId String LTAIP00vvvvvvvvv

主账号AccessKey的ID。

Action String BatchRobotSmartCall

系统规定参数。取值:BatchRobotSmartCall

CorpName String 阿里巴巴通信技术(北京)有限公司

公司名称,必须和资质管理页面中的公司名称完全一致。

说明 如果开通了自有线路功能,即isSelfLinetrue时,该参数为可选。反之则必须填写公司名称。
EarlyMediaAsr Boolean true

早媒体语音识别标识。默认为fasle,如果需要启用早媒体语音识别标识,请设置为true。

IsSelfLine Boolean true

是否调用自有线路,默认为false。

ScheduleCall Boolean true

是否定时呼叫。如果设置为true,则必须设置ScheduleTime

ScheduleTime Long 1554110977000

预设的呼叫时间。Unix时间戳格式,单位为毫秒。

说明 当参数ScheduleCall为true时必选。
TtsParam String [{“number”:”13700000000”,”params”:[“小王”,”小李”,”小周”]}]

TTS模板的变量值,格式为JSON。

必须和具体的号码对应、TtsParam和上面的TtsParamHead变量名称一一对应。

TtsParamHead String [“name1”,”name2”,”name3”]

带变量的呼叫任务,格式为JSON。变量名称列表,和下面的ttsParam配合使用

返回数据

名称 类型 示例值 描述
TaskId String 4001112222

机器人呼叫任务的唯一任务ID,可以通过此ID调用接口QueryCallDetailByTaskId查询任务详情。

Message String OK

状态码的描述。

RequestId String D9CB3933-9FE3-4870-BA8E-2BEE91B69D23

请求ID。

Code String OK

请求状态码。

示例

请求示例


http(s)://[Endpoint]/?Action=BatchRobotSmartCall
&CalledNumber=13700000000
&CalledShowNumber=4001112222
&DialogId=1234567
&TaskName=批量任务测试	
&<公共请求参数>

正常返回示例

XML 格式

<BatchRobotSmartCallResponse>
	  <Message>OK</Message>
	  <RequestId>D9CB3933-9FE3-4870-BA8E-2BEE91B69D23</RequestId>
	  <Code>OK</Code>
	  <TaskId>4001112222</TaskId>
</BatchRobotSmartCallResponse>

JSON 格式

{
	"Message":"OK",
	"RequestId":"D9CB3933-9FE3-4870-BA8E-2BEE91B69D23",
	"TaskId":"4001112222",
	"Code":"OK"
}

错误码

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