检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
便快捷，拨通率高；安全可靠，防盗取，防攻击；性能稳定，支持大容量、高并发 本文档提供了语音通话API的描述、参数说明及示例等内容。支持的全部操作请参见API接口使用说明。 在调用API之前，请确保已经充分了解语音通话相关概念及功能详解，详细信息请参见语音通话“产品介绍”。 录音功
附录 通话挂机原因值说明 附录1-Q850原因值说明 附录2-呼叫拆线点说明 附录3-其他附加性说明
信息单元不存在 100 无效的信息单元 101 呼叫状态不一致 102 定时器超时 103 参数不存在 110 消息中带有未识别的参数 111 协议错误 127 未指定的交互 父主题： 附录
API调用失败如何处理？失败后可以一直不停的调用吗？ 当SP调用API接口失败时，根据语音通话平台返回的4xx或5xx消息中“resultdesc”字段初步确定故障类型，例如参数非法、access_token过期、系统错误等。调用接口失败后要及时排查原因，不可以一直不停的调用，容易导致IP被封禁。
2022/5/7 话单通知接口的recordFileDownloadUrl参数长度由“String(1-256)”修改为“String(1-1024)”。 2020/7/28 新增API错误码1013112-1013118 2019/9/17 语音回呼场景API/语音通知API/语音验证码场景API新增结果码1020151
通话挂机原因值说明 通话挂机原因值 原因值描述 0 接通后主动挂机 7001 开发者呼叫频次管控 7002 应用呼叫频次管控 7003 固话号码呼叫频次管控 7004 被叫黑名单呼叫管控 7108 用户状态已冻结 7109 语音端口不足 8000 内部错误 8001 用户未接续成功，可能包含以下场景：
在应用管理页面，点击“修改应用”，“是否开通录音”选择“是”，“随机抽检录音提示音”选择提示音：***.wav。 调呼叫接口时带上参数“recordHintTone”，值为“testvoice.wav”。 父主题： API&代码样例
附录3-其他附加性说明 本文档中提供的API接口均采用短连接（短信接口除外，短信接口可支持长连接。），平台服务器作为服务端时会主动拆链，建议SP作为客户端时不要主动拆链，等接收到服务端的FIN, ACK后按照正常四次挥手拆链。 若SP主动拆链，可能造成该链路对应的端口短时间不可用，影响SP发送请求。
在对端没有返回Q850原因值时，直接用SIP消息码（如404：NOT FOUND） 1001 坐席主动挂机 1002 用户主动挂机 1003 SP调用总机释放接口挂机 1004 发起点击外呼后，坐席进行盲转并挂机 2801 IVR放音失败 2802 IVR规则无效 2803 IVR按键超过最大次数 2805
如何实现同时给多个用户发送语音通知？ 调用一次“语音通知API”，被叫号码只能填写一个。若要实现通知多个用户，在最大并发之内可以同时调用多个API，每个API填写不同的被叫号码。 由于运营商管控策略不同，并发数量会存在差异。如果业务量较大，可以联系运营经理进行调整。 父主题： API&代码样例
代码样例（JAVA）工程中使用到的公共库需要开发者在网上自行下载。 代码样例（JAVA）中只包含该接口的必选参数。可选参数可以参考接口文档按需填写。 调测时请求路径参数path是否需要带sandbox，以华为提供的调测信息为准。 父主题： API&代码样例
语音回呼有最大通话时长限制吗？ 在调用语音回呼场景API时可通过maxDuration设置允许单次通话进行的最长时间，通话时间从被叫接通的时刻开始计算。 maxDuration取值为0或不携带：系统不主动结束通话，由主被叫双方结束通话。 maxDuration取值为1~1440：
语音通话如何获取APP接入地址、APP_Key和APP_Secret？ APP接入地址是语音通话平台提供给客户调用语音通话API接口的地址。 APP_Key和APP_Secret是语音通话平台提供给客户调用语音通话通话API接口的鉴权信息。 添加应用后APP_Key和APP_Secret由平台会自动生成，提交应用创
请求URL按照接口文档中“接口类型说明”和“请求URL参数说明”构造： 请求URL格式举例，https://IP:Port/访问URI?app_key=key&username=user 从“应用管理”页面获取APP接入地址； 访问URI各接口不同，请参照接口文档； 其余参数各接口不同，
常见问题： 请参考语音通话常见问题。 录音相关接口： 获取录音文件下载地址API 语音通知&语音验证码 尊敬的客户：欢迎您使用语音通话服务。如下为服务指南： 获取接口文档： 请访问语音通知API或语音验证码场景API，获取PDF版接口文档。 获取代码样例： 请访问语音通知代码样例，获取语音通知代码样例。
资源项 对应接口参数 用途 获取方式 APP_Key X-AKSK X-AKSK鉴权所需参数。 登录管理控制台，从“应用管理”页面获取。 创建应用，请参考添加应用。 APP_Secret APP接入地址 - API调用的基地址。 访问URI - 语音回呼场景API的接口访问URI。
语音通话二次开发业务整体流程如下： 参考申请资源，获取调用语音通话API的关联数据。 参考代码样例调用语音通话API，发起语音回呼/语音通知/语音验证码请求。 根据请求响应消息，判断请求是否成功。 请求成功 => 4 请求失败 => 参考API错误码，修正后重新执行2 参考挂机原因值、Q850原
挂机原因值、Q850原因值、呼叫拆线点 调用语音通话相关接口会产生接口调用错误码，详见API错误码。 调用接口成功后，如果“statusUrl”和“feeUrl”参数指定了客户接收状态上报的URL和接收话单上报的URL，或在添加应用时指定了呼叫状态接收地址和呼叫话单接收地址，则语
呼叫状态接收地址和话单接收地址有以下两种提供方式： 在控制台添加应用时填写呼叫状态接收地址和话单接收地址。 在调用业务接口时加入statusUrl和feeUrl两个参数，参数具体说明可参考语音回呼场景API。不同业务接口的feeUrl和statusUrl的参数填写方式相同（feeUrl和statusUrl可设
需要接收状态和话单时,请参考"呼叫状态和话单通知API"接口实现状态通知和话单的接收和解析. // HostingVoiceEventDemoImpl // TODO 需要下载录音文件时,请参照"获取录音文件下载地址API"接口获取录音文件下载地址.
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
