文档

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
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"
          }
        ]
      }
    }

    错误码

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

    • 本页导读 (1)