本节针对典型场景说明及场景涉 API 的使用方法,供第三方平台在研发系统时参考。
1 AXB 模式
X 表示米糠小号, A、 B 为平台两类用户, A 和 B 用户之间不知道对方真实号码的存在,他们所拨打的被叫号码都是 X。 AXB 场景下 X 号码允许被多组号码进行绑定, 同一个 X 号码不能被相同的 A 或者 B 号码同时绑定。
AXB 模式涉及的接口:
应用接口:
获取可用小号:获取应用下面可以使用的小号,使用该列表中的小号可以进行绑定 A、B 号码,AXB 模式的可用小号的获取规则为绑定数量组数最少的优先获取,相同绑定组数则绑定总数量少的优先
AXB 绑定:通过 X 号码绑定 A、B 号码
AXB 解绑:对绑定的关系进行解绑,可根据设定时间自动解绑
AXB 自动绑定:传入 AB 号码,自动绑定并返回 X 号码
通话记录推送接口:
A、B 通过 X 通话完成后,主动推送到第三方提供接收通话记录接口。包括主叫、被叫、通话时长、通话状态等信息。
录音播放及下载接口
在绑定号码时启用了录音功能,则可以调用录音下载接口下载录音
2 AX 模式
X 表示米糠小号, A 为用户。 A 用户对外呈现的号码用 X 替代,所有与 A 用户建立的通讯都是通过 X 号码建立。 AX 场景下 X 号码只能被 A 号码独享,即不同 A 号码对应不同的 X 号码。
AX 模式涉及的接口:
应用接口:
获取可用小号:获取应用下面可用小号进行绑定 A 用户。
AX 绑定:通过 X 号码绑定 A 号码。
AX 解绑:根据设定时间自动解绑或业务流程触发解绑。
AX 自动绑定:传入 A 号码,自动绑定并返回 X 号码
呼叫通知接口:
呼出流程(A 呼 X),真实被叫号码 B 由应用在点击呼叫时提交给小号平台。请参考 AX 呼出接口。
呼入流程(B 呼 X),真实被叫 A 由小号平台自动根据 AX 绑定关系获取到。
通话记录推送接口:
A、B 通过 X 通话完成后,主动推送到第三方提供接收通话记录接口。包括主叫、被叫、通话时长、通话状态等信息。
录音播放及下载接口
在绑定号码时启用了录音功能,则可以调用录音下载接口下载录音