用户在使用语音服务过程中产生的号码、通话数据可以通过接收消息回执的方式获取到。
回执消息 | 概述 | 配置地址 |
---|---|---|
号码状态 | 号码状态发生变更时向用户推送相关数据,比如控制台停用、启用号码,号码因投诉下线,用户因欠费回收号码等 | 语音服务控制台-业务设置-基础设置-回调设置 |
风控回调 | 号码命中风控规则而冻结时,向客户推送冻结数据 | 语音服务控制台-业务设置-基础设置-回调设置 |
呼叫状态 | 呼叫状态实时推送,通常包括发起、振铃、接通、挂断等状态 | SIP通话: |
呼叫记录 | 呼叫结束后向客户推送通话详细数据 | SIP通话: |
呼叫录音 | 呼叫结束后向客户推送通话录音数据 | SIP通话: |
用户在控制台配置的回调地址需满足以下要求
需要HTTPs 地址,并处理POST请求
需要具备公网访问的能力
回调前会对数据进行签名,用户可通过签名验证数据合法性;
语音服务回调过程中使用固定的公网出口,用户如需加白可联系我方提供。在异常情况下可能出现回执重复推送,业务需要做好幂等逻辑。
语音服务推送数据后,根据返回的http状态码判断是否推送成功,当满足以下条件时推送成功
HttpCode >= 200 && HttpCode < 300
即,用户回复http 2XX状态时,认为推送成功
语音服务主要有两种失败重推机制
重复次数 | 1 | 2 | 3 | 4 | 5 |
---|---|---|---|---|---|
延迟时间 | 10s | 30s | 1m | 2m | 3m |
不同消息类型使用不同的重推组合
回执消息 | 重推组合 |
---|---|
号码状态 | 指数退避重推 |
风控回调 | 指数退避重推 |
呼叫状态 | 不重推 |
呼叫记录 | 指数退避重推+自动任务重推 |
呼叫录音 | 指数退避重推+自动任务重推 |