Search
Close this search box.

< / >

APIs Real Time

2. Evaluation results by agent

URL:

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

Description:

This report allows you to track quality evaluations in detail by interaction and consolidated by each consultant, even adding comments on the management, identifying the call ID, date and coding.

Benefit:

Evaluate in a particular and general way the performance of the agents according to the standards defined for the operation in order to create action and reinduction models if necessary.

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.
  • 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
date_ini Initial Date (YYYYmmddHHiiss) String
date_end Final Date (YYYYmmddHHiiss) String

Response

NAME DESCRIPTION TYPE
conn_id Corresponds to the call identification number String
agent_id Refers to the numerical ID of each wolkvox user Agent String
agent_name Name of the agent String
comments Comment text about the quality evaluation String
precision_unit_critical_error It is the percentage that indicates the critical errors not made by the agent (100%) or made by the agent (0%) String
precision_opportunity_error Is the percentage indicating the critical errors not made by the agent (100%) or made by the agent (0%) String
accuracy Is the average percentage of the rating of the agent evaluations String
date Indicates the date in year-month-day-time format String
survey Relates to the template used for the evaluation String
cod_act s the ID of the typing or coding code used by the agent String
channel Channel through which the interaction took place String
feedback Feedback String
skill_id Identification number of the skill where the call occurred 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=quality_2&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": [
        {
            "conn_id": "",
            "agent_id": "",
            "agent_name": "",
            "comments": "",
            "precision_unit_critical_error": "",
            "precision_opportunity_error": "",
            "accuracy": "",
            "date": "",
            "survey": "",
            "cod_act": ""
        }
    ]
}
				
			
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