检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
语音验证码场景API 典型场景 使用语音验证码功能时,调用此API,请求语音通话平台给特定用户播放语音验证码。 接口功能 语音验证码是SP将被叫号码和数字验证码发送给业务平台,由业务平台呼叫被叫,并在被叫接听后播放验证码。 业务体验描述: SP想要给用户A通知一串数字验证码。
语音验证码话单通知API 接口功能 用户通话结束后,语音通话平台通过此接口向SP推送通话的话单信息。短时间内有多个通话结束时语音通话平台会将话单合并推送,每条消息最多携带50个话单。
接口类型 表1 接口类型说明 请求方法 POST 访问URI 开发者应用接收呼叫状态URL 通信协议 HTTPS/HTTP 请求参数 SP调用语音验证码API,语音通话平台发起呼叫,给用户播放语音验证码。 注:以下流程以语音通话平台呼叫A,给A播放语音验证码为例。
该参数表示平台呼叫端口空闲可用数量,取值范围0~65535。 结果码 请根据以下结果码进行调测,如果有疑问,可联系管理员进行确认。 表8 结果码说明 响应码 结果码 英文描述 中文描述 处理方法 200 0 Success. 成功。 无需处理。
接收到语音通话平台推送的呼叫状态和话单通知时,必须回200 OK响应消息,否则语音通话平台会认为推送失败。 父主题: 呼叫状态和话单通知
号码仅支持全局号码格式(包含国家码),比如+8675528****02。 sessionId 是 String(1-256) 通话链路的唯一标识。 callerNum 是 String(1-32) 主叫号码,号码为全局号码格式(包含国家码),比如+86138****0021。
号码仅支持全局号码格式(包含国家码),比如+86138****0021。 当呼叫场景经过转接时,此参数对应第二路呼叫的被叫号码。 注:语音回呼场景,第二路呼叫是语音通话平台呼叫B,fwdDstNum为B号码。
并通过放音文件管理页面提前上传到语音通话平台并通过审核后才可使用。 语音模板需通过语音模板管理页面提前上传到语音通话平台并通过审核后才可使用。 父主题: 放音文件及语音模板配置
语音验证码API使用说明 API列表 API名称 API功能 语音验证码场景API 请求语音通话平台向指定用户播放语音验证码。 语音验证码呼叫状态通知API 语音通话平台向SP推送接收语音通话业务用户呼叫时的状态信息,如呼入、呼出、振铃、应答、挂机等状态的信息。
通过华为平台推送话单中的recordObjectName和recordDomain调用获取录音文件下载地址API,再通过获取的地址下载录音文件。
若语音通话平台给SP推送呼叫状态或话单后未收到成功响应,视为推送失败。 若呼叫状态通知推送失败,语音通话平台不会重新推送。 若话单通知推送失败,语音通话平台会重新推送话单,直至客户返回成功响应。最多重推6次,每次时间间隔1小时。
APP接入地址是语音通话平台提供给客户调用语音通话API接口的地址。 APP_Key和APP_Secret是语音通话平台提供给客户调用语音通话通话API接口的鉴权信息。
号码仅支持全局号码格式(包含国家码),比如+86138****7021。 注: 语音回呼业务: 语音通话平台呼叫A时的呼出事件主叫号码为SP设置的主叫端来电显示号码(displayNbr)。
号码仅支持全局号码格式(包含国家码),比如+86138****7021。 注:呼出事件的主叫号码为SP设置的来电显示号码(displayNbr)。 called 否 String(1-32) 被叫号码。 号码仅支持全局号码格式(包含国家码),比如+86138****7021。
该参数表示平台呼叫端口空闲可用数量,取值范围0~65535。 结果码 请根据以下结果码进行调测,如果有疑问,可联系管理员进行确认。 表6 结果码说明 响应码 结果码 英文描述 中文描述 处理方法 200 0 Success. 成功。 无需处理。
对于通话时间小于3秒的呼叫,语音通话平台不会生成录音文件,所以无法下载。 父主题: 故障排除
打车软件服务器发起语音验证码请求,请求语音通话平台向Jane播放语音验证码。 打车软件服务器调用“语音验证码API”实现整个呼叫过程。 语音通话平台呼叫Jane。 Jane接听。 语音通话平台向Jane播放语音验证码。
调用语音通知API播放完语音通知后: 如果没有设置收号功能(collectInd取值为0),则语音通话平台会在播放完语音通话内容后自动挂断电话。
应用调用API发起呼叫后,语音通话平台在接收到终端用户操作通知时,如振铃、接听、挂机等,会实时向企业服务器推送呼叫状态通知。 呼叫终止时,即用户未接听、用户挂机或异常挂机,语音通话平台会向企业服务器推送话单通知。 父主题: 呼叫状态和话单通知
'preTone': preTone,#播放语音验证码之前需要播放的放音文件名 'verifyCode': verifyCode#验证码:只支持0~9的数字,最大8位。