Querying Service Quality for Skill Queues in Batches

Description

This interface is invoked to query the service quality data of the skill queue in the current 5 minutes.

Interface Method

The request method must be set to POST. This interface supports only the POST method.

Internal Encapsulation Interfaces

BMS interface: /ccbms/ws/monitor/callStatInfos

Request URL

https://ip:port/rest/cmsapp/v1/openapi/skill/servicequality

In a public cloud environment, ip indicates the IP address of the CC-CMS server, and port indicates the HTTPS port number of the CC-CMS server. Contact the administrator to obtain the values.In a non–public cloud environment where the NSLB service is configured, ip indicates the IP address of the NSLB server, and port indicates the HTTPS port number of the CC-CMS service mapped on the NSLB server.

Request Description

**Table 1** Parameters in the request header
No.	Parameter	Value Type	Mandatory	Description
1	Content-Type	String	Yes	The value is fixed to application/json; charset=UTF-8.
2	Authorization	String	Yes	For details about the generation mode, see C2 Monitoring, System Outbound Call, CDR, and Knowledge Base Interface Authentication.

**Table 2** Parameters in the request message body
No.	Parameter	Value Type	Mandatory	Description
1	ccId	Integer	Yes	ID of a call center. The value ranges from 1 to 65535.
2	vdn	Integer	Yes	ID of a VDN. The value ranges from 1 to 5000.
3	skillIds	Array	Yes	Object array of skill queue ID information. The array cannot exceed 1000 characters. The value ranges from 1 to 2000.

Response Message

**Table 3** Parameters in the response message body
No.	Parameter	Value Type	Description
1	resultCode	String	Query result. The options are as follows: 0100000: success Other values: failure For details about the failure causes, see Error Code Reference.
2	resultDesc	Array	Object array in the returned result after a successful query. For details about the parameters of this object in the array, see Table 4.

**Table 4** Parameters of resultDesc
No.	Parameter	Value Type	Description
2.1	skillId	Integer	Skill queue ID.
2.2	statStartTime	Long	Time when the statistics collection starts. The value is a timestamp in milliseconds.
2.3	inCallNum	Long	Total number of inbound calls in the current 5 minutes in a skill queue.
2.4	connectedNum	Long	Total number of connected calls in the current 5 minutes in a skill queue.
2.5	callLostNum	Long	Total number of lost calls in the current 5 minutes in a skill queue.
2.6	in15sCallNum	Long	Total number of calls that are connected in 15 seconds in the current 5 minutes in a skill queue.
2.7	wait15sLostNum	Long	Total number of lost calls whose queuing duration is less than 15 seconds in the current 5 minutes in a skill queue.
2.8	in20sCallNum	Long	Total number of calls that are connected within 20 seconds in the last 5 minutes in a skill queue.
2.9	wait20sLostNum	Long	Total number of lost calls whose queuing duration is less than 20 seconds in the current 5 minutes in a skill queue.

Message Example

Request header

Content-Type: application/json;charset=UTF-8
Authorization: ******************

Request parameters

{
    "ccId":1, 
    "vdn":1, 
    "skillIds":[1,2]
}

Response parameters

{
    "resultCode": "0100000",
    "resultDesc": [
        {
            "in15sCallNum": 0,
            "skillId": 1,
            "wait15sLostNum": 0,
            "callLostNum": 0,
            "in20sCallNum": 0,
            "statStartTime": 1611714900000,
            "wait20sLostNum": 0,
            "inCallNum": 0,
            "connectedNum": 0
        }
    ]
}

Parent topic: Real-Time Interfaces for Skill Queues

Previous topic: Querying Details About Signed-in Agents in a Skill Queue

Next topic: Obtaining Real-Time Monitoring Indicators by Skill Queue