调用ListAgentStates获取坐席状态。
坐席瞬时状态列表,统计的范围是截止调用时间4个小时内的,存在活跃坐席的状态信息。
4 个小时内:是指发起统计的当前时间点,往前推 4 个小时。
活跃坐席:是指在上述时间范围内,状态发生变化的坐席。坐席状态变化包括签入、签出、小休、外呼等。仅登录坐席工作台,而没有签入的情况,不属于活跃坐席。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListAgentStates |
系统规定参数。取值:ListAgentStates。 |
InstanceId | String | 是 | 9cfad875-6260-4a53-ab6e-b13e3fb31f7d |
呼叫中心实例ID |
SkillGroupId | String | 否 | XXX |
技能组ID |
AgentIds | String | 否 | 237432034227828673 |
坐席ID列表。 坐席ID等同于该座席的RAM子账户ID,最多50个坐席;不传则查询全部。 |
State | String | 否 | ACW |
坐席状态列表。 不传查询全部。枚举值:ACW:话后处理中,Break:小休,Dialing:拨号,Ringing:振铃,Ready:等待,Talking:通话。 |
PageNumber | Integer | 否 | 1 |
分页序号,默认值为1 |
PageSize | Integer | 否 | 10 |
分页大小,默认值为10,最大是100。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | OK |
响应码 |
Data | Struct |
报表 |
|
List | Array |
坐席报表列表 |
|
RealTimeAgentState | |||
AgentId | String | 237432034227828673 |
座席ID,等同于该座席的RAM子账户ID。 |
AgentName | String | 派鸽 |
座席名称 |
Dn | String | 80301522 |
分机号码 |
InstanceId | String | 9cfad875-6260-4a53-ab6e-b13e3fb31f7d |
呼叫中心实例ID |
LoginName | String | paige |
座席登录名 |
State | String | Ready |
座席状态描述,会有以下描述:会议、发起求助、处理、小休、拨号、振铃、求助、等待、通话。 |
StateDuration | String | 10 |
坐席状态持续时长 |
PageNumber | Integer | 1 |
分页序号 |
PageSize | Integer | 2 |
分页大小 |
TotalCount | Integer | 2 |
总个数 |
HttpStatusCode | Integer | 200 |
HTTP状态码 |
Message | String | 无 |
响应信息 |
RequestId | String | 03C67DAD-EB26-41D8-949D-9B0C470FB716 |
请求iD |
Success | Boolean | true |
是否成功 |
示例
请求示例
http(s)://[Endpoint]/?Action=ListAgentStates
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>947B7F2A-BD31-4A0B-9CC0-13F8165C65A7</RequestId>
<HttpStatusCode>200</HttpStatusCode>
<Data>
<TotalCount>3</TotalCount>
<PageSize>50</PageSize>
<PageNumber>1</PageNumber>
<List>
<RealTimeAgentState>
<LoginName>paige</LoginName>
<InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
<State>ACW</State>
<Dn>80301522</Dn>
<AgentId>237432034227828673</AgentId>
<AgentName>派鸽</AgentName>
</RealTimeAgentState>
<RealTimeAgentState>
<LoginName>banshi1</LoginName>
<InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
<State>Ready</State>
<Dn>80322399</Dn>
<AgentId>243374734951787536</AgentId>
<AgentName>般石</AgentName>
</RealTimeAgentState>
<RealTimeAgentState>
<LoginName>mengzhen1234</LoginName>
<InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
<State>Ringing</State>
<Dn>80325610</Dn>
<AgentId>273570923499439182</AgentId>
<AgentName>孟珍1234</AgentName>
</RealTimeAgentState>
</List>
</Data>
<Code>OK</Code>
<Success>true</Success>
JSON
格式
{
"RequestId": "947B7F2A-BD31-4A0B-9CC0-13F8165C65A7",
"HttpStatusCode": 200,
"Data": {
"TotalCount": 3,
"PageSize": 50,
"PageNumber": 1,
"List": {
"RealTimeAgentState": [
{
"LoginName": "paige",
"InstanceId": "9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
"State": "ACW",
"Dn": "80301522",
"AgentId": "237432034227828673",
"AgentName": "派鸽"
},
{
"LoginName": "banshi1",
"InstanceId": "9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
"State": "Ready",
"Dn": "80322399",
"AgentId": "243374734951787536",
"AgentName": "般石"
},
{
"LoginName": "mengzhen1234",
"InstanceId": "9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
"State": "Ringing",
"Dn": "80325610",
"AgentId": "273570923499439182",
"AgentName": "孟珍1234"
}
]
}
},
"Code": "OK",
"Success": true
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交