查询指定座席私有呼叫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 } }