文档首页/ 云客服/ API参考/ 座席工作台/ 座席双呼/ 查询当前会话客户的最近历史接触记录(queryUserContactLimit)
更新时间:2024-08-02 GMT+08:00

查询当前会话客户的最近历史接触记录(queryUserContactLimit)

场景描述

根据callId和userId查询当前会话的号码的最近历史接触记录,最多查询4条记录,需要该callId对应的会话在通话中,未在通话中的callId返回空列表。

接口方法

POST

接口URI

https://域名/apiaccess/rest/workbench/v1/queryUserContactLimit,例如域名是service.besclouds.com

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

X-APP-Key

string

False

appKey字段,用户标识

2

Authorization

string

True

鉴权字段,内容格式为:Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格)

表2 请求体参数

序号

名称

参数类型

是否必选

说明

1

callId

string

True

呼叫id

2

userId

string

True

用户id

3

tenantId

string

True

租户id

响应说明

  • 响应状态码: 200
表3 响应体参数

序号

名称

参数类型

是否必选

说明

1

callSerialno

string

False

呼叫流水号

2

countId

string

False

账号

3

callId

string

False

呼叫ID

4

mediaAbility

number

False

媒体类别:1: 语音 2:视频

5

channelType

number

False

多媒体渠道

6

talkReason

string

False

会话原因ID

7

beginTime

timestamp

False

开始时间

8

callType

number

False

呼叫类型

  • 响应状态码: 400

    错误的请求:请检查请求路径及参数。

  • 响应状态码: 401

    未授权:1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。

  • 响应状态码: 404

    请求的内容未找到:请检查请求的路径。

  • 响应状态码: 500

    业务失败:请依次确认您请求中各参数的取值。

错误码

无。

报文样例

请求头:

x-app-key:9******************************3  
Authorization:Bearer 9******************************7 

请求参数:

{
	"callId": "1652317325-339",
	"userId": "1652268429538866153",
	"tenantId": "202205116084"
}

响应参数:

{
	"callSerialno": "1243353389979684865",
	"countId": "1652268429538866153",
	"callId": "1652317325-339",
	"mediaAbility": 1,
	"channelType": 1,
	"talkReason": "1300404704098042886,1300404506395329541",
	"beginTime": "2022-05-12 01:01:33",
	"callType": 1
}