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

查询指定callId的呼叫基本信息

场景描述

查询指定callId的呼叫的基本信息。(CTI3.6版本不可用)

接口方法

设置成“POST”。该接口仅支持POST方法,不支持PUT、GET和DELTE等方法。

内部封装接口

BMS接口:/ccbms/ws/monitor/querybasecallinfo

请求URL

https://ip:port/rest/cmsapp/v1/openapi/calldata/querybasiccallinfo

其中,公有云环境请联系管理员获取,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

呼叫callId,最大长度20。

参数值为时间戳-呼叫编号,其中时间戳为呼叫开始时间,必须为毫秒级时间戳。

例如:1659513159000-546750

响应消息

表3 消息体参数说明

参数名

数据类型

说明

result

String

查询结果。取值如下:

  • 0:成功
  • 其他:失败

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

说明:

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

resultCode

string

查询结果。取值如下:

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

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

resultDatas

Object

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

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

说明:

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

resultDesc

Object

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

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

表4 resultDesc/resultDatas对象参数说明

参数名

数据类型

说明

time

Date

呼叫进入平台的时间。单位为毫秒。

dsn

int

标识呼叫的任务号。

handle

int

呼叫任务的控制块被循环使用的次数。

server

int

处理呼叫的媒体服务器的标识。

keyId

string

呼叫的唯一标识

callingNum

string

主叫号码

calledNum

string

被叫号码

mid

int

UAP模块号

trunkNo

int

中继号

priority

int

用户级别

deviceType

int

正在处理的设备类型,请参见表1

deviceNo

int

正在处理的设备编号。

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

callSkill

int

技能队列描述

partyNum

int

呼叫轨迹经过的设备数目

callFeature

int

呼叫特征,请参见表1

orgiCalledNum

int

原始被叫

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

mediaType

int

媒体类型,请参见表1

place

int

用户所在的位置(呼叫进入的地点)

waitTime

long

排队等待时间

totalTalkingTimes

long

通话时长

logonTimes

long

进入总时长

serviceType

int

业务类型

callInCause

int

呼入原因

enterReason

int

进入本设备的原因,请参见表1

mediaBillType

string

多媒体报表类型。

样例报文

  • 请求头:
    Content-Type: application/json;charset=UTF-8
    Authorization: ******************
  • 请求参数:
    {   
        "ccId":1,
        "vdn":1,
        "callId":"1453723531-574" 
    }
  • 响应消参数:
    {
        "result": "0",
        "resultCode": "0100000",
        "resultDatas": {
            "time": 1606115215000,
            "dsn": 0,
            "handle": 0,
            "server": 0,
            "keyId": "",
            "callingNum": "88881364",
            "calledNum": "650550",
            "mid": 5,
            "trunkNo": 582,
            "priority": 0,
            "deviceType": 2,
            "deviceNo": 1177,
            "callSkill": "defaultAudioSkill",
            "partyNum": 1,
            "callFeature": 0,
            "orgiCalledNum": "",
            "mediaType": 5,
            "place": 0,
            "waitTime": 0,
            "totalTalkingTimes": 275,
            "logonTimes": 284,
            "serviceType": 2,
            "callInCause": 65535,
            "enterReason": 0,
            "mediaBillType":0
        },
        "resultDesc": {
            "time": 1606115215000,
            "dsn": 0,
            "handle": 0,
            "server": 0,
            "keyId": "",
            "callingNum": "88881364",
            "calledNum": "650550",
            "mid": 5,
            "trunkNo": 582,
            "priority": 0,
            "deviceType": 2,
            "deviceNo": 1177,
            "callSkill": "defaultAudioSkill",
            "partyNum": 1,
            "callFeature": 0,
            "orgiCalledNum": "",
            "mediaType": 5,
            "place": 0,
            "waitTime": 0,
            "totalTalkingTimes": 275,
            "logonTimes": 284,
            "serviceType": 2,
            "callInCause": 65535,
            "enterReason": 0,
            "mediaBillType":0
        }
    }