检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
推送的话单中时间未按正常的时区显示,服务器时间和北京时间相差8小时? 话单里的时间统一用的是UTC时间,加8小时即为北京时间。 父主题: 呼叫状态和话单通知
正常如何处理? 语音通话对部分服务器IP做了限制,用户可通过如下方法检查是否可正常访问华为云服务API接口: 华为云服务API接入地址不允许Ping,可通过以下步骤来判断: 使用telnet ip+port,若telnet可连上则可判断客户侧的网络与华为云服务通信正常。 图1 telnet成功示例
所示。 图2 语音通知能力实现流程 前提条件 业务公司服务器与语音通话平台对接正常。 业务公司服务器成功登录语音通话平台。 业务公司服务器发起语音通知请求,请求语音通话平台向Jane播放业务公司定制的欠费通知。 业务公司服务器调用“语音通知API”实现整个呼叫过程。 语音通话平台呼叫Jane。
号码下发后在号码管理页面获取。 放音文件 preTone 播放语音验证码之前播放的放音文件。 登录管理控制台,从“放音文件管理”页面获取。 上传放音文件,请参考添加放音文件。 具体制作方法参见制作放音文件。 放音文件(可选) posTone 播放语音验证码之后播放的放音文件。 若使用个性化放音,可提交该资源。
语音验证码能力实现流程 前提条件 打车软件服务器与语音通话平台对接正常。 打车软件服务器成功登录语音通话平台。 Jane注册打车软件,输入电话号码后,点击“获取语音验证码”。 打车软件服务器发起语音验证码请求,请求语音通话平台向Jane播放语音验证码。 打车软件服务器调用“语音验证码API”实现整个呼叫过程。
录音功能会涉及用户的通信内容,请确保更换的录音提示音满足当地法律法规的要求。 快递网站服务器成功登录语音通话平台。 Jack登录快递网站服务器。 Jack输入自己的号码使用语音回呼业务联系客服。 语音回呼请求上报至语音通话平台。 快递网站服务器调用“语音回呼场景API”实现整个呼叫过程。 语音通话平台呼叫Jack。
附录3-其他附加性说明 本文档中提供的API接口均采用短连接(短信接口除外,短信接口可支持长连接。),平台服务器作为服务端时会主动拆链,建议SP作为客户端时不要主动拆链,等接收到服务端的FIN, ACK后按照正常四次挥手拆链。 若SP主动拆链,可能造成该链路对应的端口短时间不可用,影响SP发送请求。
应用调用API发起呼叫后,语音通话平台在接收到终端用户操作通知时,如振铃、接听、挂机等,会实时向企业服务器推送呼叫状态通知。 呼叫终止时,即用户未接听、用户挂机或异常挂机,语音通话平台会向企业服务器推送话单通知。 父主题: 呼叫状态和话单通知
提供的URL无效,请确认该URL是可通过外网访问的有效地址。 华为服务器作为客户端向提供的URL推送呼叫状态通知和话单通知时,发送的POST请求中不携带任何认证鉴权信息,若提供的URL所在服务器需要对客户端进行认证,则会出现没有收到呼叫状态通知和话单通知的情况。请不要对华为服务器做认证鉴权。 接口中携带的URL加
获取录音文件下载地址API 典型场景 SP通过“呼叫状态和话单通知API”获取录音文件名后,调用此接口获取录音文件的下载地址。 接口功能 该接口用于SP向语音通话平台获取录音文件的下载地址。 使用说明 前提条件 已通过“应用管理”页面获取APP_Key,APP_Secret和APP接入地址。
荐使用域名。 具体的华为云平台推送的呼叫状态和话单的消息内容可参考每个业务中对应的呼叫状态和话单通知API。 注:语音通话平台推送给客户服务器的数据为字节流。 父主题: 呼叫状态和话单通知
默认值 说明 notifyVoice 否 String(1-128) 无 通知语音的放音文件名。需要先通过放音文件管理页面上传放音文件并通过审核才能使用。 当前系统只支持Wave格式的音频文件,文件如“notifyvoice.wav”。 该参数和templateId是二选一的关系,即两个参数必须携带其中一个。
话单信息。短时间内有多个通话结束时语音通话平台会将话单合并推送,每条消息最多携带50个话单。 请求方向 语音通话平台(客户端) → 客户服务器(服务端) 使用说明 前提条件 SP在开发应用时,若需订阅话单通知,必须要提供话单接收URL(feeUrl),并且确保URL能够正常处理语音通话平台发送的通知信息。
话单信息。短时间内有多个通话结束时语音通话平台会将话单合并推送,每条消息最多携带50个话单。 请求方向 语音通话平台(客户端) → 客户服务器(服务端) 使用说明 前提条件 SP在开发应用时,若需订阅话单通知,必须要提供话单接收URL(feeUrl),并且确保URL能够正常处理语音通话平台发送的通知信息。
loadUrl”参数携带的录音文件下载地址下载录音文件。 recordDomain 否 String(1-256) 存放录音文件的域名。 说明: 参数值为空时,请访问“recordFileDownloadUrl”参数携带的录音文件下载地址下载录音文件。 recordFileDownloadUrl
址。 已通过“号码订购”页面申请固话号码。 已通过放音文件管理页面上传播放语音验证码之前需要播放的放音文件;若播放语音验证码之后也需要放音,该放音文件也需要通过放音文件管理页面上传。 已提前准备好接收状态上报和话单上报的服务器地址。 注意事项 无 使用限制 无。 接口类型 表1 接口类型说明
HTTPS/HTTP 请求参数 SP调用语音通知API,语音通话平台发起呼叫,给用户播放自定义的语音文件或TTS合成语音文件,并可进行收号,获得应答信息并反馈给SP。 注:以下流程以语音通话平台呼叫A,给A播放语音文件并收号为例。流程和接口示例仅供参考,请以实际消息为准。 表2 请求Headers参数说明
语音通话平台通过此接口向客户推送语音通话业务用户呼叫时的状态信息,如呼入、呼出、振铃、应答、挂机等状态的信息。 请求方向 语音通话平台(客户端) → 客户服务器(服务端) 使用说明 前提条件 SP在开发应用时,若需订阅呼叫状态通知,必须要提供呼叫状态接收URL(statusUrl),并且确保URL
语音通话平台通过此接口向客户推送语音通话业务用户呼叫时的状态信息,如呼入、呼出、振铃、应答、挂机等状态的信息。 请求方向 语音通话平台(客户端) → 客户服务器(服务端) 使用说明 前提条件 SP在开发应用时,若需订阅呼叫状态通知,必须要提供呼叫状态接收URL(statusUrl),并且确保URL
接收呼叫状态和话单通知,参数区分大小写吗? 语音通话的呼叫状态通知和话单通知支持重推吗? 语音通话的通话记录如何获取? 推送的话单中时间未按正常的时区显示,服务器时间和北京时间相差8小时? 如果不想接收呼叫状态和话单通知怎么办? 如何查看通话详情?