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