语音通知接入文档

产品概述

产品定义：

语音通知是指通过调用语音呼叫的API，从运营商网络向指定号码发起一通呼叫，呼叫被应答后，播放一段指定的音频。

根据音频形式的不同，语音通知的API分为两个：

• 播放的音频为固定内容的音频文件（mp3/wav）时：
• 播放的音频为带有变量的文本模板时：

产品优势：

1. 提升效率：简单、重复的流程性通话任务，用机器发送，节省人工成本；
2. 场景灵活：支持带入变量，动态语音内容，灵活支撑业务场景；
3. 安全有保障：通语音验证码难窃取；
4. 稳定可靠：文本转语音支持大容量高并发;
5. 自助选号：用户可以线上自主选号，线上自助配置开通。

接入指南

1. 阿里云账号及访问密钥准备

使用语音通知首先参考语音通知API的步骤1及步骤2：

2. 购买语音号码

语音号码是用于使用语音通知时，向终端客户发起呼叫的号码，是开发文档中的CalledShowNumber，即被叫话机上显示的号码，请在购买号码页面操作；号码的月租以及通话费用请参考产品价格页面；

3. 上传外呼音频文件模板

由于阿里云对语音通知的业务有审核标准，所以运维小二会对音频文件模板进行审核，请您提前确认您将要上传的音频文件是否符合审核标准，外呼音频文件模板包括固定内容的音频文件（mp3/wav）和带有变量的文本模板，上传步骤有详细说明；

4. 调用API开发

下载SDK包，根据自己的业务场景，选择所需要的语音通知类型进行开发。

• 若播放的音频为固定内容的音频文件（mp3/wav），则调用语音文件外呼接口 ；
• 若播放的音频为带有变量的文本模板，每次调用时根据变量替换值从文本模板转化为音频文件，则调用文本转语音外呼接口；
• 若启用语音通知IVR功能时，则调用交互式语音应答；

5. 呼叫记录

通话结束后，云通信平台会将呼叫记录消息回调给客户服务器，您可以首先订阅回执消息中的呼叫记录消息接收，请参考下图：订阅成功之后，系统会推送具体的呼叫记录消息，如您可以查看某次呼叫的开始时间、结束时间、持续时间，结合运营商回执错误码，判断本次呼叫是否成功，若失败的失败原因；另外如果您调用了语音交互应答的功能，您可以查看本次呼叫的DTMF，确认客户选项。

6. 回执消息说明

语音通话呼叫记录、录音都会涉及回执消息，您可以在控制台订阅需要的消息，消息回执有两种方式，第一种方式为MNS消息队列,第二种为HTTP Callback方式，对实时性要求高的回执消息建议采用HTTP CallBack方式，具体回执消息参数和说明可以参考语音回执消息的网页说明。

7. 账单如何查看

您可以在语音服务管理控制台，查看实时的全量统计、T-1的分类统计、具体某一语音记录查询。同时可以在控制台下载通话详单，具体请在如图的在管理控制台->语音服务统计处查询。

8. 小二打标 (当您需要提升企业资质限购数量时）

由于每个号码都有并发限制（一般单个号码并发小于20），另外按规定，单个企业资质最多可以申请10个号码，但当您的业务发展需要，10个号码无法满足需求时，您可以先在系统提交工单，之后发出发邮件申请：

• 邮箱地址：alivoice@list.alibaba-inc.com
• 邮件标题：阿里云账号实名企业名称-企业资质限购数量调整申请
• 邮件内容需包含如下信息：a. 工单号：XXXXXXXX 已通过企业资质工单号码（可选，建议提供，或者提供该企业资质下已购买语音号码）;b. 企业名称全称:申请调整的实名企业全称（必填）;c. 归属地：如 浙江省杭州市（必填）；d. 运营商：联通/铁通/电信 （必填）；e. 申请调整数量XX个；（必填）表述方式参考：A、XX企业 浙江省杭州市 当前可购买XX个联通号码，需增加XX个；B、XX企业 浙江省杭州市 联通 号码企业资质限购数调整为XX个。

9. 常见FAQ

• 语音通知常见问题
• 运营商回执错误码
• 发票常见问题