通过阿里云语音服务API接口发起语音通知,播放的音频为文本转语音模板转换后的音频文件或是提前录制并上传的音频文件。本文为您介绍了国内语音通知的使用流程。

前提条件

使用流程

调用API发起语音通知的流程图如下:2
  1. 购买专属号码(可选)。

    语音通知提供公共模式号码和专属号码两种模式。

    • 公共模式(推荐使用):阿里云提供统一的号码池。公共模式可提供各归属地和各大运营商的号码, 通过调度及重试逻辑来提升触达率,且价格通常低于专属号码。
    • 专属号码模式:企业需自行购买专属号码,调用接口外呼时候需指定外显号码。
  2. 创建语音模版或上传语音文件。具体操作,请参见创建文本转语音模版上传语音文件
    注意 由于公共模式和专属号码的审核标准不同,上传语音文件或提交语音模版时务必确认使用公共模式号码外呼专属号码外呼
  3. 调用API接口发起语音通知。
    • 如果通过文本转语音的方式播放语音内容,则调用SingleCallByTts接口发送语音通知。
    • 如果通过语音文件的方式播放语音内容,则调用SingleCallByVoice接口发送语音通知。
    说明
    • 在使用公共模式发起语音通知时,CalledShowNumber必须为空。
    • 使用专属号码发起语音通知时,CalledShowNumber必须指定已购买的号码。

查询通话记录

  • 您可以调用QueryCallDetailByCallId接口查询指定通话的呼叫详情。
  • 当您使用语音的API接口发送外呼后,可以通过使用MNS的Queue模型来接收语音的回执消息。更多详情,请参见回执消息简介

相关文档

您可以线上调用API进行测试,更多详情,请参见使用OpenAPI Explorer