文档首页/云客服/API参考/监控类接口参考/接口说明/实时数据查询类接口/VDN维度实时接口/查询指定VDN下的通话轨迹数据
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

查询指定VDN下的通话轨迹数据

场景描述

根据callId查询指定vdn的通话轨迹数据。

接口方法

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

请求URL

https://ip:port/rest/cmsapp/v1/openapi/vdn/querycalltracedetail

其中，公有云环境请联系管理员获取，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 请求消息体参数说明

序号

名称

参数类型

是否必选

说明

1

ccId

int

True

呼叫中心编号。

取值范围：1～65535

2

vdn

int

True

虚拟呼叫中心编号。

取值范围：1～5000

3

callId

string

True

呼叫ID

4

logDate

long

True

查询时间，用于解析月份，查询指定表；毫秒级时间戳

响应消息

表3 响应消息体参数说明

序号

名称

参数类型

说明

1

resultCode

string

查询结果。取值如下：

  • "0100000"：成功
  • 其他：失败
  • 失败的原因说明请参见错误码参考。

2

resultDesc

array<tbilllog>

查询成功后，返回结果信息的对象数组。

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

表4 resultDesc对象参数说明

序号

名称

参数类型

说明

2.1

callId

string

呼叫ID

2.2

mediaType

int

媒体类型，请参见表1

2.3

callIdNum

int

话单序号

对一个呼叫生成的多条话单的序号标识，从1开始表示第一条话单，最后一条话单以－1表示。

2.4

callerNo

string

主叫号码

2.5

calleeNo

string

被叫号码

2.6

waitBegin

long

等待开始时间，毫秒级时间戳

2.7

ackBegin

long

应答开始时间，毫秒级时间戳

2.8

callBegin

long

呼叫开始时间，毫秒级时间戳

2.9

callEnd

long

呼叫结束时间，毫秒级时间戳

2.10

subCcNo

int

呼叫中心在网络呼叫中心下的标识号

2.11

deviceType

int

处理呼叫的设备类型，请参见表1

2.12

deviceNo

string

呼叫当前处理设备的设备号

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

2.13

deviceIn

string

设备描述

2.14

callType

int

呼叫类型，请参见表1

2.15

releaseCause

int

呼叫释放原因码，请参见呼叫释放原因码

2.16

EnterReason

int

呼叫进入设备原因，请参见表1

2.17

LeaveReason

int

呼叫离开设备原因，请参见表1

2.18

CurrentSkillID

string

当前处理呼叫的技能队列的编号

2.19

subMediaType

int

子媒体类型，具体请参见表3。

样例报文

  • 请求头： 
    Content-Type: application/json;charset=UTF-8
Authorization: ******************
  • 请求参数： 
    {
    "ccId":1,
    "vdn":170,
    "callId": "1678978542-92",
    "logDate": "1615717765000"
}
  • 响应参数： 
    {
    "resultCode":"0100000",
    "resultDesc":
        [{
            "callId": "1678978542-92",
            "mediaType": "1",
            "subMediaType|: "1",
            "callIdNum": "-1",
            "callerNo": "80000888",
            "calleeNo": "624192",
            "waitBegin": "1615717765000",// 呼叫等待开始时间
            "ackBegin": "1615717765000",// 呼叫应答时间
            "callBegin": "1615717765000",// 通话开始时间
            "callEnd": "1615717765000",// 通话结束时间
            "subCcNo": "0",
            "deviceType": "1"，
            "deviceNo": "1",
            "deviceIn": "1",
            "callType": "1",
            "releaseCause": "1", // callIdNum=-1时有意义
            "EnterReason": "11",
            "LeaveReason": "11",
            "CurrentSkillID": "0"， // 当前处理呼叫的技能队列编号
             "mediaType":53,  // 媒体类型
             "subMediaType":1  // 子媒体类型
        }]
}