fbpx
Search
Close this search box.
Search
Close this search box.

< / >

APIs Reports Manager

4. Duration of calls classified by time

URL:

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

Description:

This report allows to identify by time intervals the duration of the calls that are part of the operation, indicating in percentage which duration is more frequent. It also includes the number of minutes consumed and the cost of interactions individually by intervals or globally.

The time intervals are: 0-5 sec, 6-20 sec, 21-60 sec, 61 – 121 sec and more than 121 sec.

Benefit:

This report provides an accurate view of the average duration of calls handled by agents, valuable information for modifying the speed of campaigns or calculating the required workforce.

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.

REQUEST

NAMEDESCRIPTIONTYPE
apiType of report requiredString
date_iniInitial Date (YYYYmmddHHiiss)String
date_endFinal Date (YYYYmmddHHiiss)String

RESPONSE

NAMEDESCRIPTIONTYPE
INTERVALRefers to the time periods in seconds of the call duration (0-5 sec, 6-20 sec, 21-60 sec, 61 – 121 sec and more than 121 sec).String
callsIndicates number of calls (inbound, outbound and internal)String
minutesIndicates time in minute unitsString
costIt is the price for the use of the productString
percentageIndicates the percentage of calls per intervalString

 

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=cdr_4&date_ini={{YYYYmmddHHiiss}}&date_end={{YYYYmmddHHiiss}}',
  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-token: {{wolkvox_token}}'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;


				
			

RESPONSE

				
					{
    "code": 200,
    "error": null,
    "msg": "1 records were found",
    "data": {
        "0_5_seg": {
            "calls": "",
            "minutes": "",
            "cost": "",
            "percentage": ""
        }
    }
} 

				
			
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