# 查询指定技能队列排队等待呼叫信息 查询指定技能队列排队等待呼叫信息 #### 前置条件 - 座席已签入 - 座席非空闲态，用户拨打接入码处于排队状态 #### 场景描述 座席签入后，查询指定公有技能队列的所有排队等待呼叫信息。 #### 接口方法 设置成"GET"。该接口仅支持GET方法，不支持PUT、POST和DELETE等方法。 #### 接口URI https://ip:port/agentgateway/resource/calldata/{agentid}/waitcallinfo/{skillid} ![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png) 如果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面向第三方系统开放的端口。 ![](https://support.huaweicloud.com/api-ccfs-cec/figure/zh-cn_image_0000002204207349.png) SaaS场景下请咨询运维人员获取IP和Port。 表1URI中携带的参数说明 | 序号 | 参数名 | 数据类型 | 选取原则 | 说明 | |:---|:---|:---|:---|:---| | 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]。 | 表4result对象参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 3.1 | callfeature | int | 呼叫类型，请参考[呼叫类型](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0582.html#ZH-CN_TOPIC_0000002513233643) | | 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 } ] } ```