查询当前会话客户的最近历史接触记录(queryUserContactLimit)
场景描述
根据callId和userId查询当前会话的号码的最近历史接触记录,最多查询4条记录,需要该callId对应的会话在通话中,未在通话中的callId返回空列表。
接口方法
POST
接口URI
https://域名/apiaccess/rest/workbench/v1/queryUserContactLimit,例如域名是service.besclouds.com
请求说明
序号 | 名称 | 参数类型 | 是否必选 | 说明 |
|---|---|---|---|---|
1 | X-APP-Key | string | False | appKey字段,用户标识 |
2 | Authorization | string | True | 鉴权字段,内容格式为:Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格) |
序号 | 名称 | 参数类型 | 是否必选 | 说明 |
|---|---|---|---|---|
1 | callId | string | True | 呼叫id |
2 | userId | string | True | 用户id |
3 | tenantId | string | True | 租户id |
响应说明
- 响应状态码: 200
序号 | 名称 | 参数类型 | 是否必选 | 说明 |
|---|---|---|---|---|
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
} 
