# 查询指定座席详细座席信息 #### 前置条件 - 座席已签入 #### 场景描述 座席签入后，根据座席工号，查询指定座席详细座席信息。 #### 接口方法 设置成"GET"。该接口仅支持GET方法，不支持PUT、POST和DELETE等方法。 #### 接口URI https://ip:port/agentgateway/resource/agentgroup/{agentid}/agentbyworkno/{workno} ![](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 | workno | string | True | 待查询的座席工号，取值范围：101～999999。 该座席工号必须与前面agentid为同一vdn下面的座席。 | #### 日志中的方法名 queryAgentInfoByWorkNo #### 请求说明 - 消息头 表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 | object | 查询成功后，返回座席对象列表。 该对象的参数说明请参见[表4]。 | 表4result对象参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 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 | 座席技能对象列表 该对象的参数说明请参见[表5]。 | | 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 | 是否在多媒体会议中。 0表示不在多媒体会议中。 1表示在多媒体会议中。 | | 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：不支持 | 表5skilllist对象参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 3.7.1 | name | string | 技能名称 | | 3.7.2 | id | int | 技能ID | | 3.7.3 | mediatype | int | 媒体类型。其中： - 1：文字交谈 - 2：点击通话 - 4：回呼请求 - 5：普通音视频电话 - 15：预测呼出 - 16：预浏览呼出 - 17：消息呼叫 - 19：视频普通呼叫 - 51：多媒体Web Chat - 53：Social Chat | #### 触发事件 - 无 #### 错误结果码 - 100-006 - 100-007 #### 报文样例 - 消息头 ``` Content-Type:application/json;charset=UTF-8 Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 ``` - 请求参数 无 - 响应参数 ``` { "message": "", "retcode": "0", "result": { "workno": "20011", "name": "20011", "status": "4", "ctiStatus": "1", "groupid": 1, "groupname": "jst", "skilllist": [ { "name": "clicktodial_jst", "id": 10, "mediatype": 2 }, { "name": "callback", "id": 2, "mediatype": 4 }, { "name": "webchat", "id": 3, "mediatype": 1 }, { "name": "email", "id": 4, "mediatype": 6 }, { "name": "voice_hym", "id": 5, "mediatype": 5 }, { "name": "voice", "id": 6, "mediatype": 5 }, { "name": "webchat_jst", "id": 9, "mediatype": 1 } ], "mediatype": "TTT", "vdnid": 6, "phonenumber": "70942", "currentstatetime": 1210, "logindate": 1501125758000, "callids": [], "inMultimediaConf": 0, "currentStateReason": 0, "perRestFlag": false, "perBusyFlag": false, "isSupportTargetMedia": false } } ```