全部产品
  • 语音通知接入文档

语音通知接入文档

更新时间:2018-06-04 21:57

语音通知接入文档

产品概述

产品定义:

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

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

  • 播放的音频为固定内容的音频文件(mp3/wav)时:语音文件上传呼叫
  • 播放的音频为带有变量的文本模板时:文本文件上传呼叫

产品优势:

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

接入指南

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

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

2. 购买语音号码

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

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

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

4. 调用API开发

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

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