调用SendCcoSmartCall接口发起智能语音交互通话。

说明 以下字符不可以在智能语音交互SendCcoSmartCall回调中出现:@ = : "" $ { } ^ * ¥

调试

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

请求参数

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

系统规定参数。取值:SendCcoSmartCall

ProdCode String aiccs

产品名称。默认取值:aiccs

CalledShowNumber String 0571****0000

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

您可以登录联络中心控制台,查看已购买的号码。

CalledNumber String 137****0000

被叫号码。仅支持中国内地号码。

VoiceCode String 2d4c-4e78-8d2a-afbb06cf****.wav,$name$

智能外呼放音文件,支持网络文件和TTS方式。其中,支持使用多个文件和TTS参数混播,之间用英文逗号(,)分隔。TTS参数的替换值在VoiceCodeParam中指定。

  • 放音文件为网络文件时:参数VoiceCode指定为可被公网访问的语音文件URL,建议您使用采样频率为8000Hz或16000Hz且为wav格式的语音文件。
  • 放音文件为TTS时:参数VoiceCode指定为变量名称如$name$,需要在VoiceCodeParam中设置变量对应的内容。
OutId String 222356****

预留给调用方使用的ID,最终会通过在回执消息中将此ID带回给调用方。

字符串类型,长度为1~15个字节。

PlayTimes Integer 1

参数暂不支持使用。

Volume Integer 1

播放用户音频的音量,取值范围为-4~4,建议设置为1

Speed Integer 1

参数暂不支持使用。

AsrModelId String bf71664d30d2478fb8cb8c39c6b6****

ASR模型ID。请在ASR模型管理页面查看ASR模型ID。

AsrBaseId String customer_service_8k

SR基础模型。

  • customer_service_8k:普通话。
  • dialect_customer_service_8k:重口音。
说明
  • 调用接口SendCcoSmartCall时,需要指定使用的ASR模型,建议参数asrModelIdAsrBaseId二者选填一个。
  • 如果仅设置asrModelId,表示使用指定的ASR模型。
  • 如果仅设置AsrBaseId,表示使用指定的ASR基础模型。
  • 如果二者均未设置,则使用默认的ASR基础模型,即参数AsrBaseId默认为customer_service_8k,表示使用ASR普通话基础模型。
  • 如果二者同时设置,请确认二者是正确对应的。
AsrAlsAmId String 123456

声学模型ID。

AsrVocabularyId String 123456

热词ID。请在ASR热词管理页面查看ASR热词ID。

RecordFlag Boolean true

通话过程中是否录音。

  • true:是。
  • false:否。
PauseTime Integer 800

停顿时长。用于设置用户停顿多久表示一句话结束。单位为毫秒。取值范围为300~1200,如果指定值不在参数范围中,则默认PauseTime为800

说明 首次设置有效,后续设置无效。
MuteTime Integer 10000

静音时长,用于设置用户多久不说话通话结束。单位为:毫秒,取值范围为1000~20000

  • 如果指定值不在参数范围中,则默认MuteTime为10000
  • 通话过程中可动态设置,以最后一次设置为准。
ActionCodeBreak Boolean true

开场放音文件是否可打断。默认为true,即开场放音文件可打断。

DynamicId String 123456

预留给调用方使用的动态扩展ID,在回调地址中带回,用于客户的开发标识。

EarlyMediaAsr Boolean fasle

早媒体语音识别标识。设为true会记录通话未接听的原因。默认为fasle,即关闭状态。

说明 如果需要启用早媒体语音识别标识,请手动设为true
VoiceCodeParam String “{\”name\”:\”喂,你好\”}”

TTS参数传递字符串,格式为JSON。必须与VoiceCode的TTS参数对应。

SessionTimeout Integer 120

最大通话时长,单位为秒,超时后自动挂断。

ActionCodeTimeBreak Integer 120

基于用户持续说话时长打断,在ActionCodeBreak为true时生效。单位为毫秒。

TtsConf Boolean true

是否设置TTS声音参数。

  • 指定为true:需要通过TtsStyle、TtsColume、TtsSpeed三个参数来设置声音风格。
  • 定为false:不需要设置相关参数,即便设置了也不生效。
TtsStyle String xiaoyun

TTS变量播放时的声音风格,默认为xiaoyun,具体风格请参见声音风格列表。

TtsVolume Integer 10

TTS变量播放的音量,取值范围为0~100,默认为0

TtsSpeed Integer 100

TTS变量播放时的声音速度,取值范围为-200~200,默认为0

BackgroundFileCode String 2d4c-4e78-8d2a-afbb06cf****.wav

用户和机器人对话时播放的背景语音文件ID。您可以登录智能联络中心控制台,选择智能交互 > 语音文件管理,单击详情,查看对应的语音ID。

BackgroundVolume Integer 1

参数暂不支持使用。

BackgroundSpeed Integer 1

参数暂不支持使用。

EnableITN Boolean true

是否在后处理中执行ITN。

说明 设置为true时,中文数字将转为阿拉伯数字输出,默认为false

声音风格列表

  • 小云标准女声:xiaoyun
  • 小刚标准男声:xiaogang
  • 若兮温柔女声:ruoxi
  • 小梦标准女声:xiaomeng
  • 小威标准男声:xiaowei
  • 阿美甜美女声:amei
  • 小雪温柔女声:xiaoxue
  • 思琪温柔女声:siqi
  • 思佳标准女声:sijia
  • 思诚标准男声:sicheng
  • 思悦温柔女声:siyue
  • 小美甜美女声:xiaomei
  • 思彤标准童声:sitong
  • 宁儿标准女声:ninger
  • 小北萝莉女声:xiaobei
  • 伊娜浙普女声:yina

返回数据

名称 类型 示例值 描述
Message String OK

状态码的描述。

RequestId String A90E4451-FED7-49D2-87C8-00700A8C4D0D

请求ID。

Data String OK

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

Code String 16012854210^10281427****

此次通话的唯一回执ID。

示例

请求示例

http(s)://aiccs.aliyuncs.com/?Action=SendCcoSmartCall
&ProdCode=aiccs
&CalledShowNumber=0571****0000
&CalledNumber=137****0000
&VoiceCode=2d4c-4e78-8d2a-afbb06cf****.wav,$name$
&OutId=123456
&PlayTimes=800
&Volume=1
&Speed=1
&AsrModelId=bf71664d30d2478fb8cb8c39c6b6****
&AsrBaseId=customer_service_8k
&AsrAlsAmId=123456
&AsrVocabularyId=123456
&RecordFlag=true
&PauseTime=800
&MuteTime=10000
&ActionCodeBreak=true
&DynamicId=123456
&EarlyMediaAsr=false
&VoiceCodeParam=“{\”name\”:\”喂,你好\”}”
&SessionTimeout=120
&ActionCodeTimeBreak=120
&TtsConf=true
&TtsStyle=xiaoyun
&TtsVolume=10
&TtsSpeed=100
&BackgroundFileCode=2d4c-4e78-8d2a-afbb06cf****.wav
&BackgroundVolume=1
&BackgroundSpeed=100
&EnableITN=true
&公共请求参数

正常返回示例

XML格式

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

<SendCcoSmartCallResponse>
    <Message>OK</Message>
    <RequestId>A90E4451-FED7-49D2-87C8-00700A8C4D0D</RequestId>
    <Data>OK</Data>
    <Code>116012854210^10281427****</Code>
</SendCcoSmartCallResponse>

JSON格式

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

{
  "Message" : "OK",
  "RequestId" : "A90E4451-FED7-49D2-87C8-00700A8C4D0D",
  "Data" : "OK",
  "Code" : "116012854210^10281427****"
}

错误码

HttpCode 错误码 错误信息 描述
400 Permission.NotAuthorized Insufficient permissions. Please contact the primary account administrator. 权限不足,请联系主账号管理员
400 Parameter.Error Parameter error. 参数错误

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