虚拟号通话录音同步

接口说明

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"
}
Copyright © 首约科技(北京)有限公司 2020 all right reserved,powered by Gitbook该文件修订时间: 2025-06-09 09:08:41

results matching ""

    No results matching ""