调用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:主动接触(ex:外呼)
  • 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:很满意

返回数据

名称 类型 示例值 描述
ResultData Object

数据结果。

TotalResults Integer 100

查询总量。

NextPage Integer 2

下一页页码。

CurrentPage Integer 1

当前页码。

Data Array of Data

数据。

Status Integer 1

接触状态。取值:

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

会话接受者。

ParentTouchId Long 0

父接触ID。

ServicerName String 13566615188

客服名称。

ChannelType Integer 1

接触渠道。

CloseTime Long 1611207976000

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

GmtModified Long 1611207979000

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

ServicerId Long 679011

客服ID。

SwitchUser String null

转交列表。

BuId Long 905

租户ID。

FromId Long 64006657978

会话发起者。

UserTouchId Long 13867962

用户接触ID。

TouchTime String 111

会话时长。单位:秒。

TouchContent String 1

会话结束原因。取值:

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

反馈。

TouchId String 13867962

接触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:被动接触
ChannelId String 4f8807a9de024507a3090b5b66a882c3

会话ID。

GmtCreate Long 1611209971000

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

MemberId Long 64006657978

会员ID。

ExtAttrs Object

扩展字段。

EvaluationScore Integer 1

满意度评分。取值:

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

满意度等级。取值:

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

评估解决方案。

OnlineSessionSource Integer 0

线上会话源。

OnlineJoinRespInterval Integer 1

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

EvaluationStatus Integer 1

评价状态。取值:

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

外呼为主叫号码。

Dnis String 05712688****

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

Ani String 187****0000

入呼为主叫号码。

TotalPage Integer 4

总页数。

PreviousPage Integer 2

上一页页码。

OnePageSize Integer 2

页大小。

Empty Boolean false

是否为空。

Message String Success

状态码描述。

RequestId String xxx-xxxx-xxx

请求ID。

Code String 200

状态码。

Success Boolean true

接口调用是否成功。

示例

请求示例

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

正常返回示例

XML格式

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

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

JSON格式

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

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

错误码

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