检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
什么是收号？ 开发者调用语音通知API通过语音通话平台发起呼叫，给用户播放自定义的语音文件或语音模板内容，用户在放音结束后根据提示输入号码，语音通话平台将获得的用户按键信息反馈给开发者。获取用户按键信息（即用户根据提示输入号码）称为收号。
如何查询放音收号结果？ 放音收号的结果会在呼叫状态通知API中返回。若SP在请求中配置了statusUrl接收呼叫状态推送，则语音通话平台推送collectInfo事件类型的呼叫状态通知中，digitInfo参数值为收号结果。具体参数可参考语音通知的呼叫状态通知API。
如何实现收号功能？ 注：部分城市不支持收号功能，申请号码前可咨询华为云客服。 调用“语音通知API”时设置相关参数即可实现收号功能。具体请参考语音通知API。 涉及收号功能的参数有三个： collectInd：设置是否进行收号。
注：若华为平台推送的调测信息中有特殊说明，请直接使用FeeInfo（话单通知）中recordFileDownloadUrl的链接下载录音文件。 父主题： 录音&收号&TTS相关问题
语音验证码API使用说明 API列表 API名称 API功能 语音验证码场景API 请求语音通话平台向指定用户播放语音验证码。 语音验证码呼叫状态通知API 语音通话平台向SP推送接收语音通话业务用户呼叫时的状态信息，如呼入、呼出、振铃、应答、挂机等状态的信息。
语音验证码话单通知API 接口功能 用户通话结束后，语音通话平台通过此接口向SP推送通话的话单信息。短时间内有多个通话结束时语音通话平台会将话单合并推送，每条消息最多携带50个话单。
语音验证码场景API 典型场景 使用语音验证码功能时，调用此API，请求语音通话平台给特定用户播放语音验证码。 接口功能 语音验证码是SP将被叫号码和数字验证码发送给业务平台，由业务平台呼叫被叫，并在被叫接听后播放验证码。 业务体验描述： SP想要给用户A通知一串数字验证码。
附录3-其他附加性说明 本文档中提供的API接口均采用短连接（短信接口除外，短信接口可支持长连接。），平台服务器作为服务端时会主动拆链，建议SP作为客户端时不要主动拆链，等接收到服务端的FIN, ACK后按照正常四次挥手拆链。
接口类型 表1 接口类型说明 请求方法 POST 访问URI 开发者应用接收呼叫状态URL 通信协议 HTTPS/HTTP 请求参数 SP调用语音验证码API，语音通话平台发起呼叫，给用户播放语音验证码。 注：以下流程以语音通话平台呼叫A，给A播放语音验证码为例。
并通过放音文件管理页面提前上传到语音通话平台并通过审核后才可使用。 语音模板需通过语音模板管理页面提前上传到语音通话平台并通过审核后才可使用。 父主题： 放音文件及语音模板配置
接收到语音通话平台推送的呼叫状态和话单通知时，必须回200 OK响应消息，否则语音通话平台会认为推送失败。 父主题： 呼叫状态和话单通知
该参数表示平台呼叫端口空闲可用数量，取值范围0~65535。 结果码 请根据以下结果码进行调测，如果有疑问，可联系管理员进行确认。 表8 结果码说明 响应码 结果码 英文描述 中文描述 处理方法 200 0 Success. 成功。 无需处理。
号码仅支持全局号码格式（包含国家码），比如+86138****0021。 当呼叫场景经过转接时，此参数对应第二路呼叫的被叫号码。 注：语音回呼场景，第二路呼叫是语音通话平台呼叫B，fwdDstNum为B号码。
调用语音通知API播放完语音通知后： 如果没有设置收号功能（collectInd取值为0），则语音通话平台会在播放完语音通话内容后自动挂断电话。
语音通话平台呼叫Jane。 Jane接听。 语音通话平台向Jane播放业务公司定制的欠费通知。 Jane按照欠费通知中的提示输入号码，语音通话平台收号。 语音通话平台将收号结果通过“呼叫状态和话单通知”API 发送给业务公司服务器。
号码仅支持全局号码格式（包含国家码），比如+8675528****02。 sessionId 是 String(1-256) 通话链路的唯一标识。 callerNum 是 String(1-32) 主叫号码，号码为全局号码格式（包含国家码），比如+86138****0021。
APP接入地址是语音通话平台提供给客户调用语音通话API接口的地址。 APP_Key和APP_Secret是语音通话平台提供给客户调用语音通话通话API接口的鉴权信息。
若语音通话平台给SP推送呼叫状态或话单后未收到成功响应，视为推送失败。 若呼叫状态通知推送失败，语音通话平台不会重新推送。 若话单通知推送失败，语音通话平台会重新推送话单，直至客户返回成功响应。最多重推6次，每次时间间隔1小时。
注：以下流程以语音通话平台呼叫A，给A播放语音文件并收号为例。流程和接口示例仅供参考，请以实际消息为准。
号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注： 语音回呼业务： 语音通话平台呼叫A时的呼出事件主叫号码为SP设置的主叫端来电显示号码（displayNbr）。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
