调用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
}

错误码

访问错误中心查看更多错误码。