文档

智能外呼

本章节为您介绍调用接口SmartCall发起智能语音交互通话的功能介绍和实现方法。

功能介绍

在智能语音交互通话中,支持使用控制台预设的机器人话术,或在每轮通话中通过回调接口返回业务方设置的回应方式。接口SmartCall需要和智能语音交互呼出回调HTTP接口联合使用,语音平台发起呼叫后,会把转换后的语音文本回传给业务方,业务方把下一步的执行动作返回给语音平台。

实现方法

调用API实现智能外呼功能之前,您需要完成以下操作:

示例

接口调用详情,请参见发起智能语音交互通话

说明

调用接口前,需配置环境变量,通过环境变量读取访问凭证。AccessKey ID和AccessKey Secret的环境变量名:VMS_AK_ENV 、VMS_SK_ENV。配置详情请参见配置访问凭证

import com.aliyuncs.CommonRequest;
import com.aliyuncs.CommonResponse;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.profile.DefaultProfile;

public class SmartCall {

  public static void main(String[] args) {
    // 阿里云账号AccessKey ID拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户
    // 此处以把AccessKey ID和 AccessKey Secret 保存在环境变量为例说明。 您也可以根据业务需要,保存到配置文件里
    // 强烈建议不要把 AccessKey ID和 AccessKey Secret 保存到代码里,会存在密钥泄漏风险
    DefaultProfile profile = DefaultProfile.getProfile(
      "cn-hangzhou",
      System.getenv("VMS_AK_ENV"),
      System.getenv("VMS_SK_ENV")
    );
    /** use STS Token
        DefaultProfile profile = DefaultProfile.getProfile(
        "<your-region-id>",      // The region ID
        System.getenv("VMS_AK_ENV"),   // The AccessKey ID of the RAM account
        System.getenv("VMS_SK_ENV"),   // The AccessKey Secret of the RAM account
        "<your-sts-token>");     // STS Token
        **/
    IAcsClient client = new DefaultAcsClient(profile);

    CommonRequest request = new CommonRequest();
    request.setMethod(MethodType.POST);
    request.setDomain("dyvmsapi.aliyuncs.com");
    request.setVersion("2017-05-25");
    request.setAction("SmartCall");
    request.putQueryParameter("CalledShowNumber", "06336****");
    request.putQueryParameter("CalledNumber", "10xx");
    request.putQueryParameter(
      "VoiceCode",
      "3355eedd-3706-4f75-bff9-e645e88e1730.wav"
    );
    request.putQueryParameter("PauseTime", "800");
    request.putQueryParameter("MuteTime", "10000");
    request.putQueryParameter("ActionCodeBreak", "false");
    try {
      CommonResponse response = client.getCommonResponse(request);
      System.out.println(response.getData());
    } catch (ServerException e) {
      e.printStackTrace();
    } catch (ClientException e) {
      e.printStackTrace();
    }
  }
}

正常返回结果如下所示:

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

调用SDK返回错误码,详情请参见错误码列表

  • 本页导读 (1)
文档反馈