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. ListenVox

< / >

APIs

1. ListenVox

URL:

https://wv{{server}}.wolkvox.com/listenVox/listenvox.php

Description:

This API allows you to analyze information (text or audio) from Speech and Text Analytics. It is not necessary that the information entered has been generated by wolkvox applications. But it is required to have wolkvox Manager and Agent.

Benefit:

Analyze call and chat interactions via external consumption without logging into wolkvox applications.

How it works:

The consumption of this API is done by POST method.
The wolkvox-token goes in autorization as API KEY.
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.
Validate that the entered agent exists.
It is validated that there is a file loaded.
The audio must be in MP3 format, stereo and must not exceed 30 minutes of recording or 1800 seconds.
If the transcript exceeds 6800 characters the summary will not be performed.
Use the ‘first_to_talk’ parameter to define whether the conversation was initiated by the agent or the cust.
The ‘first_to_talk’ parameter is not required.
To generate the Text Analytics report (in case of chat or text analysis) go to: Reports > Date Range Selection > Speech Analytics > Speech on Demand.
To generate the Speech Analytics report (in case of speech or audio analysis) go to: Reports > Reports > Date range selection > Speech Analytics > Speech on demand: Reports > Date range selection > Speech Analytics > CDR Speech.
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
agent_id	Agent extension number.	String
data	Text or file (in MP3 format and in stereo system).	String
first_to_talk	Informs whether the conversation was initiated by the agent or the customer. This parameter is not mandatory.	String

Response

NAME	DESCRIPTION	TYPE
code	Response code.	String
error	Informs whether there was an error or not.	String
id_call	Caller ID number.	String
msg	Reports whether it was successfully consumed or did not receive any text or file.	String

Possible response codes

				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/listenVox/listenvox.php',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('agent_id' => '{{agent_id}}','data'=> new CURLFILE('/path/to/file'),'type_call' => '{{type_call}}','cod_act' => '{{cod_act}}'),
  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/listenVox/listenvox.php' \
--header 'wolkvox_server: {{wolkvox_server}}' \
--header 'wolkvox-token: {{wolkvox-token}}' \
--form 'agent_id="{{agent_id}}"' \
--form 'data=@"/path/to/file"' \
--form 'type_call="{{type_call}}"' \
--form 'cod_act="{{cod_act}}"'

				
					OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("agent_id","{{agent_id}}")
  .addFormDataPart("data","/path/to/file",
    RequestBody.create(MediaType.parse("application/octet-stream"),
    new File("/path/to/file")))
  .addFormDataPart("type_call","{{type_call}}")
  .addFormDataPart("cod_act","{{cod_act}}")
  .build();
Request request = new Request.Builder()
  .url("https://wv{{wolkvox_server}}.wolkvox.com/listenVox/listenvox.php")
  .method("POST", 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/listenVox/listenvox.php"

payload = {'agent_id': '{{agent_id}}',
'type_call': '{{type_call}}',
'cod_act': '{{cod_act}}'}
files=[
  ('data',('file',open('/path/to/file','rb'),'application/octet-stream'))
]
headers = {
  'wolkvox_server': '{{wolkvox_server}}',
  'wolkvox-token': '{{wolkvox-token}}'
}

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

print(response.text)

RESPONSE

				
					{
    "code": " ",
    "error": " ",
    "id": " ",
    "msg": " "
}

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

1. ListenVox

Request

Response

RESPONSE

UNITED STATES

ARGENTINA

BRAZIL

CHILE

SPAIN

COLOMBIA

GUATEMALA

MEXICO

DOMINICAN REPUBLIC

PERU

AUTOMATION AND
ARTIFICIAL INTELLIGENCE

AUTOMATION AND
ARTIFICIAL INTELLIGENCE