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

Codestring

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

Success
Messagestring

状态码描述。

xxxx
RequestIdstring

请求 ID。

EE339D98-9BD3-4413-B165
Successboolean

接口调用是否成功。

true
Dataobject

通话数据。

PageSizeinteger

每页的数量。

10
PageNumberinteger

当前页。

1
TotalCountinteger

总共记录数。

26
CallDetailRecordarray<object>

通话记录。

CallDetailRecordobject

通话记录信息。

CallResultstring

呼叫结果。取值：

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

长途电话。

1861111****
ServicerNamestring

坐席名称。

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

热线分配出队时间。

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

通话时长。单位：秒。

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

通话创建时间。

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

    接起时间。

    		2020-10-02 22:33:09
    RingContinueTimeinteger

    振铃时长。单位：秒。

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

    被叫号码。

    		135615*****
    ServicerIdstring

    坐席 ID。

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

    挂断时间。

    		2020-10-02 22:33:46
    EvaluationLevelinteger

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

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

    坐席 ID。转交电话号码。

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

    坐席 ID。

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

    挂机方。取值：

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

    会话被转交方。取值：

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

    会员名称。

    		匿名会员
    EvaluationScoreinteger

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

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

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

    		7719786
    RingStartTimestring

    振铃开始时间。

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

    呼叫类型。取值：

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

    技能组名称。

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

    技能组 ID。

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

    振铃结束时间。

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

    热线分配-入队时间。

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

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

    		0571773
    MemberIdstring

    会员 ID。

    		7856876
    QueueUpContinueTimeinteger

    排队时长。

    		4
    Idstring

    通话详情全局唯一 ID。

    		acc1c58dab4a4dd280e3813c66

    示例

    正常返回示例

    JSON格式

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

    错误码

    访问错误中心查看更多错误码。
    上一篇：通话详情下一篇：GetRecordData - 获取录音文件
    文档推荐