语音通话 VOICECALL-申请资源:语音回呼

时间:2024-09-25 15:29:01

语音回呼

表1 语音回呼需准备的资源

资源项

对应接口参数

用途

获取方式

APP_Key

X-AKSK

X-AKSK鉴权所需参数。

登录管理控制台,从“应用管理”页面获取。

创建应用,请参考添加应用

APP_Secret

APP接入地址

-

API调用的基地址。

访问URI

-

语音回呼场景API的接口访问URI。

语音回呼场景API获取。

主叫端显示的号码

displayNbr

主叫端接收到平台来电时的显示号码。可申请多个。该号码可以与displayCalleeNbr配置为同一个号码,也可以配置为不同号码。

订购号码页面申请。

号码下发后在号码管理页面获取。

被叫端显示的号码

displayCalleeNbr

被叫端接收到平台来电时的显示号码。该号码可以与displayNbr配置为同一个号码,也可以配置为不同号码。

放音文件(可选)

lastMinVoice

若设置了最大通话时长,平台会于最后一分钟时进行放音提示。

  • 若需使用个性化放音,可提交该资源。
  • 若不提交,使用默认放音“本次通话时长还剩1分钟”

登录管理控制台,从“放音文件管理”页面获取。

上传放音文件,请参考添加放音文件

具体制作方法参见制作放音文件

waitVoice

主叫接听平台来电后的等待音。

  • 若需使用个性化放音,可提交该资源。
  • 若不提交,使用默认回铃音,例如:“嘟...嘟...”。

呼叫状态通知URL(可选)

statusUrl

接收呼叫过程中状态信息(振铃、应答、挂机等)的服务器地址。若需订阅呼叫状态通知,可提交该资源。

提前准备可用的服务器地址,创建应用时填写,或调用接口时填写。

创建应用,请参考添加应用

话单通知URL(可选)

feeUrl

接收呼叫结束后产生话单的服务器地址。若需订阅话单通知,可提交该资源。

准备的数据与语音回呼场景API请求参数关联关系如下:

表2 语音回呼录音功能需准备的资源

资源项

对应接口参数

用途

获取方式

放音文件(可选)

recordHintTone

平台会于录音前放音,提示通话用户。

  • 若需使用个性化放音,可提交该资源。
  • 若不提交,使用默认放音。

登录管理控制台,从“放音文件管理”页面获取。

上传放音文件,请参考添加放音文件

具体制作方法参见制作放音文件

获取录音文件

录音文件名

fileName

下载录音文件时使用。

通过“话单通知API”的recordObjectName参数获取。

录音文件存储的服务器 域名

recordDomain

通过“话单通知API”的recordDomain参数获取。

  • 使用录音功能,需在添加应用时开通。
  • 使用录音功能必须订阅话单通知。不订阅话单通知,则无法获取下载录音文件的关键参数。
support.huaweicloud.com/devg-VoiceCall/rtc_04_0004.html