检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
Secret？ APP接入地址是语音通话平台提供给客户调用语音通话API接口的地址。 APP_Key和APP_Secret是语音通话平台提供给客户调用语音通话通话API接口的鉴权信息。 添加应用后APP_Key和APP_Secret由平台会自动生成，提交应用创建后请根据提示及时下
语音验证码话单通知API 接口功能 用户通话结束后，语音通话平台通过此接口向SP推送通话的话单信息。短时间内有多个通话结束时语音通话平台会将话单合并推送，每条消息最多携带50个话单。 请求方向 语音通话平台（客户端） → 客户服务器（服务端） 使用说明 前提条件 SP在开发应用时
语音验证码API使用说明 API列表 API名称 API功能 语音验证码场景API 请求语音通话平台向指定用户播放语音验证码。 语音验证码呼叫状态通知API 语音通话平台向SP推送接收语音通话业务用户呼叫时的状态信息，如呼入、呼出、振铃、应答、挂机等状态的信息。 语音验证码话单通知API
语音验证码能力实现流程 前提条件 打车软件服务器与语音通话平台对接正常。 打车软件服务器成功登录语音通话平台。 Jane注册打车软件，输入电话号码后，点击“获取语音验证码”。 打车软件服务器发起语音验证码请求，请求语音通话平台向Jane播放语音验证码。 打车软件服务器调用“语音验证码API”实现整个呼叫过程。
语音验证码场景API 典型场景 使用语音验证码功能时，调用此API，请求语音通话平台给特定用户播放语音验证码。 接口功能 语音验证码是SP将被叫号码和数字验证码发送给业务平台，由业务平台呼叫被叫，并在被叫接听后播放验证码。 业务体验描述： SP想要给用户A通知一串数字验证码。 SP
开发者应用接收呼叫状态URL 通信协议 HTTPS/HTTP 请求参数 SP调用语音验证码API，语音通话平台发起呼叫，给用户播放语音验证码。 注：以下流程以语音通话平台呼叫A，给A播放语音验证码为例。流程和接口示例仅供参考，请以实际消息为准。 表2 请求Headers参数说明 参数名称
为什么通话时间小于3秒的呼叫无法下载录音文件? 对于通话时间小于3秒的呼叫，语音通话平台不会生成录音文件，所以无法下载。 父主题： 故障排除
放音文件和语音模板必须要审核通过后才可使用吗？ 是的。 放音文件需按要求制作，请参考制作放音文件。并通过放音文件管理页面提前上传到语音通话平台并通过审核后才可使用。 语音模板需通过语音模板管理页面提前上传到语音通话平台并通过审核后才可使用。 父主题： 放音文件及语音模板配置
接收呼叫状态和话单通知后需要返回响应消息吗？ 接收到语音通话平台推送的呼叫状态和话单通知时，必须回200 OK响应消息，否则语音通话平台会认为推送失败。 父主题： 呼叫状态和话单通知
如何下载录音文件？ 通过华为平台推送话单中的recordObjectName和recordDomain调用获取录音文件下载地址API，再通过获取的地址下载录音文件。 注：若华为平台推送的调测信息中有特殊说明，请直接使用FeeInfo（话单通知）中recordFileDownloadUrl的链接下载录音文件。
请求参数中returnIdlePort为true时响应消息携带该参数。 该参数表示平台呼叫端口空闲可用数量，取值范围0~65535。 结果码 请根据以下结果码进行调测，如果有疑问，可联系管理员进行确认。 表8 结果码说明 响应码 结果码 英文描述 中文描述 处理方法 200 0 Success. 成功。
语音通话平台发送的通知信息。 提供话单接收URL有以下两种方式： 提前通过应用管理向语音通话平台提交话单接收URL。 SP应用调用场景API时，填写feeUrl参数。 注意事项 若平台给SP推送话单后未收到成功响应，视为推送失败，会重新推送话单，直至客户返回成功响应。平台最多重推
语音通话平台发送的通知信息。 提供话单接收URL有以下两种方式： 提前通过应用管理向语音通话平台提交话单接收URL。 SP应用调用场景API时，填写feeUrl参数。 注意事项 若平台给SP推送话单后未收到成功响应，视为推送失败，会重新推送话单，直至客户返回成功响应。平台最多重推6次，每次时间间隔1小时。
语音通话的呼叫状态通知和话单通知支持重推吗？ 若语音通话平台给SP推送呼叫状态或话单后未收到成功响应，视为推送失败。 若呼叫状态通知推送失败，语音通话平台不会重新推送。 若话单通知推送失败，语音通话平台会重新推送话单，直至客户返回成功响应。最多重推6次，每次时间间隔1小时。若6次
呼叫状态和话单通知什么时候推送？ 应用调用API发起呼叫后，语音通话平台在接收到终端用户操作通知时，如振铃、接听、挂机等，会实时向企业服务器推送呼叫状态通知。 呼叫终止时，即用户未接听、用户挂机或异常挂机，语音通话平台会向企业服务器推送话单通知。 父主题： 呼叫状态和话单通知
附录3-其他附加性说明 本文档中提供的API接口均采用短连接（短信接口除外，短信接口可支持长连接。），平台服务器作为服务端时会主动拆链，建议SP作为客户端时不要主动拆链，等接收到服务端的FIN, ACK后按照正常四次挥手拆链。 若SP主动拆链，可能造成该链路对应的端口短时间不可用，影响SP发送请求。
Url），并且确保URL能够正常处理语音通话平台发送的通知信息。 提供呼叫状态接收URL有以下两种方式： 提前通过应用管理向语音通话平台提交呼叫状态接收URL。 SP应用调用场景API时，填写statusUrl。 使用限制 语音通话平台推送呼叫状态给开发者应用，仅支持POST方式。
Url），并且确保URL能够正常处理语音通话平台发送的通知信息。 提供呼叫状态接收URL有以下两种方式： 提前通过应用管理向语音通话平台提交呼叫状态接收URL。 SP应用调用场景API时，填写statusUrl。 使用限制 语音通话平台推送呼叫状态给开发者应用，仅支持POST方式。
请求参数中returnIdlePort为true时响应消息携带该参数。 该参数表示平台呼叫端口空闲可用数量，取值范围0~65535。 结果码 请根据以下结果码进行调测，如果有疑问，可联系管理员进行确认。 表6 结果码说明 响应码 结果码 英文描述 中文描述 处理方法 200 0 Success. 成功。
调用语音通知API播放完语音通知后： 如果没有设置收号功能（collectInd取值为0），则语音通话平台会在播放完语音通话内容后自动挂断电话。 如果设置了收号功能（collectInd取值为1~32）： 语音通话平台在收号后自动挂断电话（replayAfterCollection取值为false，
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
