检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
信息没执行 99 信息单元不存在 100 无效的信息单元 101 呼叫状态不一致 102 定时器超时 103 参数不存在 110 消息中带有未识别的参数 111 协议错误 127 未指定的交互 父主题： 附录
终止呼叫场景API 典型场景 SP通过请求响应或者呼叫状态和话单通知API获取到sessionid后，若需要终止呼叫，可调用“终止呼叫场景API”。 接口功能 开发者在开发应用时，通过调用终止呼叫场景API，可以实现终止呼叫的功能。 如果业务已经执行完毕，终止呼叫API会返回失败。
SP应用调用场景API时，填写statusUrl。 使用限制 语音通话平台推送呼叫状态给开发者应用，仅支持POST方式。 接口类型 表1 接口类型说明 请求方法 POST 访问URI 开发者应用接收呼叫状态URL 通信协议 HTTPS/HTTP 请求参数 SP调用语音通知API，语音通话
语音回呼场景API 典型场景 当应用要实现语音回呼功能时，可以调用语音回呼场景API。 接口功能 主叫用户通过应用拨打被叫用户，语音通话平台呼叫主叫和被叫，使主叫和被叫能够互相通话。 图1 语音回呼体验流程 语音回呼业务体验描述： 用户A通过应用呼叫用户B，请求上报到SP。 SP调用语音回呼场景API。
获取录音文件下载地址API 典型场景 SP通过“呼叫状态和话单通知API”获取录音文件名后，调用此接口获取录音文件的下载地址。 接口功能 该接口用于SP向语音通话平台获取录音文件的下载地址。 使用说明 前提条件 已通过“应用管理”页面获取APP_Key，APP_Secret和APP接入地址。
语音回呼呼叫状态通知API 接口功能 语音通话平台通过此接口向客户推送语音通话业务用户呼叫时的状态信息，如呼入、呼出、振铃、应答、挂机等状态的信息。 请求方向 语音通话平台（客户端） → 客户服务器（服务端） 使用说明 前提条件 SP在开发应用时，若需订阅呼叫状态通知，必须要提供
语音通知话单通知API 接口功能 用户通话结束后，语音通话平台通过此接口向SP推送通话的话单信息。短时间内有多个通话结束时语音通话平台会将话单合并推送，每条消息最多携带50个话单。 请求方向 语音通话平台（客户端） → 客户服务器（服务端） 使用说明 前提条件 SP在开发应用时，
语音通知API 典型场景 使用语音通知功能时，调用此API，请求语音通话平台给指定用户播放语音通知。 接口功能 语音通知是SP将被叫号码和语音通知文件名（语音文件需要提前通过放音文件管理页面上传）或语音通知文本（通过语音模板管理页面提交）发送给业务平台，由业务平台呼叫被叫，被叫接
语音回呼话单通知API 接口功能 用户通话结束后，语音通话平台通过此接口向SP推送通话的话单信息。短时间内有多个通话结束时语音通话平台会将话单合并推送，每条消息最多携带50个话单。 请求方向 语音通话平台（客户端） → 客户服务器（服务端） 使用说明 前提条件 SP在开发应用时，
在应用管理页面，点击“修改应用”，“是否开通录音”选择“是”，“随机抽检录音提示音”选择提示音：***.wav。 调呼叫接口时带上参数“recordHintTone”，值为“testvoice.wav”。 父主题： API&代码样例
语音通知API使用说明 API列表 API名称 API功能 语音通知API 请求语音通话平台向指定用户播放语音通知。 语音通知呼叫状态通知API 语音通话平台向SP推送接收语音通话业务用户呼叫时的状态信息，如呼入、呼出、振铃、应答、挂机等状态的信息。 语音通知话单通知API 通话结
语音回呼API使用说明 API列表 API名称 API功能 语音回呼场景API 主叫用户通过应用拨打被叫用户，语音通话平台呼叫主叫和被叫，使主叫和被叫能够互相通话。 终止呼叫场景API 实现通话双方终止呼叫。 语音回呼呼叫状态通知API 语音通话平台向SP推送接收语音通话业务用户
语音通知API 语音通知API使用说明 语音通知API 语音通知呼叫状态通知API 语音通知话单通知API
语音回呼API 语音回呼API使用说明 语音回呼场景API 终止呼叫场景API 语音回呼呼叫状态通知API 语音回呼话单通知API 获取录音文件下载地址API
如何判断华为云服务API接口是否正常？如果不正常如何处理？ 语音通话对部分服务器IP做了限制，用户可通过如下方法检查是否可正常访问华为云服务API接口： 华为云服务API接入地址不允许Ping，可通过以下步骤来判断： 使用telnet ip+port，若telnet可连上则可判断客户侧的网络与华为云服务通信正常。
附录 通话挂机原因值说明 附录1-Q850原因值说明 附录2-呼叫拆线点说明 附录3-其他附加性说明
API&代码样例 语音回呼有最大通话时长限制吗？ 代码样例（JAVA）有什么使用注意事项？ 语音通话如何获取APP接入地址、APP_Key和APP_Secret？ 如何实现同时给多个用户发送语音通知？ 语音回呼场景API，可以只给主叫设置录音提示音吗？主被叫可以都设置不提示吗？
为什么没有收到呼叫状态通知和话单通知？ 调用接口进行呼叫时，没有接收到呼叫状态通知和话单通知，可能的原因如下： 没有订阅通知，即调用接口时没有携带statusUrl和feeUrl，且添加应用时没有填写呼叫状态接收地址和话单接收地址。 提供的URL无效，请确认该URL是可通过外网访问的有效地址。
通话挂机原因值说明 通话挂机原因值 原因值描述 0 接通后主动挂机 7001 开发者呼叫频次管控 7002 应用呼叫频次管控 7003 固话号码呼叫频次管控 7004 被叫黑名单呼叫管控 7108 用户状态已冻结 7109 语音端口不足 8000 内部错误 8001 用户未接续成功，可能包含以下场景：
附录3-其他附加性说明 本文档中提供的API接口均采用短连接（短信接口除外，短信接口可支持长连接。），平台服务器作为服务端时会主动拆链，建议SP作为客户端时不要主动拆链，等接收到服务端的FIN, ACK后按照正常四次挥手拆链。 若SP主动拆链，可能造成该链路对应的端口短时间不可用，影响SP发送请求。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
