本章节为您介绍调用接口SmartCall发起智能语音交互通话的功能介绍和实现方法。
功能介绍
在智能语音交互通话中,支持使用控制台预设的机器人话术,或在每轮通话中通过回调接口返回业务方设置的回应方式。接口SmartCall需要和智能语音交互呼出回调HTTP接口联合使用,语音平台发起呼叫后,会把转换后的语音文本回传给业务方,业务方把下一步的执行动作返回给语音平台。
实现方法
调用API实现智能外呼功能之前,您需要完成以下操作:
购买语音号码并审核通过语音模板或语音文件,具体操作请参见新手指引。
获取AccessKey信息,详情请参见获取AccessKey。
完成本地SDK环境搭建,详情请参见Pyhton SDK。
已在服务开通页面开通智能外呼ASR,并在订阅回执消息页面开启智能外呼ASR实时交互。详情请参见回调接口说明和智能外呼回调HTTP接口。
示例
接口调用详情,请参见发起智能语音交互通话。
说明
调用接口前,需配置环境变量,通过环境变量读取访问凭证。AccessKey ID和AccessKey Secret的环境变量名:VMS_AK_ENV 、VMS_SK_ENV。配置详情请参见配置访问凭证。
from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.acs_exception.exceptions import ClientException
from aliyunsdkcore.acs_exception.exceptions import ServerException
from aliyunsdkdyvmsapi.request.v20170525.SmartCallRequest import SmartCallRequest
import os
# 阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维。
# 强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里,否则可能导致AccessKey泄露,威胁您账号下所有资源的安全。
# 本示例以将AccessKey ID和AccessKey Secret保存在环境变量为例说明。您也可以根据业务需要,保存到配置文件里。
client = AcsClient(os.getenv("VMS_AK_ENV"), os.getenv("VMS_SK_ENV"), 'cn-hangzhou')
request = SmartCallRequest()
request.set_accept_format('json')
request.set_CalledShowNumber("0633676xx")
request.set_CalledNumber("10xx")
request.set_VoiceCode("3355eedd-3706-4f75-bff9-e645e88e1730.wav")
request.set_PauseTime(800)
request.set_MuteTime(10000)
response = client.do_action_with_exception(request)
print(response)
正常返回结果如下所示:
{
"Message":"OK",
"RequestId":"A90E4451-FED7-49D2-87C8-00700A8C4D0D",
"Code":"OK",
"CallId":"116012854210^10281427xx"
}
调用SDK返回错误码,详情请参见错误码列表。
反馈
- 本页导读 (1)
文档反馈