WHY WOLKVOX? OMNICHANNEL PLATFORM WOLKVOX CRM CHATBOTS AND VOICEBOTS MANUALS

COLOMBIA Medellín +57 (4) 322 98 80 Bogotá +57 (1) 381 90 40 Cali +57 (2) 891 28 46 Barranquilla +57 (5) 316 10 34 ARGENTINA Buenos Aires +54 (11) 5217 5933 SPAIN Madrid +34 (910) 601 691 MEXICO Ciudad de México +52 (55) 8526 36 34 BRASIL Brasilia +55 (61) 9836 4127 São Paulo +55 (12) 9811 155 83 UNITED STATES New York +1 (914) 373 71 36 DOMINICAN REPUBLIC Santo Domingo +1 (829) 249 69 68 CHILE Santiago de Chile +56 (2) 240 533 89 GUATEMALA Ciudad de Guatemala +502 (2) 314 1344 PERU Lima +51 (1) 644 91 39

1. Speech Calls

< / >

APIs Speech Analytics

1. Speech Calls

URL:

https://wv{{wolkvox_server}}.wolkvox.com/api/v2/speech_analytics.php?api=speech_calls&date_ini={{YYYYmmddHHiiss}}&date_end={{YYYYmmddHHiiss}}&filter={{filter}}&value={{value}}

Description:

API that allows generating speech analytics information and all voice to text conversion analysis in calls.

Benefit:

It allows to optimize the analysis of voice to text conversions without having to listen to the recordings of the calls.

How it works:

This API is consumed 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 use the authorization token.
Keep in mind that the same token cannot be consumed simultaneously, so you can program that the next API is consumed when the result of the previous one is successful.
The fields {{filter}} and {{value}} are optional and allow for more convenient information filtering. Therefore, the URL can be as follows: https://wv{{wolkvox_server}}.wolkvox.com/api/v2/speech_analytics.php?api=speech_calls&date_ini={{YYYYmmddHHiiss}}&date_end={{YYYYmmddHHiiss}}
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
filter	Name of the column field or for filtering the search. It can take the values “id_call”, “id_agent”, “cod_act”, and “speech_to_text”.	String
value	Value to which the filter is to be applied	String

Response

NAME	DESCRIPTION	TYPE
conn_id	It corresponds to the call ID	String
agent_id	It is the numerical user that is assigned to each of the wolkvox agents	String
customer_phone	It corresponds to the customer‘s phone	String
time	Indicates time in units of seconds	String
date	Indicates the date with year–month–day–hour format	String
cod_act	Refers to the call classification	String
greeting	Indicates if the agent greeted (yes) or not (no).	String
slow_to_greet	Indicates if there was a delay in greeting (yes/no).	String
greeting_agent_name	Indicates if the agent greets with their name (yes/no).	String
category01	Category 1 customizable and configurable in the speech	String
category02	Category 2 customizable and configurable in the speech	String
category03	Category 3 customizable and configurable in the speech	String
category04	Category 4 customizable and configurable in the speech	String
category05	Category 5 customizable and configurable in the speech	String
silence	Percentage of silence in the call	String
audio_text	Voice to text conversion of the call	String
customer_id	Corresponds to the customer‘s identification number	String
summary	Summary of the call conversation	String
feeling	Average customer sentiment about the conversation. It can result in “Very negative”, “Negative”, “Neutral”, “Positive”, and “Very positive”.	String
channel	Channel to which the connector belongs. It can yield the values “voice”, “chat-whatsapp”, and “chat-sms”.	String

Possible response codes

				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/speech_analytics.php?api=speech_calls&date_ini={{date_ini}}&date_end={{date_end}}&filter={{filter}}&value={{value}}',
  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;

				
					curl --location --globoff 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/speech_analytics.php?api=speech_calls&date_ini={{date_ini}}&date_end={{date_end}}&filter={{filter}}&value={{value}}' \
--header 'wolkvox_server: {{wolkvox_server}}' \
--header 'wolkvox-token: {{wolkvox-token}}'

				
					OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://wv{{wolkvox_server}}.wolkvox.com/api/v2/speech_analytics.php?api=speech_calls&date_ini={{date_ini}}&date_end={{date_end}}&filter={{filter}}&value={{value}}")
  .method("GET", body)
  .addHeader("wolkvox_server", "{{wolkvox_server}}")
  .addHeader("wolkvox-token", "{{wolkvox-token}}")
  .build();
Response response = client.newCall(request).execute();

				
					import requests

url = "https://wv{{wolkvox_server}}.wolkvox.com/api/v2/speech_analytics.php?api=speech_calls&date_ini={{date_ini}}&date_end={{date_end}}&filter={{filter}}&value={{value}}"

payload = {}
headers = {
  'wolkvox_server': '{{wolkvox_server}}',
  'wolkvox-token': '{{wolkvox-token}}'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

RESPONSE

				
					{
    "code": "200",
    "error": null,
    "msg": "1 records were found",
    "data": [
        {
            "conn_id": "",
            "agent_id": "",
            "customer_phone": "",
            "time": "",
            "date": "",
            "cod_act": "",
            "greeting": "",
            "slow_to_greet": "",
            "greeting_agent_name": "",
            "category01": "",
            "category02": "",
            "category03": "",
            "category04": "",
            "category05": "",
            "silence": "",
            "audio_text": "",
            "customer_id":"",
            "summary": "",
            "feeling":"",
            "channel":""
        }
    ]
}

APPLICATIONS

MULTICHANNEL DIALER

WOLKVOX STUDIO

ARTIFICIAL INTELLIGENCE

VOICE OF THE CUSTOMER

QUALITY AND PRODUCTIVITY

ANALYTICS

TELEPHONY

INTEGRATIONS

BY INDUSTRY

BY COMPANY TYPE

SMART TEAMS

AUTOMATION AND ARTIFICIAL INTELLIGENCE

DIGITAL TRANSFORMATION

APPLICATIONS

MULTICHANNEL DIALER

WOLKVOX STUDIO

ARTIFICIAL INTELLIGENCE

VOICE OF THE CUSTOMER

QUALITY AND PRODUCTIVITY

ANALYTICS

TELEPHONY

INTEGRATIONS

BY INDUSTRY

BY COMPANY TYPE

SMART TEAMS

AUTOMATION AND ARTIFICIAL INTELLIGENCE

DIGITAL TRANSFORMATION

< / >

APIs Speech Analytics

1. Speech Calls

Request

Response

RESPONSE

UNITED STATES

ARGENTINA

BRAZIL

CHILE

SPAIN

COLOMBIA

GUATEMALA

MEXICO

DOMINICAN REPUBLIC

PERU

AUTOMATION AND
ARTIFICIAL INTELLIGENCE

AUTOMATION AND
ARTIFICIAL INTELLIGENCE