查询指定座席私有呼叫callId的详细呼叫信息
场景描述
查询指定callId的呼叫基本信息需要满足当前正在通话中的要求。
接口方法
设置成“POST”。该接口仅支持POST方法,不支持PUT、GET和DELTE等方法。
内部封装接口
BMS接口:/ccbms/ws/monitor/callinfo
请求URL
https://ip:port/rest/cmsapp/v1/openapi/calldata/querydetailcallinfo
其中,公有云环境请联系管理员获取,ip为CC-CMS服务器地址,port为CC-CMS服务器的HTTPS端口号。
非公有云环境如果配置了NSLB服务,ip请填写NSLB的服务器地址,port为CC-CMS服务在NSLB映射的HTTPS端口号。
请求说明
序号 | 名称 | 参数类型 | 是否必选 | 说明 |
|---|---|---|---|---|
1 | Content-Type | String | True | 固定填 application/json; charset=UTF-8。 |
2 | Authorization | String | True | 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 |
参数名 | 数据类型 | 是否必选 | 说明 |
|---|---|---|---|
ccId | int | True | 呼叫中心编号。取值范围:1~65535 |
vdn | int | True | 虚拟呼叫中心编号。取值范围:1~5000 |
callId | string | True | 呼叫ID,为指定座席的私有呼叫callId,最大长度20,获取方式参见查询指定座席的私有呼叫。 |
响应消息
参数名 | 数据类型 | 说明 |
|---|---|---|
result | String | 查询结果。取值如下:
失败的原因说明请参见错误码参考。 说明: 当前字段为兼容8.13及其之前版本接口响应参数使用。 |
resultCode | string | 查询结果。取值如下:
失败的原因说明请参见错误码参考。 |
resultDatas | Object | 查询成功后,返回结果信息的对象。 该数组中对象的参数说明请参见表4。 说明: 当前字段为兼容8.13及其之前版本接口响应参数使用。 |
resultDesc | Object | 查询成功后,返回结果信息的对象。 该对象的参数说明请参见表4 |
参数名 | 数据类型 | 说明 |
|---|---|---|
cb | long | 内部标识。 |
time | long | 呼叫进入平台的时间。 |
dsn | int | 标识呼叫的任务号。 |
handle | int | 呼叫任务的控制块被循环使用的次数。 |
server | int | 处理呼叫的媒体服务器的标识。 |
keyId | string | 呼叫的业务标识。 |
callingNum | string | 主叫号码。 |
calledNum | string | 被叫号码 |
mid | int | 模块号。 |
trunkNo | int | 中继号。 |
priority | int | 用户级别 |
deviceType | int | 设备类型,请参见表1 |
deviceNo | int | 设备号码。
|
callData | string | 呼叫数据。 |
callDataLen | int | 呼叫数据的有效长度。 |
callSkill | string | 呼叫技能描述 |
partyNum | int | 呼叫轨迹经过的设备数目。 |
callFeature | string | 呼叫特征,请参见表1 |
orgiCalledNum | string | 原始被叫 呼叫在进入系统前被叫发生变化,则该参数记录的是首次被呼叫方的号码。 |
mediaType | string | 呼叫的媒体类型,请参见表1 |
submediaType | string | 子媒体类型,取值范围:
|
place | int | 用户所在的位置(呼叫进入的地点)。 |
waitTime | long | 排队等待时间,单位秒(s) |
totalTalkingTimes | long | 通话时长,单位秒(s) |
logonTimes | long | 进入总时长,单位秒(s) |
样例报文
- 请求头:
Content-Type: application/json;charset=UTF-8 Authorization: ******************
- 请求参数:
{ "ccId":1, "vdn":1, "callId":"1453723531-574" }
- 响应参数:
{ "result": "0", "resultDatas": { "trunkNo": 582, "deviceType": 2, "deviceNo": 1177, "dsn": 49, "callData": "", "totalTalkingTimes": 116, "cb": 1, "keyId": "", "callingNum": "88881363", "calledNum": "650550", "orgiCalledNum": "", "callDataLen": 0, "callSkill": "defaultAudioSkill", "partyNum": 2, "callFeature": 0, "place": 0, "waitTime": 0, "logonTimes": 127, "handle": 0, "time": 1606120429, "mediaType": "MEDIA_TYPE_PHONE", "submediaType": "Email", "server": 0, "mid": 5, "priority": 0 }, "resultDesc": { "trunkNo": 582, "deviceType": 2, "deviceNo": 1177, "dsn": 49, "callData": "", "totalTalkingTimes": 116, "cb": 1, "keyId": "", "callingNum": "88881363", "calledNum": "650550", "orgiCalledNum": "", "callDataLen": 0, "callSkill": "defaultAudioSkill", "partyNum": 2, "callFeature": 0, "place": 0, "waitTime": 0, "logonTimes": 127, "handle": 0, "time": 1606120429, "mediaType": "MEDIA_TYPE_PHONE", "submediaType": "Email", "server": 0, "mid": 5, "priority": 0 } }

