QueryTouchList - 查询接触数据-阿里云帮助中心

根据实例、接触ID列表、会话ID列表等查询接触数据。

接口说明

此接口可查询接触状态、会话接受者、客服名称、接触渠道、满意度评分、评价状态等接触数据，详情可查看返回参数。

QPS 限制

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

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

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	AICCS 实例 ID。您可以在智能联络中心控制台左侧导航栏的实例管理中获取。	ccc_xp_pre-cn-***
TouchId	array	否	要精确查询的接触 ID 列表。
	long	否	接触 ID。	10****
ChannelId	array	否	要精确查询的会话 ID 列表。
	string	否	会话 ID。	846a7a4aa2524186b899a6ba02****
ChannelType	array	否	渠道类型。
	integer	否	渠道类型。取值： 1：热线。 2：在线。	1
TouchType	array	否	接触类型。
	integer	否	接触类型。取值： 1：主动接触（外呼）。 2：被动接触（咨询）。	2
MemberId	array	否	要查询的会员 ID 列表。
	long	否	会员 ID。	1000
MemberName	array	否	要查询的会员名称列表。
	string	否	会员名称。	zhangsan
ServicerId	array	否	要查询的客服 ID 列表。
	long	否	客服 ID。	70020
ServicerName	array	否	要查询的客服名称列表。
	string	否	客服名称。	lisi
QueueId	array	否	进线技能组 ID 列表。
	long	否	进线技能组 ID。	10000
EvaluationStatus	array	否	评价状态。
	integer	否	评价状态。取值： -1：未发起评价。 0：未评价。 1：已评价。	0
EvaluationLevel	array	否	满意度等级。
	integer	否	满意度等级。取值： 2：二级满意度。 3：三级满意度。 4：四级满意度。 5：五级满意度。	5
EvaluationScore	array	否	满意度评分。
	integer	否	满意度评分。取值： 1：很不满。 2：不满。 3：一般。 4：满意。 5：很满意。	5
FirstTimeStart	long	否	会话开始的时间范围左区间。时间戳格式（单位：毫秒）。	1614596400000
FirstTimeEnd	long	否	会话开始的时间范围右区间。时间戳格式（单位：毫秒）。	1614599400000
CloseTimeStart	long	否	会话结束的时间范围左区间。时间戳格式（单位：毫秒）。	1614600400000
CloseTimeEnd	long	否	会话结束的时间范围右区间。时间戳格式（单位：毫秒）。	1614600500000
PageSize	integer	否	每页大小。取值大于 0，默认值：20。	20
CurrentPage	integer	否	当前页。取值大于 0，默认值：1。	1

返回参数

名称	类型	描述	示例值
	object	返回数据。
ResultData	object	数据结果。
Empty	boolean	是否为空。	false
OnePageSize	integer	页大小。	2
TotalPage	integer	总页数。	4
CurrentPage	integer	当前页码。	1
PreviousPage	integer	上一页页码。	2
TotalResults	integer	查询总量。	100
Data	array<object>	数据。
Data	object	返回数据。
ParentTouchId	long	父接触 ID。	0
DepId	long	部门 ID。	100
GmtModified	long	更新时间。时间戳格式（单位：毫秒）。	1611207979000
UserTouchId	long	用户接触 ID。	1386****
CommonQueueName	string	技能组名称。	测试1
ChannelId	string	会话 ID。	4f8807a9de024507a3090b5b66a8****
TouchId	string	接触 ID。	1386****
MemberId	long	会员 ID。	6400665****
ServicerName	string	客服名称。	1390000****
Feedback	string	反馈。	xxxx
TouchType	integer	接触类型。取值： 1：主动接触。 2：被动接触。	2
Status	integer	接触状态。取值： 1：已进线。 2：小二已接入。 3：通话中。 4：已结束。	1
SwitchUser	string	转交列表。	null
FirstTime	long	会话接起时间。时间戳格式（单位：毫秒）。	1611209971000
FromId	long	会话发起者。	6400665****
QueueId	long	技能组 ID。	111
ExtAttrsString	object	大字段。
TouchTime	string	会话时长（单位：秒）。	111
ToId	long	会话接受者。	67****
BuId	long	租户 ID。	905
GmtCreate	long	创建时间。时间戳格式（单位：毫秒）。	1611209971000
CloseTime	long	会话结束时间。时间戳格式（单位：毫秒）。	1611207976000
ExtAttrs	object	扩展字段。
EvaluationScore	integer	满意度评分。取值： 1：很不满。 2：不满。 3：一般。 4：满意。 5：很满意。	1
OnlineJoinRespInterval	integer	首次响应时长（单位：秒）。	1
Dnis	string	外呼为被叫号码，入呼为被叫号码。	05712688****
OnlineSessionSource	integer	线上会话源。	0
EvaluationStatus	integer	评价状态。取值： -1：未发起评价。 0：未评价。 1：已评价。	1
EvaluationLevel	integer	满意度等级。取值： 2：二级满意度。 3：三级满意度。 4：四级满意度。 5：五级满意度。	2
OutCallRouteNumber	string	外呼为主叫号码。	05712688****
Ani	string	入呼为主叫号码。	187****0000
EvaluationSolution	integer	评估解决方案。	0
TouchEndReason	integer	结束原因。	2
MemberName	string	会员名称。	访客
ServicerId	long	客服 ID。	67****
ChannelType	integer	接触渠道。	1
TouchContent	string	会话结束原因。取值： 0：未知。 1：接触未成功。 2：客户终止。 3：坐席终止。 4：通话异常中断。 5：转交终止。 6：系统终止。	1
NextPage	integer	下一页页码。	2
Message	string	状态码描述。	Success
RequestId	string	请求 ID。	865658FD-80DE-5D49-ABEB-F3CC9863F4F1
Code	string	状态码。	200
Success	boolean	调用接口是否成功。取值： true：成功。 false：失败。	true

示例

正常返回示例

JSON格式

{
  "ResultData": {
    "Empty": false,
    "OnePageSize": 2,
    "TotalPage": 4,
    "CurrentPage": 1,
    "PreviousPage": 2,
    "TotalResults": 100,
    "Data": [
      {
        "ParentTouchId": 0,
        "DepId": 100,
        "GmtModified": 1611207979000,
        "UserTouchId": 0,
        "CommonQueueName": "测试1",
        "ChannelId": "4f8807a9de024507a3090b5b66a8****",
        "TouchId": "1386****",
        "MemberId": 0,
        "ServicerName": "1390000****",
        "Feedback": "xxxx",
        "TouchType": 2,
        "Status": 1,
        "SwitchUser": "null",
        "FirstTime": 1611209971000,
        "FromId": 0,
        "QueueId": 111,
        "ExtAttrsString": {
          "test": "test",
          "test2": 1
        },
        "TouchTime": "111",
        "ToId": 0,
        "BuId": 905,
        "GmtCreate": 1611209971000,
        "CloseTime": 1611207976000,
        "ExtAttrs": {
          "EvaluationScore": 1,
          "OnlineJoinRespInterval": 1,
          "Dnis": "05712688****",
          "OnlineSessionSource": 0,
          "EvaluationStatus": 1,
          "EvaluationLevel": 2,
          "OutCallRouteNumber": "05712688****",
          "Ani": "187****0000",
          "EvaluationSolution": 0
        },
        "TouchEndReason": 2,
        "MemberName": "访客",
        "ServicerId": 0,
        "ChannelType": 1,
        "TouchContent": "1"
      }
    ],
    "NextPage": 2
  },
  "Message": "Success",
  "RequestId": "865658FD-80DE-5D49-ABEB-F3CC9863F4F1",
  "Code": "200",
  "Success": true
}

错误码

HTTP status code	错误码	错误信息	描述
500	SystemError	A system error occurred. Please contact the administrator.	系统错误，请联系管理员！

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

变更历史

变更时间	变更内容概要	操作

暂无变更历史