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

16. List audios

< / >

APIs Information

16. List audios

URL:

https://wv{{wolkvox_server}}.wolkvox.com/api/v2/information.php?api=audio_list

Description:

This API allows you to retrieve a list of the audio files stored on the platform, providing detailed information about each file, such as its name, duration, and creation date.

Benefits:

✅ Facilitates the management and querying of audio files within the system.

✅ Allows users to obtain key information about the stored files.

✅ Optimizes the control and organization of audio content.

¿How It Works?

The consumption of this API is done via the ‘GET’ method.
To consume this API, you must replace {{wolkvox_server}} in the URL with the server nomenclature of your operation.
You must use ‘wolkvox-token: {{token}}’ in the Header to utilize the authorization token.
Note that the same token cannot be consumed simultaneously; therefore, you can schedule the next API call to occur only after the previous one has been successful.
In terms of timing, you can track your operation by making a request every 5 minutes for the information.

Limits

Maximum records that can be downloaded per request: 60,000 records.
Maximum records that can be uploaded per request: 10,000 records.
Maximum date range for queries: 31 days.
Maximum result size: 256 MB.
Maximum API consumption time: 60 seconds.
Maximum simultaneous consumption of a token: 2 concurrent requests.
Daily token limit: Number of licenses multiplied by 1,000 daily tokens.
Each audio file cannot exceed 5MB in size.

Code Examples:

In our Postman workspace (click here to access), you will find code examples that facilitate integration with our APIs in various programming languages, such as cURL, Python, JavaScript, and more.

This functionality is ideal for quick integrations and allows you to adapt API calls according to your system’s programming language.

How to Use the Code Examples:

Navigate to our Postman workspace.
Select the API you wish to query.
Edit the necessary API parameters according to your objectives.
In the “Code” tab, select your preferred programming language.
You will receive an autogenerated code snippet, ready to use with the previously configured parameters and authentication.

Request

NAME	DESCRIPTION	TYPE
api	Type of report required.	String
wolkvox-token	Access token.	String
wolkvox_server	Operation server.	String

Response

NAME	DESCRIPTION	TYPE
code	Response status code.	String
error	Error message, if any.	String
msg	Informational message about the response.	String
data	Array of objects containing information about each notification.	array
audio_id	Audio identification number.	String
created_at	Date and time when the audio file was created or uploaded to the platform.	String
size	Size of the audio file in kilobytes (KB).	String
duration	Duration of the audio file in seconds.	String

Possible response codes

				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/information.php?api=audio_list',
  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-token: {{wolkvox-token}}'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

				
					curl --location --globoff 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/information.php?api=audio_list' \
--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/information.php?api=audio_list")
  .method("GET", body)
  .addHeader("wolkvox-token", "{{wolkvox-token}}")
  .build();
Response response = client.newCall(request).execute();

				
					import requests

url = "https://wv{{wolkvox_server}}.wolkvox.com/api/v2/information.php?api=audio_list"

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

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

print(response.text)

RESPONSE

				
					{
    "code": "200",
    "error": null,
    "msg": "X records were found",
    "data": [
        {
            "audio_id": "",
            "created_at": "",
            "size": "",
            "duration": ""
        },
        {
            "audio_id": "",
            "created_at": "",
            "size": "",
            "duration": ""
        }
    ]
}

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 Information

16. List audios

Request

Response

RESPONSE

UNITED STATES

ARGENTINA

BRAZIL

CHILE

SPAIN

COLOMBIA

GUATEMALA

MEXICO

DOMINICAN REPUBLIC

PERU

AUTOMATION AND
ARTIFICIAL INTELLIGENCE

AUTOMATION AND
ARTIFICIAL INTELLIGENCE