根据被叫显号、被叫号码、智能外呼放音文件发起智能语音交互通话。
接口说明
- 以下字符不可以在智能语音交互 SendCcoSmartCall 回调中出现:
@ = : "" $ { } ^ * ¥
。 - 调用此接口后,返回参数的 Data 为此次通话的唯一回执 ID,可以用于调用 SendCcoSmartCallOperate 接口。
QPS 限制
- 单用户调用频率:不限流。
- API 频率:100 次/秒。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ProdCode | string | 否 | 产品名称。默认取值:aiccs。 | aiccs |
CalledShowNumber | string | 是 | 被叫显号,必须是已购买的号码。 您可以登录联络中心控制台,查看已购买的号码。 | 0571****0000 |
CalledNumber | string | 是 | 被叫号码。仅支持中国内地号码。 | 137****0000 |
VoiceCode | string | 是 | 智能外呼放音文件,支持网络文件和 TTS 方式。其中,支持使用多个文件和 TTS 参数混播,之间用英文逗号(,)分隔。TTS 参数的替换值在 VoiceCodeParam 中指定。
| 2d4c-4e78-8d2a-afbb06cf****.wav,$name$ |
OutId | string | 否 | 预留给调用方使用的 ID,最终会通过在回执消息中将此 ID 带回给调用方。 字符串类型,长度为 1~15 个字节。 | 222356**** |
PlayTimes | integer | 否 | 参数暂不支持使用。 | 1 |
Volume | integer | 否 | 播放用户音频的音量,取值范围为:-4~4,建议设置为 1。 | 1 |
Speed | integer | 否 | 参数暂不支持使用。 | 1 |
AsrModelId | string | 否 | ASR 模型 ID。请在 ASR 模型管理页面查看 ASR 模型 ID。 | bf71664d30d2478fb8cb8c39c6b6**** |
AsrBaseId | string | 否 | SR 基础模型。
说明
调用接口 SendCcoSmartCall 时,需要指定使用的 ASR 模型,建议参数 asrModelId 和 AsrBaseId 二者选填一个。
| customer_service_8k |
AsrAlsAmId | string | 否 | 声学模型 ID。 | 123456 |
AsrVocabularyId | string | 否 | 热词 ID。请在 ASR 热词管理页面查看 ASR 热词 ID。 | 123456 |
RecordFlag | boolean | 否 | 通话过程中是否录音。
| true |
PauseTime | integer | 否 | 停顿时长。用于设置用户停顿多久表示一句话结束。单位为毫秒。取值范围为300~1200,如果指定值不在参数范围中,则默认 PauseTime 为 800。 说明
首次设置有效,后续设置无效。
| 800 |
MuteTime | integer | 否 | 静音时长,用于设置用户多久不说话通话结束。单位为:毫秒,取值范围为1000~20000。
| 10000 |
ActionCodeBreak | boolean | 否 | 开场放音文件是否可打断。默认为 true,即开场放音文件可打断。 | true |
DynamicId | string | 否 | 预留给调用方使用的动态扩展 ID,在回调地址中带回,用于客户的开发标识。 | 123456 |
EarlyMediaAsr | boolean | 否 | 早媒体语音识别标识。设为 true 会记录通话未接听的原因。默认为 false,即关闭状态。 说明
如果需要启用早媒体语音识别标识,请手动设为 true。
| false |
VoiceCodeParam | string | 否 | TTS 参数传递字符串,格式为 JSON。必须与 VoiceCode 的 TTS 参数对应。 | {"name":"喂,你好"} |
SessionTimeout | integer | 否 | 最大通话时长,单位为秒,超时后自动挂断。 | 120 |
ActionCodeTimeBreak | integer | 否 | 基于用户持续说话时长打断,在 ActionCodeBreak 为 true 时生效。单位为毫秒。 | 120 |
TtsConf | boolean | 否 | 是否设置 TTS 声音参数。
| true |
TtsStyle | string | 否 | TTS 变量播放时的声音风格,默认为 xiaoyun,具体风格请参见声音风格列表。 | xiaoyun |
TtsVolume | integer | 否 | TTS 变量播放的音量,取值范围为0~100,默认为 0。 | 10 |
TtsSpeed | integer | 否 | TTS 变量播放时的声音速度,取值范围为:-200~200,默认为 0。 | 100 |
BackgroundFileCode | string | 否 | 用户和机器人对话时播放的背景语音文件 ID。您可以登录智能联络中心控制台,选择智能交互 > 语音文件管理,单击详情,查看对应的语音 ID。 | 2d4c-4e78-8d2a-afbb06cf****.wav |
BackgroundVolume | integer | 否 | 参数暂不支持使用。 | 1 |
BackgroundSpeed | integer | 否 | 参数暂不支持使用。 | 1 |
EnableITN | boolean | 否 | 是否在后处理中执行 ITN。 说明
设置为 true 时,中文数字将转为阿拉伯数字输出,默认为 false。
| true |
返回参数
示例
正常返回示例
JSON
格式
{
"Message": "OK",
"RequestId": "A90E4451-FED7-49D2-87C8-00700A8C4D0D",
"Data": "16012854210^10281427****",
"Code": "OK"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | Permission.NotAuthorized | Insufficient permissions. Please contact the primary account administrator. | 权限不足,请联系主账号管理员 |
400 | Parameter.Error | Parameter error. | 参数错误 |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|