文档首页/云客服/API参考/座席操作类接口参考/呼叫数据:calldata/查询指定技能队列排队等待呼叫信息
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

查询指定技能队列排队等待呼叫信息

查询指定技能队列排队等待呼叫信息

前置条件

  • 座席已签入
  • 座席非空闲态，用户拨打接入码处于排队状态

场景描述

座席签入后，查询指定公有技能队列的所有排队等待呼叫信息。

接口方法

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

接口URI

https://ip:port/agentgateway/resource/calldata/{agentid}/waitcallinfo/{skillid}

如果CC-Gateway单机部署，IP地址为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号，默认值为8043；如果CC-Gateway采用集群模式部署，IP请配置为NSLB地址， Port请配置为默认值8043。

NSLB上的CC-Gateway端口号，请以nslb用户登录任意一个NSLB节点，执行./nslbctl l查询，查询结果中，如下端口表示CC-Gateway通过NSLB面向第三方系统开放的端口。

SaaS场景下请咨询运维人员获取IP和Port。

表1 URI中携带的参数说明

序号

参数名

数据类型

选取原则

说明

1

agentid

string

True

座席的工号，取值范围：101～999999。

2

skillid

int

True

被查询技能队列ID。

日志中的方法名

queryWaitCallInfoBySkillId

请求说明

  • 消息头

    表2 请求头参数说明

    序号

    名称

    参数类型

    是否必选

    说明

    1

    Content-Type

    string

    True

    消息主体编码方式，缺省值：application/json; charset=UTF-8

    2

    Guid

    string

    True

    静态鉴权（AUTHMODE =1）签入接口返回的Guid；动态鉴权（AUTHMODE =2）轮询事件接口返回的Guid。

  • 消息体

    无

响应说明

表3 消息体参数说明

序号

名称

参数类型

说明

1

message

string

描述

2

retcode

string

错误码。取值如下：

0：成功

非0：失败

3

result

list

查询成功后，返回排队等待呼叫信息对象列表。

该对象的参数说明请参考表4。

表4 result对象参数说明

序号

名称

参数类型

说明

3.1

callfeature

int

呼叫类型，请参考呼叫类型

3.2

callid

string

呼叫ID

3.3

caller

int

主叫号码

3.4

called

int

被叫号码

3.5

callskill

string

呼叫技能描述

3.6

callskillid

int

呼叫技能ID

3.7

orgicallednum

string

未使用该返回参数

3.8

calldata

string

随路数据

3.9

begintime

long

应答开始时间，时间戳（毫秒）

3.10

endtime

long

未使用该返回参数

3.11

userPriority

int

客户级别

3.12

trunkNo

int

中继号

3.13

logontimes

int

进入总时长（秒）。

3.14

mediaType

int

媒体类型。其中：

  • 1：文字交谈
  • 2：点击通话
  • 4：回呼请求
  • 5：普通音视频电话
  • 15：预测呼出
  • 16：预浏览呼出
  • 17：消息呼叫
  • 19：视频普通呼叫
  • 51：多媒体Web Chat
  • 53：Social Chat

3.15

mediaAbility

int

媒体能力。其中：

  • 1：音频
  • 2：视频
  • 3：音视频

3.16

waitTime

long

等待应答时间，时间戳（秒）

3.17

trace

HWCallDeviceTraceEx

呼叫轨迹扩展属性，预留字段，默认为空。

触发事件

  • 无

错误结果码

  • 100-006

  • 100-007

报文样例

  • 消息头 
    Content-Type:application/json; charset=UTF-8
Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
  • 请求参数

    无

  • 响应参数 
    {
    "message": "",
    "retcode": "0",
    "result": [
        {
            "callfeature": 0,
            "callid": "1476707884-279",
            "caller": "70004",
            "called": "60015",
            "callskill": "voice",
            "callskillid": 1,
            "orgicallednum": "",
            "calldata": "",
            "begintime": 1476707884000,
            "endtime": null,
            "userPriority": 0,
            "mediaType": 5,
            "mediaAbility": 1,
            "waitTime": 0,
            "trace": null
        },
        {
            "callfeature": 0,
            "callid": "1476707885-280",
            "caller": "70003",
            "called": "60015",
            "callskill": "voice",
            "callskillid": 1,
            "orgicallednum": "",
            "calldata": "",
            "begintime": 1476707885000,
            "endtime": null,
            "userPriority": 0,
            "trunkNo": 65535,
            "logontimes": 0,
            "mediaType": 5,
            "mediaAbility": 1,
            "waitTime": 0,
            "trace": null
        }
    ]
}