技能组瞬时状态列表

技能组瞬时状态列表,统计的范围是截止调用时间4个小时内的,存在活跃坐席的技能组的状态信息。

  • 4 个小时内:是指发起统计的当前时间点,往前推 4 个小时。
  • 活跃坐席:是指在上述时间范围内,状态发生变化的坐席。坐席状态变化包括签入、签出、小休、外呼等。仅登录坐席工作台,而没有签入的情况,不属于活跃坐席。

因此,返回的技能组同时满足上述 2 个条件,即过去 4 小时能,该技能组内有坐席的状态发送过变化,才返回。特别的,如果某技能组,过去 4 小时内,没有坐席状态发生变化,就不会返回该技能组瞬时状态信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListSkillGroupStates

系统规定参数。取值:ListSkillGroupStates

InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb31f7d

呼叫中心实例ID

PageNumber Integer 1

分页序号,默认值为1。

PageSize Integer 10

分页大小,默认值为10,最大是100。

SkillGroupIds String {"SkillGroup":[{"SkillGroupName":"Default","SkillGroupId":"014a9696-931d-49db-ae96-111d2098a548"}]}

技能组ID列表,使用’,’隔开,最多50个技能组;不传查询全部。

返回数据

名称 类型 示例值 描述
Code String OK

响应码

Data

报表

List

列表

RealTimeSkillGroupState

列表

BreakingAgents Long 0

小休坐席数。

InstanceId String b0eb2742-f37e-4c67-82d4-25c651c1c450

呼叫中心实例ID。

LoggedInAgents Long 0

在线坐席数。

LongestCall Long 0

最大等待时长。

ReadyAgents Long 1

空闲坐席数。

SkillGroupId String 8fb654c6-17c6-4501-ba57-f5ddeb919814

技能组ID。

SkillGroupName String 其他服务

技能组展示名。

TalkingAgents Long 0

正在通话坐席数。

WaitingCalls Long 0

当前排队电话个数。

WorkingAgents Long 0

话后处理坐席数。

PageNumber Integer 1

分页序号

PageSize Integer 2

分页大小

TotalCount Integer 2

总个数

HttpStatusCode Integer 200

HTTP状态码

Message String

响应信息

RequestId String 66BD5D25-3785-46D1-BAE7-F81920E501F2

请求ID

Success Boolean true

是否成功

示例

请求示例


http(s)://[Endpoint]/?Action=ListSkillGroupStates
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb31f7d
&<公共请求参数>

正常返回示例

XML 格式

<ListSkillGroupStatesResponse>
      <code>OK</code>
      <data>
            <pageNumber>1</pageNumber>
            <pageSize>10</pageSize>
            <totalCount>1</totalCount>
            <list>
                  <longestCall>0</longestCall>
                  <talkingAgents>0</talkingAgents>
                  <instanceId>b0eb2742-f37e-4c67-82d4-25c651c1c450</instanceId>
                  <loggedInAgents>1</loggedInAgents>
                  <breakingAgents>0</breakingAgents>
                  <skillGroupName>其他服务</skillGroupName>
                  <workingAgents>0</workingAgents>
                  <readyAgents>1</readyAgents>
                  <skillGroupId>8fb654c6-17c6-4501-ba57-f5ddeb919814</skillGroupId>
                  <waitingCalls>0</waitingCalls>
            </list>
      </data>
      <requestId>66BD5D25-3785-46D1-BAE7-F81920E501F2</requestId>
      <success>true</success>
      <httpStatusCode>200</httpStatusCode>
</ListSkillGroupStatesResponse>

JSON 格式

{
	"httpStatusCode":200,
	"requestId":"66BD5D25-3785-46D1-BAE7-F81920E501F2",
	"data":{
		"totalCount":1,
		"pageSize":10,
		"pageNumber":1,
		"list":[
			{
				"workingAgents":0,
				"skillGroupId":"8fb654c6-17c6-4501-ba57-f5ddeb919814",
				"loggedInAgents":1,
				"breakingAgents":0,
				"readyAgents":1,
				"instanceId":"b0eb2742-f37e-4c67-82d4-25c651c1c450",
				"talkingAgents":0,
				"longestCall":0,
				"waitingCalls":0,
				"skillGroupName":"其他服务"
			}
		]
	},
	"code":"OK",
	"success":true
}

错误码

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