# 申请资源 #### 语音回呼 表1语音回呼需准备的资源 | 资源项 | 对应接口参数 | 用途 | 获取方式 | |:---|:---|:---|:---| | APP_Key | X-AKSK | X-AKSK鉴权所需参数。 | 登录管理控制台，从"[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)"页面获取。 创建应用，请参考[添加应用](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0009.html)。 | | APP_Secret | X-AKSK | X-AKSK鉴权所需参数。 | 登录管理控制台，从"[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)"页面获取。 创建应用，请参考[添加应用](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0009.html)。 | | APP接入地址 | - | API调用的基地址。 | 登录管理控制台，从"[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)"页面获取。 创建应用，请参考[添加应用](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0009.html)。 | | 访问URI | - | 语音回呼场景API的接口访问URI。 | 从[语音回呼场景API](https://support.huaweicloud.com/api-VoiceCall/rtc_05_0006.html#section4)获取。 | | 主叫端显示的号码 | displayNbr | 主叫端接收到平台来电时的显示号码。可申请多个。该号码可以与displayCalleeNbr配置为同一个号码，也可以配置为不同号码。 | 从[订购号码](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0006.html)页面申请。 号码下发后在[号码管理](https://console.huaweicloud.com/voicecall/#/numberManagement)页面获取。 | | 被叫端显示的号码 | displayCalleeNbr | 被叫端接收到平台来电时的显示号码。该号码可以与displayNbr配置为同一个号码，也可以配置为不同号码。 | 从[订购号码](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0006.html)页面申请。 号码下发后在[号码管理](https://console.huaweicloud.com/voicecall/#/numberManagement)页面获取。 | | 放音文件（可选） | lastMinVoice | 若设置了最大通话时长，平台会于最后一分钟时进行放音提示。 - 若需使用个性化放音，可提交该资源。 - 若不提交，使用默认放音"本次通话时长还剩1分钟"。 | 登录管理控制台，从"[放音文件管理](https://console.huaweicloud.com/voicecall/#/soundManagement)"页面获取。 上传放音文件，请参考[添加放音文件](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0007.html)。 具体制作方法参见[制作放音文件](https://support.huaweicloud.com/devg-VoiceCall/rtc_04_0006.html#ZH-CN_TOPIC_0244081274__s1af5c4928587486285d06079ca3645d0)。 | | 放音文件（可选） | waitVoice | 主叫接听平台来电后的等待音。 - 若需使用个性化放音，可提交该资源。 - 若不提交，使用默认回铃音，例如："嘟...嘟..."。 | 登录管理控制台，从"[放音文件管理](https://console.huaweicloud.com/voicecall/#/soundManagement)"页面获取。 上传放音文件，请参考[添加放音文件](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0007.html)。 具体制作方法参见[制作放音文件](https://support.huaweicloud.com/devg-VoiceCall/rtc_04_0006.html#ZH-CN_TOPIC_0244081274__s1af5c4928587486285d06079ca3645d0)。 | | 呼叫状态通知URL（可选） | statusUrl | 接收呼叫过程中状态信息（振铃、应答、挂机等）的服务器地址。若需订阅呼叫状态通知，可提交该资源。 | 提前准备可用的服务器地址，创建应用时填写，或调用接口时填写。 创建应用，请参考[添加应用](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0009.html)。 | | 话单通知URL（可选） | feeUrl | 接收呼叫结束后产生话单的服务器地址。若需订阅话单通知，可提交该资源。 | 提前准备可用的服务器地址，创建应用时填写，或调用接口时填写。 创建应用，请参考[添加应用](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0009.html)。 | 准备的数据与语音回呼场景API请求参数关联关系如下： ![](https://support.huaweicloud.com/devg-VoiceCall/figure/zh-cn_image_0273752359.png) 表2语音回呼录音功能需准备的资源 | 资源项 | 对应接口参数 | 用途 | 获取方式 | |:---|:---|:---|:---| | 放音文件（可选） | recordHintTone | 平台会于录音前放音，提示通话用户。 - 若需使用个性化放音，可提交该资源。 - 若不提交，使用默认放音。 | 登录管理控制台，从"[放音文件管理](https://console.huaweicloud.com/voicecall/#/soundManagement)"页面获取。 上传放音文件，请参考[添加放音文件](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0007.html)。 具体制作方法参见[制作放音文件](https://support.huaweicloud.com/devg-VoiceCall/rtc_04_0006.html#ZH-CN_TOPIC_0244081274__s1af5c4928587486285d06079ca3645d0)。 | | **获取录音文件** |||| | 录音文件名 | fileName | 下载录音文件时使用。 | 通过"话单通知API"的recordObjectName参数获取。 | | 录音文件存储的服务器域名 | recordDomain | 下载录音文件时使用。 | 通过"话单通知API"的recordDomain参数获取。 | ![](https://support.huaweicloud.com/devg-VoiceCall/public_sys-resources/note_3.0-zh-cn.png) - 使用录音功能，需在[添加应用](https://console.huaweicloud.com/voicecall/#/commercial/application)时开通。 - 使用录音功能必须订阅话单通知。不订阅话单通知，则无法获取下载录音文件的关键参数。 #### 语音通知 表3语音通知需准备的资源 | 资源项 | 对应接口参数 | 用途 | 获取方式 | |:---|:---|:---|:---| | APP_Key | X-AKSK | X-AKSK鉴权所需参数。 | 登录管理控制台，从"[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)"页面获取。 创建应用，请参考[添加应用](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0009.html)。 | | APP_Secret | X-AKSK | X-AKSK鉴权所需参数。 | 登录管理控制台，从"[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)"页面获取。 创建应用，请参考[添加应用](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0009.html)。 | | APP接入地址 | - | API调用的基地址。 | 登录管理控制台，从"[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)"页面获取。 创建应用，请参考[添加应用](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0009.html)。 | | 访问URI | - | 语音通知API的接口访问URI。 | 从[语音通知API](https://support.huaweicloud.com/api-VoiceCall/rtc_05_0013.html#section4)获取。 | | 被叫用户端显示的号码 | displayNbr | 用户接收到平台来电时的显示号码。可申请多个。 | 从[订购号码](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0006.html)页面申请。 号码下发后在[号码管理](https://console.huaweicloud.com/voicecall/#/numberManagement)页面获取。 | | 放音文件 | notifyVoice | 音频文件，用户接听平台来电后的语音通知内容。 | 登录管理控制台，从"[放音文件管理](https://console.huaweicloud.com/voicecall/#/soundManagement)"页面获取。 上传放音文件，请参考[添加放音文件](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0007.html)。 具体制作方法参见[制作放音文件](https://support.huaweicloud.com/devg-VoiceCall/rtc_04_0006.html#ZH-CN_TOPIC_0244081274__s1af5c4928587486285d06079ca3645d0)。 | | 语音通知模板ID（可选） | templateId | - 仅接口版本为v2.0时需申请。 - 语音通知模板唯一标识。 - 语音通知模板为文本格式，平台将其转化为用户接听来电后的语音通知。可申请多个语音通知模板。 | 登录管理控制台，从"[语音模板管理](https://console.huaweicloud.com/voicecall/#/modelManagement)"页面获取。 添加语音通知模板，请参考[添加语音模板](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0008.html)。 | | 呼叫状态通知URL（可选） | statusUrl | 接收呼叫过程中状态信息（振铃、应答、挂机等）的服务器地址。若需订阅呼叫状态通知，可提交该资源。 | 提前准备可用的服务器地址，创建应用时填写，或调用接口时填写。 创建应用，请参考[添加应用](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0009.html)。 | | 话单通知URL（可选） | feeUrl | 接收呼叫结束后产生话单的服务器地址。若需订阅话单通知，可提交该资源。 | 提前准备可用的服务器地址，创建应用时填写，或调用接口时填写。 创建应用，请参考[添加应用](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0009.html)。 | 准备的数据与语音通知API请求参数关联关系如下： ![](https://support.huaweicloud.com/devg-VoiceCall/figure/zh-cn_image_0273752681.png "点击放大") #### 语音验证码 表4语音验证码需准备的资源 | 资源项 | 对应接口参数 | 用途 | 获取方式 | |:---|:---|:---|:---| | APP_Key | X-AKSK | X-AKSK鉴权所需参数。 | 登录管理控制台，从"[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)"页面获取。 创建应用，请参考[添加应用](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0009.html)。 | | APP_Secret | X-AKSK | X-AKSK鉴权所需参数。 | 登录管理控制台，从"[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)"页面获取。 创建应用，请参考[添加应用](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0009.html)。 | | APP接入地址 | - | API调用的基地址。 | 登录管理控制台，从"[应用管理](https://console.huaweicloud.com/voicecall/#/appManagement)"页面获取。 创建应用，请参考[添加应用](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0009.html)。 | | 访问URI | - | 语音验证码场景API的接口访问URI。 | 从[语音验证码场景API](https://support.huaweicloud.com/api-VoiceCall/rtc_05_0016.html#section4)获取。 | | 被叫用户端显示的号码 | displayNbr | 用户接收到平台来电时的显示号码。可申请多个。 | 从[订购号码](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0006.html)页面申请。 号码下发后在[号码管理](https://console.huaweicloud.com/voicecall/#/numberManagement)页面获取。 | | 放音文件 | preTone | 播放语音验证码之前播放的放音文件。 | 登录管理控制台，从"[放音文件管理](https://console.huaweicloud.com/voicecall/#/soundManagement)"页面获取。 上传放音文件，请参考[添加放音文件](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0007.html)。 具体制作方法参见[制作放音文件](https://support.huaweicloud.com/devg-VoiceCall/rtc_04_0006.html#ZH-CN_TOPIC_0244081274__s1af5c4928587486285d06079ca3645d0)。 | | 放音文件（可选） | posTone | 播放语音验证码之后播放的放音文件。 - 若使用个性化放音，可提交该资源。 - 若不申请，平台将在语音验证码播放完毕后结束通话。 | 登录管理控制台，从"[放音文件管理](https://console.huaweicloud.com/voicecall/#/soundManagement)"页面获取。 上传放音文件，请参考[添加放音文件](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0007.html)。 具体制作方法参见[制作放音文件](https://support.huaweicloud.com/devg-VoiceCall/rtc_04_0006.html#ZH-CN_TOPIC_0244081274__s1af5c4928587486285d06079ca3645d0)。 | | 呼叫状态通知URL（可选） | statusUrl | 接收呼叫过程中状态信息（振铃、应答、挂机等）的服务器地址。若需订阅呼叫状态通知，可提交该资源。 | 提前准备可用的服务器地址，创建应用时填写，或调用接口时填写。 创建应用，请参考[添加应用](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0009.html)。 | | 话单通知URL（可选） | feeUrl | 接收呼叫结束后产生话单的服务器地址。若需订阅话单通知，可提交该资源。 | 提前准备可用的服务器地址，创建应用时填写，或调用接口时填写。 创建应用，请参考[添加应用](https://support.huaweicloud.com/usermanual-VoiceCall/rtc_02_0009.html)。 | 准备的数据与语音验证码API请求参数关联关系如下： ![](https://support.huaweicloud.com/devg-VoiceCall/figure/zh-cn_image_0273754063.png "点击放大")