# 查询签入技能队列座席详细信息 #### 前置条件 - 座席已签入 - 座席具有接听来话权限 #### 场景描述 座席签入后，根据签入的技能队列ID，返回签入该技能队列的座席详细信息。 ![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png) 若座席有不接来话的权限，则该接口查询结果不包含该座席。 #### 接口方法 设置成"GET"。该接口仅支持GET方法，不支持PUT、POST和DELETE等方法。 #### 接口URI https://ip:port/agentgateway/resource/agentgroup/{agentid}/agentbyskill/{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。 | #### 日志中的方法名 queryAgentInfoBySkillId #### 请求说明 - 消息头 表2请求头参数说明 | 序号 | 名称 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | Content-Type | string | True | 消息主体编码方式，缺省值：application/json;charset=UTF-8 | | 2 | Guid | string | True | 静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。 | - 消息体 表3消息体参数说明 | 序号 | 名称 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | agentLimit | int | False | 查询的座席数量限制，参数范围1\~500 说明： agentLimit和agentStatus必须同时传参，否则不会生效 | | 2 | agentStatus | array | False | 查询的座席的状态列表，状态见[表1](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0581.html#ZH-CN_TOPIC_0000002513073655__zh-cn_topic_0000002477949740_zh-cn_topic_0125397793_table50386983102738) | #### 响应说明 表4消息体参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 1 | message | string | 描述 | | 2 | retcode | string | 错误码。取值如下： 0：成功 非0：失败 | | 3 | result | list | 查询成功后，返回座席对象列表。 该对象的参数说明请参见[表5]。 | 表5result对象参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 3.1 | workno | string | 座席工号 | | 3.2 | name | string | 座席名称 | | 3.3 | status | int | 座席状态，参见[表1](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0581.html#ZH-CN_TOPIC_0000002513073655__zh-cn_topic_0000002477949740_zh-cn_topic_0125397793_table50386983102738) | | 3.4 | ctiStatus | int | 座席平台状态，请参考[表2](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0581.html#ZH-CN_TOPIC_0000002513073655__zh-cn_topic_0000002477949740_zh-cn_topic_0125397793_table7781496205751) | | 3.5 | groupid | int | 座席班组ID | | 3.6 | groupname | string | 未使用该返回参数 | | 3.7 | skilllist | list | 未使用该返回参数 | | 3.8 | callids | list | 未使用该返回参数 | | 3.9 | mediatype | string | 签入媒体服务器是否成功，T表示成功，F表示失败，三位分别表示CTIServer、WebM、MailM。只有签入CTIServer成功，才能进行音视频呼叫业务处理；只有签入WebM成功，才能进行文字交谈业务处理；当前不支持签入MailM。 | | 3.10 | vdnid | int | 所属VDN ID | | 3.11 | phonenumber | string | 座席电话号码 | | 3.12 | currentstatetime | long | 当前状态时长（秒） | | 3.13 | logindate | long | 签入时间，时间戳（毫秒） | | 3.14 | inMultimediaConf | int | 未使用该返回参数 | | 3.15 | currentStateReason | int | 当前状态原因码 | | 3.16 | preRestFlag | boolean | 标识座席是否预休息。 - true：预休息状态 - false：非预休息状态 说明： 组网为全容器化时，由于容器化CTI不支持，所以容器化CC-Gateway也不支持。 | | 3.17 | preBusyFlag | boolean | 标识座席是否预示忙。 - true：预示忙状态 - false：非预示忙状态 说明： 组网为全容器化时，由于容器化CTI不支持，所以容器化CC-Gateway也不支持。 | | 3.18 | isSupportTargetMedia | boolean | 是否支持目标媒体类型。 - true：支持 - false：不支持 | #### 触发事件 - 无 #### 错误结果码 - 100-006 - 100-007 - 300-002 - 100-019 #### 报文样例 - 消息头 ``` Content-Type:application/json;charset=UTF-8 Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 ``` - 请求参数 ``` { "agentLimit":1, "agentStatus":[4,7] } ``` - 响应参数 ``` { "message": "", "retcode": "0", "result": [ { "workno": "20011", "name": "20011", "status": "4", "ctiStatus": "1", "groupid": 1, "groupname": null, "skilllist": [], "mediatype": "TTT", "vdnid": 6, "phonenumber": "70942", "currentstatetime": 1376, "logindate": 1501125758000, "callids": [], "inMultimediaConf": 0, "currentStateReason": 0, "perRestFlag": false, "perBusyFlag": false, "isSupportTargetMedia": false } ] } ```