SpringBoot 实现 阿里云语音通知（SingleCallByTts）

一、准备工作

• 注册阿里云账号并完成企业实名认证。
• 已开通语音服务。
• 申请企业资质并审核通过。
• 若选用专属模式外呼则需要真实号管理；若选用公共模式外呼（推荐使用），由阿里云提供统一的号码池，您无需自行购买号码
• 创建语音通知模板
• 调用API接口前，您可以根据API文档了解接口说明，并查询必选的请求参数。发送请求后报错时，您可以在相应API文档中获取说明

1.开通 阿里云语音服务

登录阿里云官网，选择产品 > 企业服务与云通信 > 语音服务：

单击立即开通（语音服务开通）：

2.申请企业资质

语音服务 开通 之后，申请企业资质：

3.创建语音通知模板，审核通过

4.调用API接口—SingleCallByTts

SingleCallByTts

5.调试API接口—SingleCallByTts

SingleCallByTts

二、代码实现

SingleCallByTts：发送 文本转语音类型的语音通知

1.导入依赖 com.aliyun:aliyun-java-sdk-dyvmsapi:3.0.2

<dependency>
    <groupId>com.aliyungroupId>
    <artifactId>aliyun-java-sdk-coreartifactId>
    <version>3.2.5version>
dependency>

<dependency>
    <groupId>com.aliyungroupId>
    <artifactId>aliyun-java-sdk-dyvmsapiartifactId>
    <version>3.0.2version>
dependency>

2.创建工具类，用于发送语音通知

package com.example.notificationdemo.util;

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.dyvmsapi.model.v20170525.SingleCallByTtsRequest;
import com.aliyuncs.dyvmsapi.model.v20170525.SingleCallByTtsResponse;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.profile.DefaultProfile;
import lombok.extern.slf4j.Slf4j;

/**
 * 阿里云 语音通话 --- 根据文本转语音模板进行语音通话
 * @author qzz
 * @date 2024/6/14
 */
@Slf4j
public class AliyunVoiceClientUtil {

    private  String accessKeyId = "你的阿里云Key";
    private  String accessKeySecret = "你的阿里云Secret";

    /**
     * 语音通话到某个用户
     * @param phoneNumber 被叫号码
     * @param ttsParam 语音模板中的变量参数---请按模版参数有序存入
     * @param ttsCode Tts模板ID
     * @return
     */
    public SingleCallByTtsResponse sendSingleCallToUser(String phoneNumber, String ttsCode, String ttsParam, String outId) throws ClientException {
        //1.初始化acsClient实例 暂时不支持多region
        DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKeyId, accessKeySecret);
        DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", "Dyvmsapi", "dyvmsapi.aliyuncs.com");
        IAcsClient acsClient = new DefaultAcsClient(profile);

        //2.创建请求并设置参数
        SingleCallByTtsRequest request = new SingleCallByTtsRequest();
        //必填-被叫号码
        request.setCalledNumber(phoneNumber);
        //必填-Tts模板ID
        request.setTtsCode(ttsCode);
        //语音模板中的变量参数 示例：{"name":"123456","rainfall":50}
        request.setTtsParam(ttsParam);
        //可选-音量 取值范围 0--100 默认取值 100
        request.setVolume(100);
        //可选-播放次数 默认取3
        request.setPlayTimes(3);
        //可选-语音通话的语速。取值范围为：-500~500
        request.setSpeed(5);
        //可选-外部扩展字段,此ID将在回执消息中带回给调用方
        request.setOutId(outId);

        //3.发送请求并获取响应
        SingleCallByTtsResponse singleCallByTtsResponse = acsClient.getAcsResponse(request);
        if(singleCallByTtsResponse.getCode() != null && singleCallByTtsResponse.getCode().equals("OK")) {
            //请求成功
            log.info("processing sendCVoice success！RequestId = %s , Code = %s , phone = %s",
                    singleCallByTtsResponse.getRequestId(), singleCallByTtsResponse.getCode(), phoneNumber);
        }
        return singleCallByTtsResponse;
    }
}

3.在你的业务逻辑中调用AliyunVoiceClientUtil 发送语音通知。

package com.example.notificationdemo.controller;

import com.aliyuncs.exceptions.ClientException;
import com.example.notificationdemo.util.AliyunVoiceClientUtil;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

/**
 * @author qzz
 * @date 2024/6/14
 */
@RestController
public class TestController {

    @Autowired
    private AliyunVoiceClientUtil aliyunVoiceClientUtil;

    /**
     * 发送语音通话
     * @param phoneNumber 被叫手机号
     * @param ttsCode Tts模板ID
     * @param ttsParam 语音模板中的变量参数---请按模版参数有序存入
     * @param outId 可选-外部扩展字段,此ID将在回执消息中带回给调用方
     * @return
     */
    @PostMapping(value = "/api/{version}/send/single-call/")
    public void sendSingleCall(@RequestParam("phoneNumber") String phoneNumber, @RequestParam("ttsCode") String ttsCode,
                               @RequestParam("ttsParam") String ttsParam,
                               @RequestParam(value = "outId", required = false) String outId) throws ClientException {

        aliyunVoiceClientUtil.sendSingleCallToUser(phoneNumber,ttsCode,ttsParam,outId);

    }
}

注意：
使用 accessKeyId、accessKeySecret 需要 授权 管理语音服务（VMS）的权限

三、完整代码

可点击此处下载