Search
Close this search box.

< / >

APIs Billing

3. Calls and service level per day

URL:

https://wv{{wolkvox_server}}.wolkvox.com/api/v2/reports_manager.php?api=skill_3&skill_id={{skill_id}}&date_ini={{YYYYmmddHHiiss}}&date_end={{YYYYmmddHHiiss}}

Description:

Taking into account the total inbound calls, the percentage of abandonment and the time the customer waits on the line to be attended, this report allows you to track by day and queue the level of service of the operation and the consolidation of inbound calls.

Benefit:

Identifying the service level per day is necessary for operations because this indicator can be not only an objective, but also a real performance measurement. This report makes it possible to track per day in a particular way.

How it works:

  • The consumption of this API is done by GET method.
  • To consume this API you must replace in the url {{{wolkvox_server}} by the nomenclature of the server of the operation.
  • The wolkvox-token header must be used to make use of the authorization token.
  • Note that the same token cannot be consumed simultaneously, so you can schedule the next API to be consumed when the result of the previous one is successful.
  • In terms of time, to keep track of your operation you can make a consumption every 5 minutes of the information.
  • This API can receive the parameter skill_id=all.
  • Limit of records that can be downloaded per consumption: 60,000 records.
  • Limit of records that can be uploaded per consumption: 10,000 records.
  • Limit of days queried in dates: 31 days.
  • Limit of result weight: 256 MB.
  • API consumption time limit: 60 seconds
  • Concurrent consumption limit of a token: 2 simultaneous requests.
  • Daily limit of tokens: Number of licenses multiplied by 1000 daily tokens.

Request

NAME DESCRIPTION TYPE
api Type of report required String
skill_id Numerical identification of the skill String
date_ini Initial Date (YYYYmmddHHiiss) String
date_end Final Date (YYYYmmddHHiiss) String

Response

NAME DESCRIPTION TYPE
skill_name Skill name String
date Indicates the date with format year-month-day-time String
inbound_calls Total number of calls entering the operation String
answer_calls Total number of inbound calls handled by the agent String
abandon_calls The total number of inbound calls hung up by the client before the consultant’s attention. String
service_level_10seg Indicates the % of calls that were answered within 10 seconds. String
service_level_20seg Indicates the % of calls that were answered within 20 seconds. String
service_level_30seg Indicates the % of calls that were answered within 30 seconds. String
wait_time Indicates the waiting time String
abandon Indicates the percentage of inbound calls hung up by the client prior to the consultant’s attention. String
asa Indicates the average time in seconds that the customer waits on the line to be attended (Average Speed Answer). String
ata Indicates the average time in seconds that the customer waits on the line before abandoning (Average Time Abandonment). String
aht Average Handling Time or Average Call Time. Measures the time it takes an agent to serve a customer. String
Possible response codes
				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/reports_manager.php?api=skill_3&skill_id={{skill_id}}&date_ini={{date_ini}}&date_end={{date_end}}',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'wolkvox_server: {{wolkvox_server}}',
    'wolkvox-token: {{wolkvox-token}}'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

				
			

RESPONSE

				
					{
    "code": 200,
    "error": null,
    "msg": "1 records were found",
    "data": [
        {
            "skill_name": "",
            "date": "",
            "inbound_calls": "",
            "answer_calls": "",
            "abandon_calls": "",
            "service_level_10seg": "",
            "service_level_20seg": "",
            "service_level_30seg": "",
            "wait_time": "",
            "abandon": "",
            "asa": "",
            "ata": ""
        }
    ]
}
				
			
We use cookies, if you continue browsing we will assume that you agree. You can read more about the use of cookies in our privacy policies and treatment of personal data