检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
为什么终端上实际显示的号码和调用接口时携带的固话号码不一致? 出现这种情况的可能原因是接口中携带的固话号码(displayNbr、displayCalleeNbr)为“暂停”状态,若固话号码处于“暂停”状态,语音通话平台会从该SP账号下随机选取一个其他可用的固话号码进行外呼。若无
API调用失败如何处理?失败后可以一直不停的调用吗? 当SP调用API接口失败时,根据语音通话平台返回的4xx或5xx消息中“resultdesc”字段初步确定故障类型,例如参数非法、access_token过期、系统错误等。调用接口失败后要及时排查原因,不可以一直不停的调用,容易导致IP被封禁。
调用接口时请求不通,没有任何返回信息,怎么处理? 请求方法、请求URL或请求Headers填写错误,导致请求没有发送到语音通话平台。请参照对应的“API参考”,按照以下步骤排查请求包含的参数是否完整,参数是否填写正确,参数位置是否正确。 请求方法按照接口文档填写对应值,如POST。
语音模板中的变量是如何填充的? 在语音通话控制台添加语音模板,并在调用语音通知API时携带模板ID(templateId)和变量值列表(templateParas),系统会自动将模板内容通过TTS服务转换成语音,向用户播放。 父主题: 放音文件及语音模板配置
语音通知中使用放音文件和语音模板有什么区别? 语音通知服务中,放音文件和语音模板是二选一的关系。 放音文件需要先通过放音文件管理页面上传并审核通过后才能使用。调用语音通知API时携带放音文件名,当前系统只支持Wave格式的音频文件,文件如“notifyvoice.wav”。特点是操作比较简便,播放的语音通知是原音。
挂机原因值、Q850原因值、呼叫拆线点 调用语音通话相关接口会产生接口调用错误码,详见API错误码。 调用接口成功后,如果“statusUrl”和“feeUrl”参数指定了客户接收状态上报的URL和接收话单上报的URL,或在添加应用时指定了呼叫状态接收地址和呼叫话单接收地址,则语
通过后,调用“语音通知API”时,设置对应参数即可使用。如果不设置,则播放系统默认音。 放音 放音场景 设置参数 默认音 提示 语音通知的放音 用户接听平台来电后的语音通知内容。 notifyVoice 无 参数notifyVoice和templateId是二选一的关系。 若使用
当应用要实现语音回呼功能时,可以调用语音回呼场景API。 接口功能 主叫用户通过应用拨打被叫用户,语音通话平台呼叫主叫和被叫,使主叫和被叫能够互相通话。 图1 语音回呼体验流程 语音回呼业务体验描述: 用户A通过应用呼叫用户B,请求上报到SP。 SP调用语音回呼场景API。 语音通话
如何实现同时给多个用户发送语音通知? 调用一次“语音通知API”,被叫号码只能填写一个。若要实现通知多个用户,在最大并发之内可以同时调用多个API,每个API填写不同的被叫号码。 由于运营商管控策略不同,并发数量会存在差异。如果业务量较大,可以联系运营经理进行调整。 父主题: API&代码样例
后,若需要终止呼叫,可调用“终止呼叫场景API”。 接口功能 开发者在开发应用时,通过调用终止呼叫场景API,可以实现终止呼叫的功能。 如果业务已经执行完毕,终止呼叫API会返回失败。 图1 终止呼叫体验流程 终止呼叫体验描述: 用户A、B正在通话,SP调用终止呼叫API。 语音通话平台将用户A挂机。
如何下载录音文件? 通过华为平台推送话单中的recordObjectName和recordDomain调用获取录音文件下载地址API,再通过获取的地址下载录音文件。 注:若华为平台推送的调测信息中有特殊说明,请直接使用FeeInfo(话单通知)中recordFileDownloadUrl的链接下载录音文件。
新手必读 语音通话二次开发业务整体流程如下: 参考申请资源,获取调用语音通话API的关联数据。 参考代码样例调用语音通话API,发起语音回呼/语音通知/语音验证码请求。 根据请求响应消息,判断请求是否成功。 请求成功 => 4 请求失败 => 参考API错误码,修正后重新执行2
若不想接收呼叫状态和话单通知,可以按以下步骤操作: 登录控制台-“应用管理”修改应用,去掉呼叫状态接收地址和话单接收地址的值。如果添加应用时未填地址值,请忽略。 在调用业务接口时不携带参数statusUrl和feeUrl。 父主题: 呼叫状态和话单通知
为什么没有收到呼叫状态通知和话单通知? 调用接口进行呼叫时,没有接收到呼叫状态通知和话单通知,可能的原因如下: 没有订阅通知,即调用接口时没有携带statusUrl和feeUrl,且添加应用时没有填写呼叫状态接收地址和话单接收地址。 提供的URL无效,请确认该URL是可通过外网访问的有效地址。
呼叫状态和话单通知什么时候推送? 应用调用API发起呼叫后,语音通话平台在接收到终端用户操作通知时,如振铃、接听、挂机等,会实时向企业服务器推送呼叫状态通知。 呼叫终止时,即用户未接听、用户挂机或异常挂机,语音通话平台会向企业服务器推送话单通知。 父主题: 呼叫状态和话单通知
语音通话如何获取APP接入地址、APP_Key和APP_Secret? APP接入地址是语音通话平台提供给客户调用语音通话API接口的地址。 APP_Key和APP_Secret是语音通话平台提供给客户调用语音通话通话API接口的鉴权信息。 添加应用后APP_Key和APP_Secret由平台会自
提前准备可用的服务器地址,创建应用时填写,或调用接口时填写。 创建应用,请参考添加应用。 话单通知URL(可选) feeUrl 接收呼叫结束后产生话单的服务器地址。若需订阅话单通知,可提交该资源。 准备的数据与语音回呼场景API请求参数关联关系如下: 表2 语音回呼录音功能需准备的资源
语音通话是否支持固话号码及手机号码?如何申请? app_key、开发者账号、固话号码和CallEnabler业务号码(bindNbr)有什么特定的数量关系吗? 语音通话中来电显示什么号码?是否支持自定义来电显示号码? 语音通话的固话号码是否会根据接听号码所属地区而变动?是否可修改? 语音通话怎么进行号码标记?
)有什么特定的数量关系吗? 开发者账号、app_key、bindNbr的关系: 一个开发者账号最多可添加五个app_key; 一个app_key可以绑定多个bindNbr,一个bindNbr只能绑定一个app_key; 开发者账号、固话号码、app_key的关系: 一个开发者账号
什么是收号? 开发者调用语音通知API通过语音通话平台发起呼叫,给用户播放自定义的语音文件或语音模板内容,用户在放音结束后根据提示输入号码,语音通话平台将获得的用户按键信息反馈给开发者。获取用户按键信息(即用户根据提示输入号码)称为收号。 举例:SP调用语音通知API发送会议通知,员工参加则回复1,不参加则回复2。