AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 智能联络中心 开发参考 API参考指南 API目录 通话详情 HotlineSessionQuery - 批量查询通话详情

HotlineSessionQuery - 批量查询通话详情

更新时间：
产品详情
我的收藏

根据实例ID查询通话详情。

接口说明

通话详情包含总共记录数、呼叫结果、坐席名称、通话时间等信息。

QPS 限制

  • 单用户调用频率：不限流。
  • API 频率：80 次/秒。
说明 如果多个用户的总调用超过 API 频率也会触发流控。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
InstanceIdstring是

AICCS 实例 ID。 您可以在智能联络中心控制台左侧导航栏的实例管理中获取。

ccc_xp_pre-cn-***
Acidstring否

会话 ID。入呼后，websocket 中的 acid。

7719786****
CallTypeinteger否

电话类型。取值：

  • 1：外呼。
  • 2：入呼。
  • 3：转交。
1
CalledNumberstring否

发起方号码。例如用户手机号码、客服坐席号码、机器号码等。

135615****
CallingNumberstring否

接听方号码。例如用户手机号码、客服坐席号码、机器号码等。

057177****
GroupIdlong否

技能组 ID。

123456
GroupNamestring否

技能组名称。

自动化技能组
MemberIdstring否

会员 ID。

7856****
MemberNamestring否

会员名称。

匿名会员
QueryEndTimelong否

结束时间戳。单位：毫秒。

1614829721
QueryStartTimelong否

开始时间戳。单位：毫秒。

1614828721
RequestIdstring否

请求 ID。

EE338D98-9BD3-4413-B165
ServicerNamestring否

坐席名称。

刘测试
ServicerIdstring否

坐席 ID。

555555
Paramsstring否

扩展参数。

xxxx
PageSizeinteger否

每页大小。取值大于 0，默认值：20。

10
PageNointeger否

当前页。取值大于 0，默认值：1。

1
CallResultstring否

呼叫结果。取值：

  • normal：正常挂机。
  • touchRouteError：队列挂机。
  • touchInQueue：队列挂机。
  • touchInLoss：队列挂机。
  • userHangup：用户挂机，IVR 挂机。
  • sysHangup：系统挂机，IVR 挂机。
  • transferAgent：用户挂机，IVR 挂机。
  • dailing：客服挂机，振铃挂机。
  • TouchRingCallLoss：队列挂机，振铃挂机。
normal
Idstring否

通话详情全局唯一 ID。

acc1c58dab4a4****0e3813c66
AcidListarray否

会话 ID 列表。

string否

入呼后，websocket 中的 acid。

7719786
CallTypeListarray否

呼叫类型列表。

integer否

呼叫类型。取值：

  • 1：外呼。
  • 2：入呼。
  • 3：转交。
1
GroupIdListarray否

技能组 ID 列表。

long否

技能组 ID。

123456
CallingNumberListarray否

主叫号码列表。

string否

主叫号码。

0571773****
CalledNumberListarray否

被叫号码列表。

string否

被叫号码。

135615****
MemberIdListarray否

会员列表。

string否

会员 ID。

7856876
ServicerIdListarray否

坐席列表。

string否

坐席 ID。

555555
CallResultListarray否

呼叫结果列表。

string否

呼叫结果。取值：

  • normal：正常通话结束 。
  • queueClose： 队列挂机 。
  • dailingClose：振铃挂机 。
  • ivrClose：IVR 挂机。
normal

返回参数

名称类型描述示例值
object

result

Messagestring

状态码描述。

xxxx
RequestIdstring

请求 ID。

EE339D98-9BD3-4413-B165
Dataobject

通话数据。

TotalCountinteger

总共记录数。

26
PageSizeinteger

每页的数量。

10
PageNumberinteger

当前页。

1
CallDetailRecordarray<object>

通话记录。

CallDetailRecordobject

通话记录信息。

GroupNamestring

技能组名称。

说明 当 CallType 取值为 1 时，外呼场景无技能组信息。
自动化技能组
CallResultstring

呼叫结果。取值：

  • normal：正常挂机。
  • touchRouteError：队列挂机。
  • touchInQueue：队列挂机。
  • touchInLoss：队列挂机。
  • userHangup：用户挂机，IVR 挂机。
  • sysHangup：系统挂机，IVR 挂机。
  • transferAgent：用户挂机，IVR 挂机。
  • dailing：客服挂机，振铃挂机。
  • TouchRingCallLoss：队列挂机，振铃挂机。
normal
CalledNumberstring

被叫号码。

135615*****
Acidstring

会话 ID。入呼后，websocket 中的 acid。

7719786
CallTypeinteger

呼叫类型。取值：

  • 1：外呼
  • 2：入呼
  • 3：转交
1
QueueUpContinueTimeinteger

排队时长。

4
PassiveTransferIdstring

坐席 ID。转交电话号码。

说明 非转交场景数据为 Null。
12
CallingNumberstring

发起方号码。例如用户手机号码、客服坐席号码、机器号码等。

0571773
MemberIdstring

会员 ID。

7856876
ServicerNamestring

坐席名称。

说明 呼入场景未分配到到坐席之前无坐席信息。
刘测试
OutQueueTimestring

热线分配出队时间。

说明 外呼场景无出队时间。
2020-10-02 22:32:59
RingEndTimestring

振铃结束时间。

说明 外呼场景无振铃结束时间。
2020-10-02 22:33:09
PickUpTimestring

接起时间。

2020-10-02 22:33:09
EvaluationLevelinteger

满意度，评价星级。取值：

  • 2：二级满意度
  • 3：三级满意度
  • 4：四级满意度
  • 5：五级满意度
说明 外呼场景和未接通场景无数据。
4
RingContinueTimeinteger

振铃时长。单位：秒。

说明 外呼场景无振铃时间。
10
PassiveTransferIdTypestring

会话被转交方。取值：

  • 1：坐席 ID。
  • 2：转交电话号码。
说明 非转交场景数据为 Null
1
EvaluationScoreinteger

满意度-评价得分。取值：

  • 1：非常不满意
  • 2：不满意
  • 3：一般
  • 4：满意
  • 5：非常满意
说明 外呼场景和未接通场景无数据。
4
CreateTimestring

通话创建时间。

说明
  • 外呼场景为外呼发起时间。
    •
    • 入呼场景为通话进入 ACC 系统时间。
    		2020-10-02 22:32:55
    HangUpTimestring

    挂断时间。

    		2020-10-02 22:33:46
    GroupIdlong

    技能组 ID。

    说明 当 CallType 取值为 1 时，外呼场景无技能组信息。
    		123456
    InQueueTimestring

    热线分配-入队时间。

    说明 外呼场景无入队时间。
    		2020-10-02 22:32:55
    RingStartTimestring

    振铃开始时间。

    说明 外呼场景无振铃开始时间。
    		2020-10-02 22:32:59
    CallContinueTimeinteger

    通话时长。单位：秒。

    说明 未接通场景无通话时长。
    		37
    ActiveTransferIdstring

    坐席 ID。

    说明 非转交场景数据为 Null。
    		12
    HangUpRolestring

    挂机方。取值：

    • 1：系统挂机
    • 2：客户挂机
    • 3：客服挂机
    • null：未知
    		2
    MemberNamestring

    会员名称。

    		匿名会员
    Idstring

    通话详情全局唯一 ID。

    		acc1c58dab4a4dd280e3813c66
    ServicerIdstring

    坐席 ID。

    说明 呼入场景未分配到到坐席之前无坐席信息。
    		555555
    TrunkCallstring

    长途电话。

    		1861111****
    Codestring

    状态码。返回 Success 表示请求成功。

    		Success
    Successboolean

    接口调用是否成功。

    		true

    示例

    正常返回示例

    JSON格式

    {
  "Message": "xxxx",
  "RequestId": "EE339D98-9BD3-4413-B165",
  "Data": {
    "TotalCount": 26,
    "PageSize": 10,
    "PageNumber": 1,
    "CallDetailRecord": [
      {
        "GroupName": "自动化技能组",
        "CallResult": "normal",
        "CalledNumber": "135615*****",
        "Acid": 7719786,
        "CallType": 1,
        "QueueUpContinueTime": 4,
        "PassiveTransferId": 12,
        "CallingNumber": "0571773",
        "MemberId": 7856876,
        "ServicerName": "刘测试",
        "OutQueueTime": "2020-10-02 22:32:59",
        "RingEndTime": "2020-10-02 22:33:09",
        "PickUpTime": "2020-10-02 22:33:09",
        "EvaluationLevel": 4,
        "RingContinueTime": 10,
        "PassiveTransferIdType": 1,
        "EvaluationScore": 4,
        "CreateTime": "2020-10-02 22:32:55",
        "HangUpTime": "2020-10-02 22:33:46",
        "GroupId": 123456,
        "InQueueTime": "2020-10-02 22:32:55",
        "RingStartTime": "2020-10-02 22:32:59",
        "CallContinueTime": 37,
        "ActiveTransferId": 12,
        "HangUpRole": 2,
        "MemberName": "匿名会员",
        "Id": "acc1c58dab4a4dd280e3813c66",
        "ServicerId": 555555,
        "TrunkCall": "1861111****"
      }
    ]
  },
  "Code": "Success",
  "Success": true
}

    错误码

    访问错误中心查看更多错误码。

    变更历史

    变更时间变更内容概要操作
    暂无变更历史
    上一篇：通话详情下一篇：GetRecordData - 获取录音文件