Search
Close this search box.

< / >

APIs Customer

4. Skill detail reports

URL:

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

Description:

This report identifies the number of evaluations per skill that users have managed, provides an overall average and a detailed evaluation for each of the 10 possible customizable questions in the smart survey.

Benefit:

Evaluate customer satisfaction by taking into account the particular performance of the agents that are part of a specific skill, since knowing the voice of the customer will allow you to act in a timely manner.

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

Response

NAME DESCRIPTION TYPE
operation Indicates the name of the operation String
conn_id Corresponds to the call identification number String
type_call It determines the type of interaction. This column can have the following values: chat-configurationbox (internal chat), chat-email, chat-facebook (interaction from a messenger chat), chat-instagram (Instagram chat), chat-transferSkill (chat transferred from another skill), chat-web, chat-whatsapp, chat-telegram, chat-line (chat from Line messaging service), inbound (incoming call), internalcall_que (internal call from a queue), omni-email (email interaction), omni-facebook_page (interaction on a Facebook page post), omni-instagram (interaction on an Instagram page post), omni-twitter (interaction on a Twitter post), and out_pre (outbound call in predictive campaign). String
date Indicates the date in year-month -day -time format String
agent_id Refers to the numerical identification of each wolkvox Agent user. String
agent_name Agent’s name String
skill_id It is the numerical identification of the skill String
wait_time Indicates the waiting time in seconds String
calls_ans_10 Indicates calls that were answered within 10 seconds String
calls_ans_20 Indicates calls that were answered within 20 seconds String
calls_ans_30 Indicates calls that were answered within 30 seconds String
calls_ans_40 Indicates calls that were answered within 40 seconds String
calls_ans_50 Indicates calls that were answered within 50 seconds String
skill_result Indicates whether there was a response in the IVR. It returns “ANSWER” for yes and “ABANDON” for no. String
ani It is the telephone number from which the inbound call originates (Atomatic Number Identification). String
dnis Identifies the telephone number dialed by the customer String
Possible response codes
				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/customer.php?api=cdr_calls&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": [
        {
            "operation": "",
            "conn_id": "",
            "type_call": "",
            "date": "",
            "agent_id": "",
            "agent_name": "",
            "skill_id": "",
            "wait_time": "",
            "calls_ans_10": "",
            "calls_ans_20": "",
            "calls_ans_30": "",
            "calls_ans_40": "",
            "calls_ans_50": "",
            "skill_result": "",
            "ani": "",
            "dnis": ""
        }
    ]
}

				
			
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