使用HotlineSessionQuery接口批量查询通话详情-智能联络中心-阿里云-智能联络中心(AICCS)-阿里云帮助中心

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

接口说明

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

QPS 限制

单用户调用频率：不限流。
API 频率：80 次/秒。

说明

如果多个用户的总调用超过 API 频率也会触发流控。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

aiccs:HotlineSessionQuery

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	AICCS 实例 ID。您可以在智能联络中心控制台左侧导航栏的实例管理中获取。	ccc_xp_pre-cn-***
Acid	string	否	会话 ID。入呼后，websocket 中的 acid。	7719786****
CallType	integer	否	电话类型。取值： 1：外呼。 2：入呼。 3：转交。	1
CalledNumber	string	否	发起方号码。例如用户手机号码、客服坐席号码、机器号码等。	135615****
CallingNumber	string	否	接听方号码。例如用户手机号码、客服坐席号码、机器号码等。	057177****
GroupId	integer	否	技能组 ID。	123456
GroupName	string	否	技能组名称。	自动化技能组
MemberId	string	否	会员 ID。	7856****
MemberName	string	否	会员名称。	匿名会员
QueryEndTime	integer	否	结束时间戳。单位：毫秒。	1614829721
QueryStartTime	integer	否	开始时间戳。单位：毫秒。	1614828721
RequestId	string	否	请求 ID。	EE338D98-9BD3-4413-B165
ServicerName	string	否	坐席名称。	刘测试
ServicerId	string	否	坐席 ID。	555555
Params	string	否	扩展参数。	xxxx
PageSize	integer	否	每页大小。取值大于 0，默认值：20。	10
PageNo	integer	否	当前页。取值大于 0，默认值：1。	1
CallResult	string	否	呼叫结果。取值： normal：正常挂机。 touchRouteError：队列挂机。 touchInQueue：队列挂机。 touchInLoss：队列挂机。 userHangup：用户挂机，IVR 挂机。 sysHangup：系统挂机，IVR 挂机。 transferAgent：用户挂机，IVR 挂机。 dailing：客服挂机，振铃挂机。 TouchRingCallLoss：队列挂机，振铃挂机。枚举值： normal : 正常通话结束 ivrClose : IVR 挂机 queueClose : 队列挂机 dailingClose : 振铃挂机	normal
Id	string	否	通话详情全局唯一 ID。	acc1c58dab4a4****0e3813c66
AcidList	array	否	会话 ID 列表。
	string	否	入呼后，websocket 中的 acid。	7719786
CallTypeList	array	否	呼叫类型列表。
	integer	否	呼叫类型。取值： 1：外呼。 2：入呼。 3：转交。	1
GroupIdList	array	否	技能组 ID 列表。
	integer	否	技能组 ID。	123456
CallingNumberList	array	否	主叫号码列表。
	string	否	主叫号码。	0571773****
CalledNumberList	array	否	被叫号码列表。
	string	否	被叫号码。	135615****
MemberIdList	array	否	会员列表。
	string	否	会员 ID。	7856876
ServicerIdList	array	否	坐席列表。
	string	否	坐席 ID。	555555
CallResultList	array	否	呼叫结果列表。
	string	否	呼叫结果。取值： normal：正常通话结束。 queueClose：队列挂机。 dailingClose：振铃挂机。 ivrClose：IVR 挂机。	normal

返回参数

名称	类型	描述	示例值
	object	result
Code	string	状态码。返回 Success 表示请求成功。	Success
Data	object	通话数据。
CallDetailRecord	array<object>	通话记录。
	object	通话记录信息。
Acid	string	会话 ID。入呼后，websocket 中的 acid。	7719786
ActiveTransferId	string	坐席 ID。说明非转交场景数据为 Null。	12
CallContinueTime	integer	通话时长。单位：秒。说明未接通场景无通话时长。	37
CallResult	string	呼叫结果。取值： normal：正常挂机。 touchRouteError：队列挂机。 touchInQueue：队列挂机。 touchInLoss：队列挂机。 userHangup：用户挂机，IVR 挂机。 sysHangup：系统挂机，IVR 挂机。 transferAgent：用户挂机，IVR 挂机。 dailing：客服挂机，振铃挂机。 TouchRingCallLoss：队列挂机，振铃挂机。	normal
CallType	integer	呼叫类型。取值： 1：外呼 2：入呼 3：转交	1
CalledNumber	string	被叫号码。	135615*****
CallingNumber	string	发起方号码。例如用户手机号码、客服坐席号码、机器号码等。	0571773
CreateTime	string	通话创建时间，格式：YYYY-MM-DD HH:mm:ss。说明外呼场景为外呼发起时间。入呼场景为通话进入 ACC 系统时间。	2020-10-02 22:32:55
EvaluationLevel	integer	满意度，评价星级。取值： 2：二级满意度 3：三级满意度 4：四级满意度 5：五级满意度说明外呼场景和未接通场景无数据。	4
EvaluationScore	integer	满意度-评价得分。取值： 1：非常不满意 2：不满意 3：一般 4：满意 5：非常满意说明外呼场景和未接通场景无数据。	4
GroupId	integer	技能组 ID。说明当 CallType 取值为 1 时，外呼场景无技能组信息。	123456
GroupName	string	技能组名称。说明当 CallType 取值为 1 时，外呼场景无技能组信息。	自动化技能组
HangUpRole	string	挂机方。取值： 1：系统挂机 2：客户挂机 3：客服挂机 null：未知	2
HangUpTime	string	挂机时间，格式：YYYY-MM-DD HH:mm:ss。	2020-10-02 22:33:46
Id	string	通话详情全局唯一 ID。	acc1c58dab4a4dd280e3813c66
InQueueTime	string	热线分配-入队时间，格式：YYYY-MM-DD HH:mm:ss。说明外呼场景无入队时间。	2020-10-02 22:32:55
MemberId	string	会员 ID。	7856876
MemberName	string	会员名称。	匿名会员
OutQueueTime	string	热线分配出队时间，格式：YYYY-MM-DD HH:mm:ss。说明外呼场景无出队时间。	2020-10-02 22:32:59
PassiveTransferId	string	坐席 ID。转交电话号码。说明非转交场景数据为 Null。	12
PassiveTransferIdType	string	会话被转交方。取值： 1：坐席 ID。 2：转交电话号码。说明非转交场景数据为 Null	1
PickUpTime	string	接听时间，格式：YYYY-MM-DD HH:mm:ss。	2020-10-02 22:33:09
QueueUpContinueTime	integer	排队时长。	4
RingContinueTime	integer	振铃时长。单位：秒。说明外呼场景无振铃时间。	10
RingEndTime	string	振铃结束时间，格式：YYYY-MM-DD HH:mm:ss。说明外呼场景无振铃结束时间。	2020-10-02 22:33:09
RingStartTime	string	振铃开始时间，格式：YYYY-MM-DD HH:mm:ss。说明外呼场景无振铃开始时间。	2020-10-02 22:32:59
ServicerId	string	坐席 ID。说明呼入场景未分配到到坐席之前无坐席信息。	555555
ServicerName	string	坐席名称。说明呼入场景未分配到到坐席之前无坐席信息。	刘测试
TrunkCall	string	长途电话。	1861111****
PageNumber	integer	当前页。	1
PageSize	integer	每页的数量。	10
TotalCount	integer	总共记录数。	26
Message	string	状态码描述。	xxxx
RequestId	string	请求 ID。	EE339D98-9BD3-4413-B165
Success	boolean	接口调用是否成功。	true

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

更多信息，参考变更详情。