https://wv{{wolkvox_server}}.wolkvox.com/api/v2/configuration.php?api=speech_on_demand
A new API has been implemented in the Speech Analytics API group within Wolkvox Manager. This API enables the activation of voice analysis (Speech Analytics) and customer analysis (VOC) for a specific call using its CONN-ID and Agent_ID. This development facilitates the automation of selected call analysis without manual intervention from the platform, optimizing resource utilization and allowing for the efficient extraction of operational and customer experience insights. It is a requirement that the call must be in stereo, meaning that the agent’s and customer’s audio must be separated into distinct audio channels.
This API is consumed via the GET method.
To use this API, you must replace {{wolkvox_server}}
in the URL with your operation’s server nomenclature.
You need to include the header wolkvox-token: {{token}}
to use the authorization token.
{{date_ini}}
with the desired start date and time for your query (format YYYYMMDDHHMMSS
, e.g., 20250201000000
).{{date_end}}
with the desired end date and time for your query (format YYYYMMDDHHMMSS
, e.g., 20250228235959
).Please note that the same token cannot be consumed simultaneously. You can schedule the next API call to occur only after the previous one has successfully completed.
For operational monitoring, you can consume information every 5 minutes.
In our Postman workspace (click here to go), you’ll find code examples that simplify integrating with our APIs across various programming languages, including cURL, Python, JavaScript, and more.
This feature is perfect for quick integrations and lets you adapt API calls to your system’s programming language.
NAME | DESCRIPTION | TYPE |
---|---|---|
api | Required report type. | String |
date_ini | Start date (YYYYmmddHHiiss). | String |
date_end | End date (YYYYmmddHHiiss). | String |
conn_id | Call identification number within the Wolkvox system. | String |
agent_id | Agent identification number within the Wolkvox system linked to the call. | String |
NAME | DESCRIPTION | TYPE |
---|---|---|
code | Response status code. | String |
error | Detailed information about any error that may have occurred during the API execution. | String |
msg | Informative message describing the response. | String |
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/configuration.php?api=speech_on_demand',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'PUT',
CURLOPT_POSTFIELDS =>'{
"conn_id": "",
"agent_id": ""
}',
CURLOPT_HTTPHEADER => array(
'wolkvox-token: {{wolkvox-token}}',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
curl --location --globoff --request PUT 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/configuration.php?api=speech_on_demand' \
--header 'wolkvox-token: {{wolkvox-token}}' \
--header 'Content-Type: application/json' \
--data '{
"conn_id": "",
"agent_id": ""
}'
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n \"conn_id\": \"\",\r\n \"agent_id\": \"\"\r\n}");
Request request = new Request.Builder()
.url("https://wv{{wolkvox_server}}.wolkvox.com/api/v2/configuration.php?api=speech_on_demand")
.method("PUT", body)
.addHeader("wolkvox-token", "{{wolkvox-token}}")
.addHeader("Content-Type", "application/json")
.build();
Response response = client.newCall(request).execute();
import requests
import json
url = "https://wv{{wolkvox_server}}.wolkvox.com/api/v2/configuration.php?api=speech_on_demand"
payload = json.dumps({
"conn_id": "",
"agent_id": ""
})
headers = {
'wolkvox-token': '{{wolkvox-token}}',
'Content-Type': 'application/json'
}
response = requests.request("PUT", url, headers=headers, data=payload)
print(response.text)
{
"code": "200",
"error": null,
"msg": "Speech analytics record created successfully"
}
Sao Paulo +55 (11) 521 75 933
Santiago de Chile +56 (2) 240 533 89
Medellín +57 (604) 322 98 80
Ciudad de Guatemala +502 (2) 3141344
Ciudad de México +52 (55) 8526 36 34
Copyright © 2025 WOLKVOX MICROSYSLABS. 1820 N Corporate Lakes Blvd, unit 205. Weston, FL 33326
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
Copyright © 2025 WOLKVOX MICROSYSLABS.
Cra 30 # 4A – 45 Of. 205 Ed. FOREVER W&L, Medellín, Colombia