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

< / >

APIs Reports Manager

5. Workforce per hour

URL:

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

Description:

Taking into account the number of incoming calls and the average customer service time in seconds, the system calculates the required workforce per hour and per skill.

Benefit:

Calculate the hourly labor force required to maintain the operation’s optimum service levels.

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.

REQUEST

NAMEDESCRIPTIONTYPE
apiType of report requiredString
skill_idNumerical identification of the skillString
date_iniInicial Date (YYYYmmddHHiiss)String
date_endFinal Date (YYYYmmddHHiiss)String

RESPONSE

NAMEDESCRIPTIONTYPE
skill_idNumerical identification of the skillString
hourIndicates the timeString
inbound_callsTotal number of calls entering the operationString
inbound_calls_unique_customersThe total number of incoming calls to the operation from the same customer.String
ahtAverage customer service time by the advisor (Average Handle Time)String
agents_neededIndicates the number of agents required in the operation.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_5&skill_id={{skill_id}}&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": [
        {
            "skill_id": "",
            "hour": "",
            "inbound_calls": "",
            "inbound_calls_unique_customers": "",
            "aht": "",
            "agents_needed": ""
        }
    ]
}
				
			
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