查询当前会话客户的最近历史接触记录(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 }