检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
附录 通话挂机原因值说明 附录1-Q850原因值说明 附录2-呼叫拆线点说明 附录3-其他附加性说明
概述 欢迎使用语音通话服务（VoiceCall）。语音通话服务以云服务的方式提供语音通信能力，支持语音回呼、语音验证码、语音通知。方便快捷，拨通率高；安全可靠，防盗取，防攻击；性能稳定，支持大容量、高并发 本文档提供了语音通话API的描述、参数说明及示例等内容。支持的全部操作请参见
如何判断华为云服务API接口是否正常？如果不正常如何处理？ 语音通话对部分服务器IP做了限制，用户可通过如下方法检查是否可正常访问华为云服务API接口： 华为云服务API接入地址不允许Ping，可通过以下步骤来判断： 使用telnet ip+port，若telnet可连上则可判断客户侧的网络与华为云服务通信正常
文档修订记录 发布日期 修订记录 2022/5/7 话单通知接口的recordFileDownloadUrl参数长度由“String(1-256)”修改为“String(1-1024)”。 2020/7/28 新增API错误码1013112-1013118 2019/9/17 语音回呼场景
通话挂机原因值说明 通话挂机原因值 原因值描述 0 接通后主动挂机 7001 开发者呼叫频次管控 7002 应用呼叫频次管控 7003 固话号码呼叫频次管控 7004 被叫黑名单呼叫管控 7108 用户状态已冻结 7109 语音端口不足 8000 内部错误 8001 用户未接续成功
附录2-呼叫拆线点说明 拆线点 拆线点描述 0 接通后主动挂机 100 放音收号时系统接收到的号码为空，若要进行收号，请在语音通知内容播放完毕后的5秒之内进行按键操作 501 录音创建会议失败 502 录音创建会议超时 503 录音主叫加入会议失败 504 录音主叫加入会议超时 505
语音回呼场景API，可以只给主叫设置录音提示音吗？主被叫可以都设置不提示吗？ 不可以，只能设置为双方均播放提示音，或者双方均不播放提示音。 主被叫不播放录音提示音操作步骤如下： 在控制台放音文件管理中上传一个音频内容为空的放音文件，如下图所示。 在应用管理页面，点击“修改应用”，“
附录1-Q850原因值说明 原因值 原因值描述 0 不涉及 1 无法找到号码 2 无法路由到网络 3 无法路由到目的地 4 发送特殊消息 5 中继前缀出错 6 通道无法接入 7 已经建立频道 8 抢先占有 9 抢先占有保留 16 正常呼叫清除 17 用户忙 18 无应答 19 无用户应答
附录3-其他附加性说明 本文档中提供的API接口均采用短连接（短信接口除外，短信接口可支持长连接。），平台服务器作为服务端时会主动拆链，建议SP作为客户端时不要主动拆链，等接收到服务端的FIN, ACK后按照正常四次挥手拆链。 若SP主动拆链，可能造成该链路对应的端口短时间不可用，
语音回呼有最大通话时长限制吗？ 在调用语音回呼场景API时可通过maxDuration设置允许单次通话进行的最长时间，通话时间从被叫接通的时刻开始计算。 maxDuration取值为0或不携带：系统不主动结束通话，由主被叫双方结束通话。 maxDuration取值为1~1440：当通话时长达到此配置值
代码样例（JAVA）有什么使用注意事项？ 代码样例（JAVA）工程中使用到的公共库需要开发者在网上自行下载。 代码样例（JAVA）中只包含该接口的必选参数。可选参数可以参考接口文档按需填写。 调测时请求路径参数path是否需要带sandbox，以华为提供的调测信息为准。 父主题：
如何实现同时给多个用户发送语音通知？ 调用一次“语音通知API”，被叫号码只能填写一个。若要实现通知多个用户，在最大并发之内可以同时调用多个API，每个API填写不同的被叫号码。 由于运营商管控策略不同，并发数量会存在差异。如果业务量较大，可以联系运营经理进行调整。 父主题： API
语音通话如何获取APP接入地址、APP_Key和APP_Secret？ APP接入地址是语音通话平台提供给客户调用语音通话API接口的地址。 APP_Key和APP_Secret是语音通话平台提供给客户调用语音通话通话API接口的鉴权信息。 添加应用后APP_Key和APP_Secret
新手必读 语音通话二次开发业务整体流程如下： 参考申请资源，获取调用语音通话API的关联数据。 参考代码样例调用语音通话API，发起语音回呼/语音通知/语音验证码请求。 根据请求响应消息，判断请求是否成功。 请求成功 => 4 请求失败 => 参考API错误码，修正后重新执行2 参考挂机原因值
申请资源 语音回呼 表1 语音回呼需准备的资源 资源项 对应接口参数 用途 获取方式 APP_Key X-AKSK X-AKSK鉴权所需参数。 登录管理控制台，从“应用管理”页面获取。 创建应用，请参考添加应用。 APP_Secret APP接入地址 - API调用的基地址。 访问
如何查询放音收号结果？ 放音收号的结果会在呼叫状态通知API中返回。若SP在请求中配置了statusUrl接收呼叫状态推送，则语音通话平台推送collectInfo事件类型的呼叫状态通知中，digitInfo参数值为收号结果。具体参数可参考语音通知的呼叫状态通知API。 消息示例：
如何实现收号功能？ 注：部分城市不支持收号功能，申请号码前可咨询华为云客服。 调用“语音通知API”时设置相关参数即可实现收号功能。具体请参考语音通知API。 涉及收号功能的参数有三个： collectInd：设置是否进行收号。 replayAfterCollection：当collectInd
一个语音通知可以播放几个语音文件？格式是什么？ 一个语音通知最多可以播放5个语音文件，这些文件的格式可以是TTS文本或音频文件。详情请查看语音通知API。 父主题： 放音文件及语音模板配置
什么是收号？ 开发者调用语音通知API通过语音通话平台发起呼叫，给用户播放自定义的语音文件或语音模板内容，用户在放音结束后根据提示输入号码，语音通话平台将获得的用户按键信息反馈给开发者。获取用户按键信息（即用户根据提示输入号码）称为收号。 举例：SP调用语音通知API发送会议通知，
语音通话有哪些可自定义的呼叫提示音，如何上传审核？ 所有放音文件都必须先在放音文件管理页面上传并通过审核后才可使用。 语音回呼 语音回呼支持设置以下呼叫提示音，放音文件审核通过后，调用“语音回呼场景API”时，设置对应参数即可使用。如果不设置，则播放系统默认音。 放音 放音场景 设置参数
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
