语音通知

适用场景

• 适用于科技公司的各种语音告警需求。
• 当您的系统检测到服务器出现异常，或者物联网等设备出现异常时，可以通过语音通知功能，以语音电话的形式，给告警处理人拨打电话，电话将播报您预先申请的语音通知模板中的内容，在语音通知模板中，您也可以添加变量，从而在实际使用时替换为符合情况的实际告警内容。

前提条件

1. 您需要首先开通语音服务，具体请参考开通服务。开通后，系统将会自动为您开通语音通知功能，您可以在语音服务控制台的通用设置中查看自己的功能开通情况。
2. 选择告警号码模式，公共模式与专属模式的区别，请参见公共模式/专属模式FAQ和国内语音服务定价。

操作步骤

申请

1. 申请资质：您可以在语音服务控制台上申请资质，具体的操作方式，请参考企业资质申请手册。
2. 申请话术：您可以在语音服务控制台上申请话术，具体的操作方式，请参考新增话术。

• 若您属于公共模式，则请在业务模式选择时，选择公共模式。
• 若您属于专属模式，则请在业务模式选择时，选择专属模式。

3. 申请号码：如果您有单独购买号码的需求，可以在语音服务控制台上申请号码。在申请号码前，请您先通过询单的形式，先确认当前是否存在您意向中的号码资源。说明公共模式不需要申请号码。
4. 申请模板：在模板申请前，请务必阅读语音模板规范。示例如下，仅供参考：

• 您好，服务器节点${content}发生告警，请及时处理。
• 服务器告警，${msg}异常，请及时处理。重要

• 告警时，请不要填写IP或者链接等内容，如果有IP地址的相关诉求，可以考虑将IP中的“.”替换“_”的形式，例如：127_0_0_1。
• 模板的审核时效在2个小时以内。在申请公共模式的模板前，请务必确认已存在申请通过的公共模式的资质和话术信息。

发起呼叫

1. 您可以使用API调用SingleCallByTts，详情请参考文档SingleCallByTts。

说明

在实际编写程序时，推荐使用最新版本的SDK。

1. 您也可以通过API在线调试工具填写如下参数进行测试。API在线调试工具将自动为您生成示例代码： 说明

• 在CalledShowNumber中，如果是公共模式，则不需要填写；如果是专属模式，则需要填入自行购买的号码。
• 在CalledNumber中填写被呼叫的手机号码。
• 在TtsCode中填入申请通过的语音模板ID，格式为TTS_XXXXXXXX。
• 在TtsParam中填写模板中的参数与对应的值信息。

• 如果仅有1个变量，如变量为content，则填写{"content":"abc"}
• 如果有多个变量，如变量为time、content，则填写{"time":"2012-12-12","content":"abc"}

• 在OutId中可以填入自定义的ID，用于自己标识一通呼叫。

2. 调用成功后，系统会返回一个CallId，CallId信息建议由系统进行记录，便于后续的呼叫结果查询或者接收呼叫的回执后进行业务逻辑处理。

查询呼叫记录

通过控制台查询

1. 登录语音服务控制台。
2. 单击业务统计 > 语音记录查询，进入查询页面。您可以根据呼叫类型、呼叫时间、主叫号码、被叫号码进行查询。

通过API查询

• 主动获取呼叫结果：通过 QueryCallDetailByCallId 接口，您就可以主动获取到一通呼叫的呼叫结果。在调用API时，请输入呼叫时返回的CallId值进行查询。 说明CallId为呼叫时返回的CallId，ProdId为语音通知的ProdId，QueryDate查询指定时间点对应的24小时的记录。例如您输入2022.11.21 20:00:01，系统会查询2022.11.21 20:00:01~2022.11.22 20:00:01时间段内指定CallId的呼叫记录。
• 被动接收呼叫结果：在实际生产系统中，如果通过轮询的方式主动查询呼叫结果，其实并不是一个很好的选择，因为这会产生很多不必要的系统请求。因此语音服务还可以通过消息回执的形式，为您主动推送呼叫结果。说明需要注意的是，HTTP和MNS消息之间不冲突，可以同时开启，且两者的消息消费不冲突。但是消息一旦消费成功后，便无法再在其他服务器上消费到该消息，且多次消费失败后，也不会再推送消息。具体可以参考回执消息简介与配置流程。如果您有不同环境的监听需求，有以下方案：

• 方案1：在自身系统消费消息时，设置不同环境的消费方式。如测试环境使用HTTP回执，生产环境使用MNS回执。在消费时，对当前环境的消息进行过滤。
• 方案2（推荐）：开通两个阿里云账号，分别对应测试账号和生产账号。同时保证了测试环境和生产环境的账号隔离。