本文为您介绍了通话详情相关的接口说明。

API列表

API名称 描述
HotlineSessionQuery 查询通话详情
GetRecordData 获取通话录音

HotlineSessionQuery

批量查询通话详情。

请求参数

参数名称 类型 是否必填 描述
InstanceId String 实例ID,在控制台上可以看到
PageNo Integer 页码,不填默认第一页,范围1~1000
PageSize Integer 单页查询大小,不填默认为10,范围1~50
CallType Integer 呼叫类型(1-外呼,2-入呼,3-转交)
CallTypeList List<Integer> 呼叫类型列表
Id String 通话详情全局唯一ID
Acid String 会话ID
AcidList List<String> 会话ID列表
CallingNumber String 原始主叫号码
CallingNumberList List<String> 主叫号码列表
CalledNumber String 原始被叫号码
CalledNumberList List<String> 被叫号码列表
GroupId Long 技能组ID
GroupIdList List<Long> 技能组列表
GroupName String 技能组名称
MemberId String 会员ID
MemberIdList List<String> 会员列表
MemberName String 会员名称
QueryStartTime Long 查询开始时间(时间戳)
QueryEndTime Long 查询结束时间(时间戳)
ServicerId String 坐席ID
ServicerIdList List<String> 坐席列表
ServicerName String 坐席名称
CallResult String 呼叫结果

normal - 正常通话结束

queueClose - 队列挂机

dailingClose - 振铃挂机

ivrClose - IVR挂机

CallResultList List<String> 呼叫结果列表

返回数据

参数说明 类型 是否为空 描述
RequestId String 请求ID,用于跟踪错误原因
Success Boolean 接口调用是否成功
Code String 错误编码
Message String 错误描述
Data Object 查询结果数据,具体协议如下

Data数据说明

字段 类型 描述 备注
CreateTime String 通话创建时间 外呼场景为外呼发起时间;入呼场景为通话进入ACC系统时间
Acid String 通话id
Id String 通话详情全局唯一ID
CallType Integer 呼叫类型 1-外呼,2-呼入, 3-转交
GroupId Long 技能组ID 外呼场景无技能组信息(CallType=1)
GroupName String 技能组名称 外呼场景无技能组信息(CallType=1)
CallingNumber String 主叫号码
CalledNumber String 被叫号码
ServicerId String 坐席id 呼入场景未分配到到人之前无坐席信息
ServicerName String 坐席名称 呼入场景未分配到到人之前无坐席信息
MemberId String 会员id
MemberName String 会员昵称
InQueueTime String 热线分配-入队时间 外呼场景无入队时间
OutQueueTime String 热线分配-出队时间 外呼场景无出队时间
RingStartTime String 振铃开始时间 外呼场景无振铃开始时间
RingEndTime String 振铃结束时间 外呼场景无振铃结束时间
RingContinueTime Integer 振铃时长 单位:秒(PS:外呼场景无振铃时间)
PickUpTime String 接起时间
HangUpTime String 挂断时间
QueueUpContinueTime Integer 排队时长 单位:秒(PS:外呼场景无排队时长)
CallContinueTime Integer 通话时长 单位:秒(PS:未接通场景无通话时长)
EvaluationLevel Integer 满意度-评价星级 外呼场景 & 未接通场景无数据
EvaluationScore Integer 满意度-评价得分

1:非常不满意

2:不满意

3:一般

4:满意

5-非常满意

(PS:外呼场景 & 未接通场景无数据)
CallResult String 呼叫结束原因

normal :正常通话结束

queueClose :队列挂机

dailingClose :振铃挂机

ivrClose: IVR挂机

HangUpRole String 挂机方

1:系统挂机

2:客户挂机

3:客服挂机

null:未知

ActiveTransferId String 会话转交方 坐席ID(PS:非转交场景数据为Null)
PassiveTransferId String 会话被转交方 坐席ID/转交电话号码(PS:非转交场景数据为Null)
PassiveTransferIdType String 会话被转交方

1-坐席ID

2-转交电话号码

(PS:非转交场景数据为Null)

TrunkCall String 中继号

返回结果示例

{
  "RequestId": "49AE4180-E34C-4634-9AFE-EF8310902126",
  "Message": "successful",
  "Data": {
    "TotalCount": 6,
    "PageSize": 1,
    "PageNumber": 1,
    "CallDetailRecord": [
      {
        "MemberId": "-1",
        "Acid": "10010870641",
        "Id": "1dd1361e8b624274b1394182c947aa8c",
        "CalledNumber": "18818700279",
        "ServicerName": "s16028@4pxtech.onaliyun.com",
        "HangUpRole": "3",
        "CallType": 1,
        "MemberName": "匿名会员",
        "ServicerId": "374016",
        "HangUpTime": "2020-09-01T16:20Z",
        "CallingNumber": "057126885980",
        "CallEndReason": "dailing"
      }
    ]
  },
  "Code": "200",
  "Success": true
}

GetRecordData

获取录音文件。

请求参数

参数名称 类型 是否必填 描述
InstanceId String 实例ID,在控制台上可以看到
Acid String 会话ID

返回数据

参数说明 类型 是否为空 描述
RequestId String 请求ID,用于跟踪错误原因
Success Boolean 接口调用是否成功
Code String 错误编码
Message String 错误描述
Data Object 查询结果数据,具体协议如下

返回结果示例

{
  "RequestId": "API-3a682d30-9bea-4e66-b91a-898abdfb848a",
  "Message": "successful",
  "Data": {
    "Acid": "10010679715",
    "OssLink": "http://aliccrec-shvpc.oss-cn-shanghai.aliyuncs.com/accrec_tmp/10010679716-12-01-56.wav?Expires=1598936426&OSSAccessKeyId=LTAI2qtqXQPfkZJM&Signature=E7I4DHGz6RLfhyud4pp6RSiJTX0%3D",
  },
  "Code": "200"
}