GetSkillGroupLatitudeState
Obtain the hotline monitoring status metrics by skill group dimension. Supports queries grouped by instance, time range, department, and skill group.
Operation description
Before invoking this API, ensure that you have activated the service and created an instance.
If you need to specify department or skill group information, refer to the guidance in the Request Parameters section.
Queries per second (QPS) limits
Per-user invocation frequency: 100 times per second.
API-wide invocation frequency: 100 times per second.
If the total invocations from multiple users exceed the API frequency limit, throttling will be triggered.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| InstanceId |
string |
Yes |
AICCS instance ID. |
ccc_xp_pre-cn-*** |
| StartDate |
integer |
No |
The start date as a UNIX timestamp. Unit: milliseconds. |
1615083365000 |
| EndDate |
integer |
No |
End datetime UNIX timestamp. Unit: milliseconds. |
1617761765000 |
| PageSize |
integer |
No |
The page size. The value must be greater than 0. Default value: 20. |
20 |
| CurrentPage |
integer |
No |
Current page. The value must be greater than 0. Default value: 1. |
1 |
| DepIds |
array |
No |
List of department IDs. |
|
|
integer |
No |
Department ID. You can invoke the GetAllDepartment API and check the DepartmentId field in the response to obtain the department ID. |
100 |
|
| GroupIds |
array |
No |
A list of skill group IDs. |
|
|
integer |
No |
Skill group ID. You can invoke the QuerySkillGroups API and view the SkillGroupId in the response parameters to obtain the skill group ID. |
123 |
|
| ExistDepartmentGrouping |
boolean |
No |
Indicates whether to group by department. Valid values:
|
true |
| ExistSkillGroupGrouping |
boolean |
No |
Specifies whether to group by skill group. Valid values:
|
true |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| RequestId |
string |
Request ID. |
EE338D98-9BD3-4413-B165 |
| Message |
string |
Description of the status code. |
successful |
| Data |
object |
List of data. |
|
| TotalNum |
integer |
Total number of records. |
4 |
| PageNum |
integer |
The current page number. |
1 |
| PageSize |
integer |
The page size. |
2000 |
| Rows |
string |
A JSON string of type List |
{"tenant_id":"905","n_resttype_now":0,"tenant_name":"非单元测试化BU","n_resttype1_now":0,"group_name":"-1","department_id":"-1","department_name":"-1","n_resttype98_now":0,"n_online_now":0,"date_id":"20210329","n_resttype3_now":0,"n_resttype5_now":0,"n_busy_now":0,"n_resttype2_now":0,"group_id":"-1","n_idle_now":0,"n_resttype4_now":0,"n_ack_now":0,"n_resttype99_now":0,"maximumqueuingtime":-1} |
| Code |
string |
Status code. A return value of 200 indicates that the request succeeded. |
200 |
| Success |
string |
Indicates whether the API call succeeded. Valid values:
|
true |
Parameter description for the returned Rows parameter:
n_idle_now: Current number of idle agents
n_resttype_now: Current number of agents on break
n_resttype1_now: Current number of agents on regular break
n_resttype2_now: Current number of agents on meal break
n_resttype3_now: Current number of agents on meeting break
n_resttype4_now: Current number of agents on coaching break
n_resttype5_now: Current number of agents on training break
n_resttype98_now: Current number of agents on forced break
n_resttype99_now: Current number of agents signed in but on break
n_ack_now: Current number of agents in post-processing
tenant_id: Tenant ID
tenant_name: Tenant name
group_id: Skill group ID
group_name: Skill group name
department_id: Department ID
department_name: Department name
n_online_now: Current number of online agents
n_inqueue_now: Current number of members in queue
n_inservice_now: Current number of members in service
time_value: UNIX timestamp
fst_assign_time: Earliest assignment time in this queue, indicating when queued members were assigned
Examples
Success response
JSON format
{
"RequestId": "EE338D98-9BD3-4413-B165",
"Message": "successful",
"Data": {
"TotalNum": 4,
"PageNum": 1,
"PageSize": 2000,
"Rows": "{\"tenant_id\":\"905\",\"n_resttype_now\":0,\"tenant_name\":\"非单元测试化BU\",\"n_resttype1_now\":0,\"group_name\":\"-1\",\"department_id\":\"-1\",\"department_name\":\"-1\",\"n_resttype98_now\":0,\"n_online_now\":0,\"date_id\":\"20210329\",\"n_resttype3_now\":0,\"n_resttype5_now\":0,\"n_busy_now\":0,\"n_resttype2_now\":0,\"group_id\":\"-1\",\"n_idle_now\":0,\"n_resttype4_now\":0,\"n_ack_now\":0,\"n_resttype99_now\":0,\"maximumqueuingtime\":-1}"
},
"Code": "200",
"Success": "true"
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.