检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
语音通话平台不限制通话时长，如需设置通话自动挂机时间，您可在调用绑定接口时设置maxDuration参数实现。 maxDuration参数表示允许单次通话进行的最长时间，单位为分钟，通话时间从接通被叫的时刻开始计算。最大可设置为1440分钟（即24小时），当通话时长达到此配置值，系统主动结束通话。 不携带该参数
API调用失败如何处理？失败后可以一直不停的调用吗？ 当SP调用API接口失败时，根据语音通话平台返回的4xx或5xx消息中“resultdesc”字段初步确定故障类型，例如参数非法、access_token过期、系统错误等。调用接口失败后要及时排查原因，不可以一直不停的调用，容易导致IP被封禁。
代码样例（JAVA）工程中使用到的公共库需要开发者在网上自行下载。 代码样例（JAVA）中只包含该接口的必选参数。可选参数可以参考接口文档按需填写。 调测时请求路径参数path是否需要带sandbox，以华为提供的调测信息为准。 父主题： API&代码样例
语音回呼场景API 典型场景 当应用要实现语音回呼功能时，可以调用语音回呼场景API。 接口功能 主叫用户通过应用拨打被叫用户，语音通话平台呼叫主叫和被叫，使主叫和被叫能够互相通话。 图1 语音回呼体验流程 语音回呼业务体验描述： 用户A通过应用呼叫用户B，请求上报到SP。 SP调用语音回呼场景API。
SP应用调用场景API时，填写statusUrl。 使用限制 语音通话平台推送呼叫状态给开发者应用，仅支持POST方式。 接口类型 表1 接口类型说明 请求方法 POST 访问URI 开发者应用接收呼叫状态URL 通信协议 HTTPS/HTTP 请求参数 SP调用语音通知API，语音通话
语音回呼呼叫状态通知API 接口功能 语音通话平台通过此接口向客户推送语音通话业务用户呼叫时的状态信息，如呼入、呼出、振铃、应答、挂机等状态的信息。 请求方向 语音通话平台（客户端） → 客户服务器（服务端） 使用说明 前提条件 SP在开发应用时，若需订阅呼叫状态通知，必须要提供
语音通知话单通知API 接口功能 用户通话结束后，语音通话平台通过此接口向SP推送通话的话单信息。短时间内有多个通话结束时语音通话平台会将话单合并推送，每条消息最多携带50个话单。 请求方向 语音通话平台（客户端） → 客户服务器（服务端） 使用说明 前提条件 SP在开发应用时，
SP应用调用场景API时，填写statusUrl。 使用限制 语音通话平台推送呼叫状态给开发者应用，仅支持POST方式。 接口类型 表1 接口类型说明 请求方法 POST 访问URI 开发者应用接收呼叫状态URL 通信协议 HTTPS/HTTP 请求参数 SP调用语音验证码API，语音通话平台发起呼叫，给用户播放语音验证码。
语音验证码话单通知API 接口功能 用户通话结束后，语音通话平台通过此接口向SP推送通话的话单信息。短时间内有多个通话结束时语音通话平台会将话单合并推送，每条消息最多携带50个话单。 请求方向 语音通话平台（客户端） → 客户服务器（服务端） 使用说明 前提条件 SP在开发应用时
语音回呼话单通知API 接口功能 用户通话结束后，语音通话平台通过此接口向SP推送通话的话单信息。短时间内有多个通话结束时语音通话平台会将话单合并推送，每条消息最多携带50个话单。 请求方向 语音通话平台（客户端） → 客户服务器（服务端） 使用说明 前提条件 SP在开发应用时，
语音通话服务，给子账号添加IAM权限为何不生效？ 请检查权限策略配置区域是否正确，如配置的是“华北-北京一”区域的“RTC Administrator”权限，请登录并切换到“华北-北京一”验证IAM权限，具体请参考创建用户并授权使用通信云服务。 父主题： 产品咨询类
在调用语音回呼场景API时可通过maxDuration设置允许单次通话进行的最长时间，通话时间从被叫接通的时刻开始计算。 maxDuration取值为0或不携带：系统不主动结束通话，由主被叫双方结束通话。 maxDuration取值为1~1440：当通话时长达到此配置值，系统主动结束通话。
挂机原因值、Q850原因值、呼叫拆线点 调用语音通话相关接口会产生接口调用错误码，详见API错误码。 调用接口成功后，如果“statusUrl”和“feeUrl”参数指定了客户接收状态上报的URL和接收话单上报的URL，或在添加应用时指定了呼叫状态接收地址和呼叫话单接收地址，则语
1010009 No more APIs can be invoked. 刷新授权API：app_secret无效。 其他API：API达到调用上限。 刷新授权API：输入正确的app_secret，app_secret从“应用管理”页面获取。 其他API：请稍等一分钟后再试，并联系华为云客服申请更高的应用使用配额。
语音通话如何获取APP接入地址、APP_Key和APP_Secret？ APP接入地址是语音通话平台提供给客户调用语音通话API接口的地址。 APP_Key和APP_Secret是语音通话平台提供给客户调用语音通话通话API接口的鉴权信息。 添加应用后APP_Key和APP_Secret由平台会自动生成，提交应用创
终止呼叫场景API 典型场景 SP通过请求响应或者呼叫状态和话单通知API获取到sessionid后，若需要终止呼叫，可调用“终止呼叫场景API”。 接口功能 开发者在开发应用时，通过调用终止呼叫场景API，可以实现终止呼叫的功能。 如果业务已经执行完毕，终止呼叫API会返回失败。
语音验证码场景API 典型场景 使用语音验证码功能时，调用此API，请求语音通话平台给特定用户播放语音验证码。 接口功能 语音验证码是SP将被叫号码和数字验证码发送给业务平台，由业务平台呼叫被叫，并在被叫接听后播放验证码。 业务体验描述： SP想要给用户A通知一串数字验证码。 S
语音通知API 典型场景 使用语音通知功能时，调用此API，请求语音通话平台给指定用户播放语音通知。 接口功能 语音通知是SP将被叫号码和语音通知文件名（语音文件需要提前通过放音文件管理页面上传）或语音通知文本（通过语音模板管理页面提交）发送给业务平台，由业务平台呼叫被叫，被叫接
便快捷，拨通率高；安全可靠，防盗取，防攻击；性能稳定，支持大容量、高并发 本文档提供了语音通话API的描述、参数说明及示例等内容。支持的全部操作请参见API接口使用说明。 在调用API之前，请确保已经充分了解语音通话相关概念及功能详解，详细信息请参见语音通话“产品介绍”。 录音功
资源项 对应接口参数 用途 获取方式 APP_Key X-AKSK X-AKSK鉴权所需参数。 登录管理控制台，从“应用管理”页面获取。 创建应用，请参考添加应用。 APP_Secret APP接入地址 - API调用的基地址。 访问URI - 语音回呼场景API的接口访问URI。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
