虚拟号通话录音同步
接口说明
1.接口属性:非必需接入接口
2.接口开通:请渠道方与商务申请开通后方可使用
3.推送方式:当每个通话结束,首约从阿里获取到通话录音文件后,主动推送给渠道方
4.推送内容:一次性将通话接口内容+录音文件推送
5.推送范围:
- 乘客通话若未接通,若阿里云有回调则会通知渠道方
- 乘客通话已接通,若阿里云有回调则会通知渠道方
6.推送数量:每条通话录音单独推送
7.推送时效:阿里云回调会传输,会有2-5min延迟,其中85%为2min内
8.推送渠道开关:渠道方侧录音文件推送支持首约开关配置
- 开启,已配置的渠道侧通话录音全推送
- 关闭,所有渠道侧通话录音全不推送;(不支持按城市开启/关闭) -默认全不推送
9.推送失败:首约有阶梯重推策略
10.接口超时时间:渠道方接口响应超时超过2秒,即为推送失败
接口地址
https:// <Partner_DOMAIN>/<CallBackURL>
请求方式
POST
请求参数
名称 | 类型 | 必选 | 说明 |
---|---|---|---|
channel | String | yes | 渠道名称,首汽提供 |
timestamp | Long | yes | 请求时间,Unix Timestamp单位毫秒 |
sign | String | yes | 签名(参考首约签名规范) |
partnerOrderNo | String | yes | 合作方订单号 |
orderNo | String | yes | 首约订单号 |
callingPhoneNum | String | yes | 主叫号码 1. 乘客-》司机拨打 • 主叫号码 = 乘客下单的手机号码; • 被叫号码 = 司机手机号码; 2.司机-》乘客拨打 • 主叫号码 = 司机手机号码; • 被叫号码 = 乘客下单的手机号码; PS:所有传输中乘客为真实号码,司机传虚拟号; |
calledPhoneNum | String | yes | 被叫号码,规则同上 |
callType | String | yes | 呼叫类型1,乘客主叫;2,司机主叫; |
calledVirtualPhoneNum | String | yes | 虚拟号码 |
beginTime | Long | yes | 呼叫开始的时间(Unix Timestamp单位毫秒) |
connectTime | Long | yes | 通话开始的时间(Unix Timestamp单位毫秒) |
callResult | String | yes | 通话状态 通话状态,可选值: ANSWERED: 通话成功(含通话时长), OTHER: 通话失败(不含通话时长); |
mosRecordUrl | String | yes | 通话录音文件url,根据url进行下载 |
alertingTime | Long | yes | 被叫振铃时间(Unix Timestamp单位毫秒) |
releaseTime | Long | yes | 通话结束时刻(Unix Timestamp单位毫秒) |
callDuration | Long | yes | 主被叫之间的通话时长,单位为秒 |
返回数据
名称 | 类型 | 说明 |
---|---|---|
result | Integer | 0:成功;非0:失败原因编号 |
errmsg | String | 描述 |
返回示例
{
"result": 0,
"message": "SUCCESS"
}