更新时间:2024-08-02 GMT+08:00

查询指定座席私有呼叫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 请求头参数

序号

名称

参数类型

是否必选

说明

1

Content-Type

String

True

固定填 application/json; charset=UTF-8。

2

Authorization

String

True

生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式

表2 消息体参数说明

参数名

数据类型

是否必选

说明

ccId

int

True

呼叫中心编号。取值范围:1~65535

vdn

int

True

虚拟呼叫中心编号。取值范围:1~5000

callId

string

True

呼叫ID,为指定座席的私有呼叫callId,最大长度20,获取方式参见查询指定座席的私有呼叫

响应消息

表3 消息体参数说明

参数名

数据类型

说明

result

String

查询结果。取值如下:

  • 0:成功
  • 其他:失败

失败的原因说明请参见错误码参考

说明:

当前字段为兼容8.13及其之前版本接口响应参数使用。

resultCode

string

查询结果。取值如下:

  • "0100000":成功
  • 其他:失败

失败的原因说明请参见错误码参考

resultDatas

Object

查询成功后,返回结果信息的对象。

该数组中对象的参数说明请参见表4

说明:

当前字段为兼容8.13及其之前版本接口响应参数使用。

resultDesc

Object

查询成功后,返回结果信息的对象。

该对象的参数说明请参见表4

表4 resultDesc/resultDatas对象参数说明

参数名

数据类型

说明

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

设备号码。

  • 对于业务代表设备来说,设备号即为业务代表工号。
  • 对于队列或虚设备,设备号即为在配置台上配置的队列ID号或虚设备对应的网络共享设备ID号
  • 对于其他设备类型,均为内部标识号

callData

string

呼叫数据。

callDataLen

int

呼叫数据的有效长度。

callSkill

string

呼叫技能描述

partyNum

int

呼叫轨迹经过的设备数目。

callFeature

string

呼叫特征,请参见表1

orgiCalledNum

string

原始被叫

呼叫在进入系统前被叫发生变化,则该参数记录的是首次被呼叫方的号码。

mediaType

string

呼叫的媒体类型,请参见表1

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",
            "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",
            "server": 0,
            "mid": 5,
            "priority": 0
        }
    }