GetSkillGroupStatusTotal
Obtain the total status count of skill groups under hotline reports. Supports grouped queries by instance, time range, agent, 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 agent, 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.
Throttling will be triggered if the total invocations from multiple users exceed the API frequency limit.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| InstanceId |
string |
Yes |
AICCS instance ID. You can obtain it from Instance Management in the left-side navigation pane of the Artificial Intelligence Cloud Call Service console. |
ccc_xp_pre-cn-*** |
| StartDate |
integer |
No |
Start Datetime Variable UNIX timestamp. Unit: milliseconds. |
1615083365000 |
| EndDate |
integer |
No |
End UNIX timestamp. Unit: milliseconds. |
1617761765000 |
| PageSize |
integer |
No |
Page size. The value must be greater than 0. Default value: 20. |
20 |
| CurrentPage |
integer |
No |
Current page number. The value must be greater than 0. Default value: 1. |
1 |
| AgentIds |
array |
No |
List of agent IDs. |
|
|
integer |
No |
Agent ID. You can invoke the GetAgent API and view the AgentId in the response parameters, which is the agent ID. |
111 |
|
| DepIds |
array |
No |
List of department IDs. |
|
|
integer |
No |
Department ID. You can invoke the GetAllDepartment API and view the DepartmentId in the response parameters to obtain the department ID. |
123 |
|
| GroupIds |
array |
No |
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. |
100 |
|
| TimeLatitudeType |
string |
No |
Time latitude type. Valid values:
|
minute |
| ExistAgentGrouping |
boolean |
No |
Whether to query by agent group. Default value: false. Valid values:
|
false |
| ExistDepartmentGrouping |
boolean |
No |
Whether to query by department group. Default value: false. Valid values:
|
false |
| ExistSkillGroupGrouping |
boolean |
No |
Specifies whether to query by skill group grouping. Default value: false. Valid values:
|
false |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| RequestId |
string |
The 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 |
Current page number. |
1 |
| PageSize |
integer |
Page size. |
2000 |
| Rows |
string |
Information as a JSON string of type List |
{"minute_id":"-1","call_out_intervene_servicer_cnt":26,"call_out_servicer_cnt":35,"call_out_intervene_60s_cnt":155,"servicer_real_name":"--","call_in_sep_normal_cnt":0,"call_out_intervene_30s_cnt":235,"servicer_id":"-1","tenant_name":"非单元测试化BU","call_out_sep_sat_cnt":1} |
| Code |
string |
Status code. A return value of 200 indicates that the Request succeeded. |
200 |
| Success |
string |
Indicates whether the API invoke succeeded. Valid values:
|
true |
Parameter Guide for the Rows field in the response:
date_id: Date
hour_id: Hour
minute_id: Minute
servicer_id: Agent ID
servicer_name: Agent name
servicer_real_name: Agent real name
group_id: Skill group ID
group_name: Skill group name
department_id: Department ID
department_name: Department name
tenant_id: Tenant ID
tenant_name: Tenant name
inline_cnt: Incoming call volume
request_cnt: Request volume (in-progress volume minus reassign volume)
ready_cnt: Answered call volume
reassign_cnt: Reassigned volume
ready_cnt_60s: Calls answered within 60 seconds
ringqueue_len: Duration from entering queue to ringing
ringtime_len: Duration from ringing to answer
queue_len: Duration from entering queue to answer
service_time_len: Service duration from answer to end
give_up_len: Total abandonment duration from entering queue to end
call_out_cnt: Outbound call volume
call_out_intervene_cnt: Total ringing duration for outbound calls (from ringing to end)
call_out_sep_sat_cnt: Satisfied outbound hotline evaluations
call_out_sep_normal_cnt: Neutral outbound hotline evaluations
call_out_sep_unsat_cnt: Dissatisfied outbound hotline evaluations
call_out_unsep_cnt: Outbound hotline evaluations with participation but no rating
call_in_unsep_cnt: Inbound hotline evaluations with participation but no rating
call_in_sep_sat_cnt: Satisfied inbound hotline evaluations
call_in_sep_normal_cnt: Neutral inbound hotline evaluations
call_in_sep_unsat_cnt: Dissatisfied inbound hotline evaluations
call_out_intervene_20s_cnt: Outbound calls connected with duration >20 seconds
call_out_intervene_30s_cnt: Outbound calls connected with duration >30 seconds
call_out_intervene_60s_cnt: Outbound calls connected with duration >60 seconds
call_in_intervene_20s_cnt: Inbound calls connected with duration >20 seconds
call_in_intervene_30s_cnt: Inbound calls connected with duration >30 seconds
call_in_intervene_60s_cnt: Inbound calls connected with duration >60 seconds
Examples
Success response
JSON format
{
"RequestId": "EE338D98-9BD3-4413-B165",
"Message": "successful",
"Data": {
"TotalNum": 4,
"PageNum": 1,
"PageSize": 2000,
"Rows": "{\"minute_id\":\"-1\",\"call_out_intervene_servicer_cnt\":26,\"call_out_servicer_cnt\":35,\"call_out_intervene_60s_cnt\":155,\"servicer_real_name\":\"--\",\"call_in_sep_normal_cnt\":0,\"call_out_intervene_30s_cnt\":235,\"servicer_id\":\"-1\",\"tenant_name\":\"非单元测试化BU\",\"call_out_sep_sat_cnt\":1}"
},
"Code": "200",
"Success": "true"
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 500 | SystemError | A system error occurred. Please contact the administrator. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.