You need to enable JavaScript to run this app.
导航
简介
最近更新时间:2024.08.20 16:19:24首次发布时间:2023.02.28 20:31:39

用户在使用语音服务过程中产生的号码、通话数据可以通过接收消息回执的方式获取到。

1. 回执类型
回执消息概述配置地址
号码状态号码状态发生变更时向用户推送相关数据,比如控制台停用、启用号码,号码因投诉下线,用户因欠费回收号码等语音服务控制台-业务设置-基础设置-回调设置
风控回调号码命中风控规则而冻结时,向客户推送冻结数据语音服务控制台-业务设置-基础设置-回调设置

呼叫状态

呼叫状态实时推送,通常包括发起、振铃、接通、挂断等状态

SIP通话:
语音服务控制台-业务设置-语音设置-回调设置
隐私号通话:
语音服务控制台-业务设置-隐私号设置-回调设置

呼叫记录

呼叫结束后向客户推送通话详细数据

SIP通话:
语音服务控制台-业务设置-语音设置-回调设置
隐私号通话:
语音服务控制台-业务设置-隐私号设置-回调设置

呼叫录音

呼叫结束后向客户推送通话录音数据

SIP通话:
语音服务控制台-业务设置-语音设置-回调设置
隐私号通话:
语音服务控制台-业务设置-隐私号设置-回调设置

2. 回调机制

回调地址

用户在控制台配置的回调地址需满足以下要求

  • 需要HTTPs 地址,并处理POST请求

  • 需要具备公网访问的能力

  • 回调前会对数据进行签名,用户可通过签名验证数据合法性;

语音服务回调过程中使用固定的公网出口,用户如需加白可联系我方提供。在异常情况下可能出现回执重复推送,业务需要做好幂等逻辑。

3. 失败重推机制

如何判断推送成功

语音服务推送数据后,根据返回的http状态码判断是否推送成功,当满足以下条件时推送成功

HttpCode >= 200 && HttpCode < 300

即,用户回复http 2XX状态时,认为推送成功

失败重推

语音服务主要有两种失败重推机制

  • 指数退避重推,在失败后共执行5次重推
重复次数12345
延迟时间10s30s1m2m3m
  • 自动任务重推,由自动任务发起,每2小时执行一次(0点、2点、4点等,每天执行12次)

不同消息类型使用不同的重推组合

回执消息重推组合
号码状态指数退避重推
风控回调指数退避重推
呼叫状态不重推
呼叫记录指数退避重推+自动任务重推
呼叫录音指数退避重推+自动任务重推