本文为您介绍如何调用ClickToDial接口发起语音双呼。
功能介绍
语音双呼是指通过语音服务分配的号码分别向主叫、被叫发起呼叫,双方接通后建立起正常通话,通话双方显示的号码均为语音服务平台号码。常用于企业办公电话等,例如钉钉办公电话。通过调用ClickToDial接口可隐藏通话双方真实号码,同时平台可留存双方通话记录。
实现方法
在调用API接口发起语音双呼前,您需要完成以下操作:
购买语音号码。具体操作,请参见真实号管理。
创建文本转语音模板或上传语音文件。具体操作,请参见创建文本转语音模板或通过控制台上传语音文件。
获取AccessKey信息。具体操作,请参见创建AccessKey。
完成本地SDK环境搭建,更多详情,请参见Java SDK。
接口详情,请参见发起语音双呼。
说明
调用接口前,需配置环境变量,通过环境变量读取访问凭证。AccessKey ID和AccessKey Secret的环境变量名:VMS_AK_ENV 、VMS_SK_ENV。配置详情请参见配置访问凭证。
import com.alibaba.fastjson.JSON;
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 ClickToDial {
public static void main(String[] args) {
// 阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维。
// 强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里,否则可能导致AccessKey泄露,威胁您账号下所有资源的安全。
// 本示例以将AccessKey ID和AccessKey Secret保存在环境变量为例说明。您也可以根据业务需要,保存到配置文件里。
DefaultProfile profile = DefaultProfile.getProfile(
"cn-hangzhou",
System.getenv("VMS_AK_ENV"),
System.getenv("VMS_SK_ENV")
);
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("ClickToDial");
request.putQueryParameter("CallerShowNumber", "123****");
request.putQueryParameter("CallerNumber", "1575****");
request.putQueryParameter("CalledShowNumber", "12****");
request.putQueryParameter("CalledNumber", "1380000****");
try {
CommonResponse response = client.getCommonResponse(request);
System.out.println(JSON.toJSONString(response.getData()));
} catch (ServerException e) {
e.printStackTrace();
} catch (ClientException e) {
e.printStackTrace();
}
}
}
正常返回结果如下所示:
{
"Message": "OK",
"RequestId": "762104B0-D58A-4D04-8486-7C5171D0D756",
"Code": "OK",
"CallId": "118720797955^10551795xx"
}
调用SDK返回错误码,详情请参见错误码列表。
反馈
- 本页导读 (1)
文档反馈