查询座席详细信息列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| EnterpriseId |
integer |
是 |
呼叫中心 id |
7000002 |
| Qno |
string |
否 |
队列号；当 qno 不为空时，查询指定队列的所有座席记录 |
333 |
| Cnos |
string |
否 |
多个座席号以英文逗号分隔 最多支持 500 个座席 |
1111,2222 |
| Start |
integer |
否 |
从第几条开始；正整数，大于等于 0，默认 0 |
0 |
| Limit |
integer |
否 |
查询条数；正整数，大于 0，最大不能超过 1000，默认 10 |
10 |
| Active |
integer |
否 |
是否启用；正整数，只能是 0 或者 1，0 是停用，1 是启用 |
1 |
| Status |
integer |
否 |
是否在线；正整数，只能是 0 或者 1，0 是离线，1 是在线 |
1 |
| Order |
integer |
否 |
排序方式,按照创建时间排序；0 正序 1 倒序 |
0 |
| WebrtcUrlType |
integer |
否 |
webrtc 软电话返回地址；取值说明：0：企业默认 1：公网域名 2：专线域名 3：公网 IP 4：专线 IP |
1 |
| StartTime |
string |
否 |
创建时间起始时间点；取值说明："2019-10-11 00:00:00" |
2026-04-20 10:00:00 |
| EndTime |
string |
否 |
创建时间终止时间点；取值说明："2019-10-11 23:59:59" |
2026-04-20 12:00:00 |
| ReturnQueue |
integer |
否 |
是否返回绑定座席的队列信息；0:不返回 1:需要返回 默认值:1 |
10 |
| Name |
string |
否 |
通过座席名称检索；取值说明：前后缀模糊匹配 |
name |
| Comment |
string |
否 |
通过座席备注信息检索；取值说明：前缀模糊匹配 |
comment1 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| AccessDeniedDetail |
string |
访问被拒绝详细信息。 |
无 |
| RequestId |
string |
请求 ID。 |
F655A8D5-B967-440B-8683-DAD6FF8DE990 |
| Message |
string |
返回信息。 |
OK |
| Data |
object |
返回数据。 |
|
| Total |
integer |
总数 |
30 |
| Agents |
array<object> |
座席列表数组 |
|
|
array<object> |
|||
| Agent |
object |
座席信息 |
|
| Status |
string |
座席状态，0:离线，1：在线 |
1 |
| IsQualityCheck |
string |
是否开启座席质检；取值说明：0：不开启，1：开启，默认开启 |
1 |
| CallPower |
string |
呼叫权限，0：无限制，1：国内长途，2：国内本市，3：内部呼叫，默认无限制 |
0 |
| ObClid |
string |
外显号码 |
41008502 |
| Cno |
string |
座席工号 |
1111 |
| CreateTime |
string |
创建时间，格式: yyyy-MM-dd HH:mm:ss |
2026-04-20 10:00:00 |
| IbRecord |
string |
呼入是否录音，0：不录用，1：录音，默认录音 |
1 |
| BindTelType |
string |
电话类型，1:固话 2:手机 3:分机 4:软电话 |
1 |
| Wrapup |
string |
整理时间，秒数，默认 10 秒 |
10 |
| ObRecord |
string |
外呼是否录音，0：不录音，1：录音，默认录音 |
1 |
| EnterpriseId |
string |
企业编号 |
7000002 |
| Name |
string |
座席姓名 |
name1 |
| IsAsr |
string |
是否开启 ASR 转写：0：不开启，1：开启，默认不开启 |
1 |
| AgentType |
string |
座席类型，1：电话座席，2：电脑座席，默认电话座席 |
1 |
| Active |
string |
是否启用，0：停用，1：启用，默认启用 |
1 |
| ObClidType |
string |
外显规则 1：企业默认 2：随机 3：按区号 4：动态外显 |
1 |
| WebrtcUrlType |
string |
webrtc 软电话返回地址，0：企业默认 1：公网域名 2：专线域名 3：公网 IP 4：专线 IP |
0 |
| AreaCode |
string |
区号格式 |
010 |
| BindTel |
string |
座席绑定电话 |
41008502 |
| Id |
string |
座席 id |
133 |
| Power |
string |
1：班长席，0：普通座席，默认普通座席 |
1 |
| IsOb |
string |
是否允许外呼，0：不允许，1：允许，默认允许 |
1 |
| QueueList |
array<object> |
座席所属队列信息 |
|
|
object |
|||
| ServiceLevel |
integer |
服务水平秒数，低于此时间内接听的认为是高服务水平 |
5 |
| AnnounceSound |
integer |
播报固定语音 0 关闭 1 打开 |
1 |
| WrapupTime |
integer |
整理时间，取值范围 3-3600 秒 |
30 |
| MaxLen |
integer |
最大等待数，设置范围 0-999，0 表示不做任何限制 |
0 |
| Description |
string |
队列名 |
queue_name |
| AnnouncePosition |
integer |
位置播报 0 关闭 1 大于 announce_position_param 时播放 2 小于等于 announce_position_param 时播放 |
1 |
| AnnounceSoundFile |
string |
固定语音文件 |
voice_filexxxxx |
| CreateTime |
string |
创建时间，格式: yyyy-MM-dd HH:mm:ss |
2026-04-20 10:00:00 |
| QueueTimeout |
integer |
队列超时时间，取值范围 5-600 秒，默认 600 秒 |
600 |
| AnnounceSoundFrequency |
integer |
播放固定语音周期，秒数 |
17 |
| AnnouncePositionYouarenext |
integer |
是否播报'您是下一位',0 关闭，1 开启 |
1 |
| AnnouncePositionParam |
integer |
多余少余 n 个时播报，必须大于等于 2 |
4 |
| MemberTimeout |
integer |
座席超时时间，取值范围 20-60 秒，默认 25 秒 |
25 |
| Weight |
integer |
队列优先级，取值范围 1-10，数值越高，优先级越高 |
10 |
| JoinEmpty |
integer |
队列中为空时是否可以 join，取值：1：置忙 2：通话中 4：振铃 8：无效 16：整理 |
1 |
| EnterpriseId |
integer |
企业编号 |
7000002 |
| Qno |
string |
队列号 |
322 |
| MusicClass |
string |
等待语音 class |
class1 |
| Strategy |
string |
呼叫策略：rrordered:技能优先 rrmemory:轮选 fewestcalls:平均 random:随机 linear:顺序 leastrecent:最长空闲时间 |
rrordered |
| Id |
integer |
队列 id |
76 |
| Retry |
integer |
座席超时无应答,呼叫下一座席的延迟秒数 |
20 |
| SayAgentno |
boolean |
语音报号，true:播报，false:不播报 |
true |
| VipSupport |
integer |
是否支持 vip，1:支持，0:不支持 |
1 |
| AnnouncePositionFrequency |
integer |
位置播报周期，秒数 |
10 |
| Code |
string |
请求状态码。
|
OK |
示例
正常返回示例
JSON格式
{
"AccessDeniedDetail": "无",
"RequestId": "F655A8D5-B967-440B-8683-DAD6FF8DE990",
"Message": "OK",
"Data": {
"Total": 30,
"Agents": [
{
"Agent": {
"Status": "1",
"IsQualityCheck": "1",
"CallPower": "0",
"ObClid": "41008502",
"Cno": "1111",
"CreateTime": "2026-04-20 10:00:00",
"IbRecord": "1",
"BindTelType": "1",
"Wrapup": "10",
"ObRecord": "1",
"EnterpriseId": "7000002",
"Name": "name1",
"IsAsr": "1",
"AgentType": "1",
"Active": "1",
"ObClidType": "1",
"WebrtcUrlType": "0",
"AreaCode": "010",
"BindTel": "41008502",
"Id": "133",
"Power": "1",
"IsOb": "1"
},
"QueueList": [
{
"ServiceLevel": 5,
"AnnounceSound": 1,
"WrapupTime": 30,
"MaxLen": 0,
"Description": "queue_name",
"AnnouncePosition": 1,
"AnnounceSoundFile": "voice_filexxxxx",
"CreateTime": "2026-04-20 10:00:00",
"QueueTimeout": 600,
"AnnounceSoundFrequency": 17,
"AnnouncePositionYouarenext": 1,
"AnnouncePositionParam": 4,
"MemberTimeout": 25,
"Weight": 10,
"JoinEmpty": 1,
"EnterpriseId": 7000002,
"Qno": "322",
"MusicClass": "class1",
"Strategy": "rrordered",
"Id": 76,
"Retry": 20,
"SayAgentno": true,
"VipSupport": 1,
"AnnouncePositionFrequency": 10
}
]
}
]
},
"Code": "OK"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。