检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
方便快捷，拨通率高；安全可靠，防盗取，防攻击；性能稳定，支持大容量、高并发 本文档提供了语音通话API的描述、参数说明及示例等内容。支持的全部操作请参见API接口使用说明。 在调用API之前，请确保已经充分了解语音通话相关概念及功能详解，详细信息请参见语音通话“产品介绍”。
API调用失败如何处理？失败后可以一直不停的调用吗？ 当SP调用API接口失败时，根据语音通话平台返回的4xx或5xx消息中“resultdesc”字段初步确定故障类型，例如参数非法、access_token过期、系统错误等。
文档修订记录 发布日期 修订记录 2022/5/7 话单通知接口的recordFileDownloadUrl参数长度由“String(1-256)”修改为“String(1-1024)”。
通话挂机原因值说明 通话挂机原因值 原因值描述 0 接通后主动挂机 7001 开发者呼叫频次管控 7002 应用呼叫频次管控 7003 固话号码呼叫频次管控 7004 被叫黑名单呼叫管控 7108 用户状态已冻结 7109 语音端口不足 8000 内部错误 8001 用户未接续成功
551 点击呼叫本端收到OXX消息 552 远端振铃时本端用户挂机 553 远端还未振铃时本端用户挂机 400~699 在对端没有返回Q850原因值时，直接用SIP消息码（如404：NOT FOUND） 1001 坐席主动挂机 1002 用户主动挂机 1003 SP调用总机释放接口挂机
如何判断华为云服务API接口是否正常？如果不正常如何处理？
调呼叫接口时带上参数“recordHintTone”，值为“testvoice.wav”。 父主题： API&代码样例
附录1-Q850原因值说明 原因值 原因值描述 0 不涉及 1 无法找到号码 2 无法路由到网络 3 无法路由到目的地 4 发送特殊消息 5 中继前缀出错 6 通道无法接入 7 已经建立频道 8 抢先占有 9 抢先占有保留 16 正常呼叫清除 17 用户忙 18 无应答 19 无用户应答
附录3-其他附加性说明 本文档中提供的API接口均采用短连接（短信接口除外，短信接口可支持长连接。），平台服务器作为服务端时会主动拆链，建议SP作为客户端时不要主动拆链，等接收到服务端的FIN, ACK后按照正常四次挥手拆链。
父主题： API&代码样例
调用一次“语音通知API”，被叫号码只能填写一个。若要实现通知多个用户，在最大并发之内可以同时调用多个API，每个API填写不同的被叫号码。 由于运营商管控策略不同，并发数量会存在差异。如果业务量较大，可以联系运营经理进行调整。 父主题： API&代码样例
代码样例（JAVA）中只包含该接口的必选参数。可选参数可以参考接口文档按需填写。 调测时请求路径参数path是否需要带sandbox，以华为提供的调测信息为准。 父主题： API&代码样例
APP接入地址是语音通话平台提供给客户调用语音通话API接口的地址。 APP_Key和APP_Secret是语音通话平台提供给客户调用语音通话通话API接口的鉴权信息。
新手必读 语音通话二次开发业务整体流程如下： 参考申请资源，获取调用语音通话API的关联数据。 参考代码样例调用语音通话API，发起语音回呼/语音通知/语音验证码请求。 根据请求响应消息，判断请求是否成功。
APP_Secret APP接入地址 - API调用的基地址。 访问URI - 语音验证码场景API的接口访问URI。 从语音验证码场景API获取。 被叫用户端显示的号码 displayNbr 用户接收到平台来电时的显示号码。可申请多个。 从订购号码页面申请。
放音收号的结果会在呼叫状态通知API中返回。若SP在请求中配置了statusUrl接收呼叫状态推送，则语音通话平台推送collectInfo事件类型的呼叫状态通知中，digitInfo参数值为收号结果。具体参数可参考语音通知的呼叫状态通知API。
调用“语音通知API”时设置相关参数即可实现收号功能。具体请参考语音通知API。 涉及收号功能的参数有三个： collectInd：设置是否进行收号。 replayAfterCollection：当collectInd字段设置为非0时此参数有效。
录音相关接口： 获取录音文件下载地址API 语音通知&语音验证码 尊敬的客户：欢迎您使用语音通话服务。如下为服务指南： 获取接口文档： 请访问语音通知API或语音验证码场景API，获取PDF版接口文档。 获取代码样例： 请访问语音通知代码样例，获取语音通知代码样例。
调用接口时请求不通，没有任何返回信息，怎么处理？ 请求方法、请求URL或请求Headers填写错误，导致请求没有发送到语音通话平台。请参照对应的“API参考”，按照以下步骤排查请求包含的参数是否完整，参数是否填写正确，参数位置是否正确。
详情请查看语音通知API。 父主题： 放音文件及语音模板配置
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
