检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
SP应用调用场景API时,填写statusUrl。 使用限制 语音通话平台推送呼叫状态给开发者应用,仅支持POST方式。 接口类型 表1 接口类型说明 请求方法 POST 访问URI 开发者应用接收呼叫状态URL 通信协议 HTTPS/HTTP 请求参数 SP调用语音通知API,语音通话平台发起呼叫,给用户播放自
本章节响应码数量较多,建议您使用快捷键Ctrl+F在界面进行搜索,找到您需要的错误码处理建议。 404问题处理 若调用接口时返回了404响应,请检查APP接入地址和访问URI(详见申请资源)是否都填写正确,且拼接成了完整的请求URL,如“https://rtccall.myhuaweicloud.cn:4
失败,会重新推送话单,直至客户返回成功响应。平台最多重推6次,每次时间间隔1小时。 单个用户(一路呼叫)的话单通知是根据呼叫状态顺序推送的,一通通话会推送一条话单。但同一个应用下,如果多个用户(多路呼叫)的通话结束时间(callEndTime)相同,话单会合并在一起发送,最多不超过50条。
失败,会重新推送话单,直至客户返回成功响应。平台最多重推6次,每次时间间隔1小时。 单个用户(一路呼叫)的话单通知是根据呼叫状态顺序推送的,一通通话会推送一条话单。但同一个应用下,如果多个用户(多路呼叫)的通话结束时间(callEndTime)相同,话单会合并在一起发送,最多不超过50条。
呼叫状态和话单通知什么时候推送? 应用调用API发起呼叫后,语音通话平台在接收到终端用户操作通知时,如振铃、接听、挂机等,会实时向企业服务器推送呼叫状态通知。 呼叫终止时,即用户未接听、用户挂机或异常挂机,语音通话平台会向企业服务器推送话单通知。 父主题: 呼叫状态和话单通知
语音通知可以设置播放多遍吗,如何设置? 语音通知可以设置播放多遍。在调用语音通知API时通过收号语音提示和以下参数配合使用。 示例 下面以设置当用户根据收号语音提示按“1”时重复播放语音通知为例,说明如何设置语音通知重复播放: 上传包含触发重新放音的收号内容的语音文件(notif
语音通知可以设置播放多遍吗,如何设置? API&代码样例 语音回呼有最大通话时长限制吗? 代码样例(JAVA)有什么使用注意事项? 语音通话如何获取APP接入地址、APP_Key和APP_Secret? 如何实现同时给多个用户发送语音通知? 语音回呼场景API,可以只给主叫设置录音提示音吗?主被叫可以都设置不提示吗?
业务体验描述: SP想要给用户A通知一段或多段语音。 SP向语音通话平台发送播放语音通知业务请求。 语音通话平台呼叫用户A的号码。 用户A接听。 语音通话平台向用户A播放语音。 使用说明 前提条件 已通过“应用管理”页面获取对应的APP_Key,APP_Secret和APP接入地址。 已通过“号码订购”页面申请固话号码。
APP_Secret和APP接入地址。 已通过“呼叫状态和话单通知API”获取了录音文件名。 注意事项 响应返回的录音下载地址有效期为7天。请在七天期限内调用该接口获取下载地址并下载录音。 调用获取录音文件下载地址接口需要把connection设置为不支持重定向,再从Location头域中获取到录音文件的下载地址。
业务公司发现用户Jane使用的某业务已欠费,于是通过语音通知功能向Jane发送欠费通知,请求上报至语音通话平台。语音通话平台呼叫Jane,并在Jane接听后播放业务公司设置的语音内容,通知Jane的欠费金额,并提示根据音频播报信息按对应的数字键可进行业务相关操作。详细体验过程如图1所示。 图1 语音通知业务体验流程
代码样例(JAVA)有什么使用注意事项? 语音通话如何获取APP接入地址、APP_Key和APP_Secret? 如何实现同时给多个用户发送语音通知? 语音回呼场景API,可以只给主叫设置录音提示音吗?主被叫可以都设置不提示吗?
不携带时,参数值默认为0。 lastMinVoice 否 String(1-128) 无 当maxDuration字段设置为非0时此参数有效。 此参数用于设置最后一分钟放音提示音,此值填写SP定制的放音文件名,例如lastmin_voice1.wav,参数取值有以下两种场景:
"false"}, //设置主叫(callerNbr)应答语音回呼后,呼叫被叫(calleeNbr)前,是否向主叫(callerNbr)播放提示音 //{"preVoice", "pre_voice1.wav"}, //设置主叫(callerNbr)应答语音回呼后
请求URL按照接口文档中“接口类型说明”和“请求URL参数说明”构造: 请求URL格式举例,https://IP:Port/访问URI?app_key=key&username=user 从“应用管理”页面获取APP接入地址; 访问URI各接口不同,请参照接口文档; 其余参数各接口不同,请参照接口文档中“请求URL参数说明”构造。
语音回呼场景API,可以只给主叫设置录音提示音吗?主被叫可以都设置不提示吗? 不可以,只能设置为双方均播放提示音,或者双方均不播放提示音。 主被叫不播放录音提示音操作步骤如下: 在控制台放音文件管理中上传一个音频内容为空的放音文件,如下图所示。 在应用管理页面,点击“修改应用”,
上传。 已提前准备好接收状态上报和话单上报的服务器地址。 注意事项 无 使用限制 无。 接口类型 表1 接口类型说明 请求方法 POST 访问URI /rest/httpsessions/callVerify/v1.0 通信协议 HTTPS 请求参数 表2 请求Headers参数说明
附录3-其他附加性说明 本文档中提供的API接口均采用短连接(短信接口除外,短信接口可支持长连接。),平台服务器作为服务端时会主动拆链,建议SP作为客户端时不要主动拆链,等接收到服务端的FIN, ACK后按照正常四次挥手拆链。 若SP主动拆链,可能造成该链路对应的端口短时间不可用,影响SP发送请求。
参数具体说明可参考语音回呼场景API。不同业务接口的feeUrl和statusUrl的参数填写方式相同(feeUrl和statusUrl可设置成同一个),参考其中一个进行配置即可。 注:配置的地址格式为https://IP:Port或域名,推荐使用域名。 具体的华为云平台推送的呼
'times': 3, #播放次数:0~9 # 'statusUrl': '', #设置SP接收状态上报的URL,要求使用BASE64编码 # 'feeUrl': '', #设置SP接收话单上报的URL,要求使用BASE64编码 # 'returnIdlePort':
可使用。 语音验证码 语音验证码支持设置以下提示音,放音文件审核通过后,调用“语音验证码API”时,设置对应参数即可使用。如果不设置,则播放系统默认音。 放音 放音场景 设置参数 默认音 提示 播放语音验证码之前的放音 用户接听后,平台给用户播放语音验证码之前的播放的内容。 preTone