调用QueryTouchList接口查询接触数据。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String QueryTouchList

系统规定参数。取值:QueryTouchList

InstanceId String ccc_xp_pre-cn-***

AICCS实例ID。可在智能联络中心控制台上获取。

FirstTimeStart Long 1614596400000

会话开始的时间范围左区间。时间戳格式(单位:毫秒)。

FirstTimeEnd Long 1614599400000

会话开始的时间范围右区间。时间戳格式(单位:毫秒)。

CloseTimeStart Long 1614600400000

会话结束的时间范围左区间。时间戳格式(单位:毫秒)。

CloseTimeEnd Long 1614600500000

会话结束的时间范围右区间。时间戳格式(单位:毫秒)。

PageSize Integer 100

每页数据量。

CurrentPage Integer 1

当前页码。

TouchId.N Long 10000

接触ID。

ChannelId.N String 846a7a4aa2524186b899a6ba02****

会话ID。

ChannelType.N Integer 1

渠道类型。取值:

  • 1:热线
  • 2:在线
TouchType.N Integer 2

接触类型。取值:

  • 1:主动接触(外呼)
  • 2:被动接触(咨询)
MemberId.N Long 1000

会员ID。

MemberName.N String zhangsan

会员名称。

ServicerId.N Long 70020

客服ID。

ServicerName.N String lisi

客服名称。

QueueId.N Long 10000

进线技能组ID。

EvaluationStatus.N Integer 0

评价状态。取值:

  • -1:未发起评价
  • 0:未评价
  • 1:已评价
EvaluationLevel.N Integer 5

满意度等级。取值:

  • 2:二级满意度
  • 3:三级满意度
  • 4:四级满意度
  • 5:五级满意度
EvaluationScore.N Integer 5

满意度评分。取值:

  • 1:很不满
  • 2:不满
  • 3:一般
  • 4:满意
  • 5:很满意

返回数据

名称 类型 示例值 描述
Code String 200

状态码。

Message String Success

状态码描述。

RequestId String xxx-xxxx-xxx

请求ID。

Success Boolean true

接口调用是否成功。

ResultData Object

数据结果。

TotalResults Integer 100

查询总量。

NextPage Integer 2

下一页页码。

CurrentPage Integer 1

当前页码。

TotalPage Integer 4

总页数。

PreviousPage Integer 2

上一页页码。

OnePageSize Integer 2

页大小。

Empty Boolean false

是否为空。

Data Array of Data

数据。

Status Integer 1

接触状态。取值:

  • 1:已进线
  • 2:小二已接入
  • 3:通话中
  • 4:已结束
ToId Long 678026

会话接受者。

ParentTouchId Long 0

父接触ID。

ServicerName String 13900001234

客服名称。

ChannelType Integer 1

接触渠道。

CloseTime Long 1611207976000

会话结束时间。时间戳格式(单位:毫秒)。

GmtModified Long 1611207979000

更新时间。时间戳格式(单位:毫秒)。

ServicerId Long 67****

客服ID。

SwitchUser String null

转交列表。

BuId Long 905

租户ID。

FromId Long 64006657978

会话发起者。

UserTouchId Long 1386****

用户接触ID。

TouchTime String 111

会话时长(单位:秒)。

TouchContent String 1

会话结束原因。取值:

  • 0:未知
  • 1:接触未成功
  • 2:客户终止
  • 3:坐席终止
  • 4:通话异常中断
  • 5:转交终止
  • 6:系统终止
Feedback String xxxx

反馈。

TouchId String 1386****

接触ID。

QueueId Long 111

技能组ID。

DepId Long 100

部门ID。

TouchEndReason Integer 2

结束原因。

MemberName String 访客

会员名称。

CommonQueueName String 测试1

技能组名称。

FirstTime Long 1611209971000

会话接起时间。时间戳格式(单位:毫秒)。

TouchType Integer 2

接触类型。取值:

  • 1:主动接触
  • 2:被动接触
GmtCreate Long 1611209971000

创建时间。时间戳格式(单位:毫秒)。

ChannelId String 4f8807a9de024507a3090b5b66a8****

会话ID。

MemberId Long 6400665****

会员ID。

ExtAttrsString Map

大字段。

ExtAttrs Object

扩展字段。

EvaluationScore Integer 1

满意度评分。取值:

  • 1:很不满
  • 2:不满
  • 3:一般
  • 4:满意
  • 5:很满意
EvaluationLevel Integer 2

满意度等级。取值:

  • 2:二级满意度
  • 3:三级满意度
  • 4:四级满意度
  • 5:五级满意度
EvaluationSolution Integer 0

评估解决方案。

Ani String 187****0000

入呼为主叫号码。

OnlineJoinRespInterval Integer 1

首次响应时长(单位:秒)。

OnlineSessionSource Integer 0

线上会话源。

EvaluationStatus Integer 1

评价状态。取值:

  • -1:未发起评价
  • 0:未评价
  • 1:已评价
Dnis String 05712688****

外呼为被叫号码,入呼为被叫号码。

OutCallRouteNumber String 05712688****

外呼为主叫号码。

示例

请求示例

http(s)://aiccs.aliyuncs.com/?Action=QueryTouchList
&InstanceId=ccc_xp_pre-cn-***
&TouchId=[10000]
&ChannelId=["846a7a4aa2524186b899a6ba02****"]
&ChannelType=[1]
&TouchType=[2]
&MemberId=[1000]
&MemberName=["zhangsan"]
&ServicerId=[70020]
&ServicerName=["lisi"]
&QueueId=[10000]
&EvaluationStatus=[0]
&EvaluationLevel=[5]
&EvaluationScore=[5]
&FirstTimeStart=1614596400000
&FirstTimeEnd=1614599400000
&CloseTimeStart=1614600400000
&CloseTimeEnd=1614600500000
&PageSize=100
&CurrentPage=1
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<QueryTouchListResponse>
    <Code>200</Code>
    <Message>Success</Message>
    <RequestId>xxx-xxxx-xxx</RequestId>
    <Success>true</Success>
    <ResultData>
        <TotalResults>100</TotalResults>
        <NextPage>2</NextPage>
        <CurrentPage>1</CurrentPage>
        <TotalPage>4</TotalPage>
        <PreviousPage>2</PreviousPage>
        <OnePageSize>2</OnePageSize>
        <Empty>false</Empty>
        <Data>
            <Status>1</Status>
            <ToId>678026</ToId>
            <ParentTouchId>0</ParentTouchId>
            <ServicerName>13900001234</ServicerName>
            <ChannelType>1</ChannelType>
            <CloseTime>1611207976000</CloseTime>
            <GmtModified>1611207979000</GmtModified>
            <SwitchUser>null</SwitchUser>
            <BuId>905</BuId>
            <FromId>64006657978</FromId>
            <TouchTime>111</TouchTime>
            <TouchContent>1</TouchContent>
            <Feedback>xxxx</Feedback>
            <TouchId>1386****</TouchId>
            <QueueId>111</QueueId>
            <DepId>100</DepId>
            <TouchEndReason>2</TouchEndReason>
            <MemberName>访客</MemberName>
            <CommonQueueName>测试1</CommonQueueName>
            <FirstTime>1611209971000</FirstTime>
            <TouchType>2</TouchType>
            <GmtCreate>1611209971000</GmtCreate>
            <ChannelId>4f8807a9de024507a3090b5b66a8****</ChannelId>
            <ExtAttrs>
                <EvaluationScore>1</EvaluationScore>
                <EvaluationLevel>2</EvaluationLevel>
                <EvaluationSolution>0</EvaluationSolution>
                <Ani>187****0000</Ani>
                <OnlineJoinRespInterval>1</OnlineJoinRespInterval>
                <OnlineSessionSource>0</OnlineSessionSource>
                <EvaluationStatus>1</EvaluationStatus>
                <Dnis>05712688****</Dnis>
                <OutCallRouteNumber>05712688****</OutCallRouteNumber>
            </ExtAttrs>
        </Data>
    </ResultData>
</QueryTouchListResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Code" : 200,
  "Message" : "Success",
  "RequestId" : "xxx-xxxx-xxx",
  "Success" : true,
  "ResultData" : {
    "TotalResults" : 100,
    "NextPage" : 2,
    "CurrentPage" : 1,
    "TotalPage" : 4,
    "PreviousPage" : 2,
    "OnePageSize" : 2,
    "Empty" : false,
    "Data" : {
      "Status" : 1,
      "ToId" : 678026,
      "ParentTouchId" : 0,
      "ServicerName" : 13900001234,
      "ChannelType" : 1,
      "CloseTime" : 1611207976000,
      "GmtModified" : 1611207979000,
      "SwitchUser" : "null",
      "BuId" : 905,
      "FromId" : 64006657978,
      "TouchTime" : 111,
      "TouchContent" : 1,
      "Feedback" : "xxxx",
      "TouchId" : "1386****",
      "QueueId" : 111,
      "DepId" : 100,
      "TouchEndReason" : 2,
      "MemberName" : "访客",
      "CommonQueueName" : "测试1",
      "FirstTime" : 1611209971000,
      "TouchType" : 2,
      "GmtCreate" : 1611209971000,
      "ChannelId" : "4f8807a9de024507a3090b5b66a8****",
      "ExtAttrs" : {
        "EvaluationScore" : 1,
        "EvaluationLevel" : 2,
        "EvaluationSolution" : 0,
        "Ani" : "187****0000",
        "OnlineJoinRespInterval" : 1,
        "OnlineSessionSource" : 0,
        "EvaluationStatus" : 1,
        "Dnis" : "05712688****",
        "OutCallRouteNumber" : "05712688****"
      }
    }
  }
}

错误码

HttpCode 错误码 错误信息 描述
500 SystemError A system error occurred. Please contact the administrator. 系统错误,请联系管理员!

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