Awaken Conversations User Guide

Please email helpdesk@awaken.io for omissions or errors.
×
Menu

Audio Management

 
Before uploading files to a folder, make sure the audio format is supported. Awaken Conversations Audio Evaluator can help with this verification.
 

Upload Audio to a Folder

There are 2 ways to upload audio files to Awaken Conversations. The first is a convenient, manual method using the web browser. The second method can be used for uploading audio via web services.
 
The types of files that are uploaded using the Awaken Conversations web interface can be:
 
zip files containing one or more audio files and optional metadata files in JSON or XML format
 
Any single file with or without a file extension. These should generally be audio files, but any type of file can be uploaded, with or without a file extension. Files that are not supported by Awaken Conversations will show in the processing log as being UNSUPPORTED.
 
The names of uploaded audio files and zip archives must adhere to the installation's filename requirements whether they are uploaded through the GUI or API. By default, these characters are not permitted in uploaded filenames: #*<>:?/\|{}$!'`"=^
 
Filename validation can be disabled by setting the filename_validation configuration setting to off. Custom filename character requirements can be defined by specifying a regular expression via filename_validation_pattern.
 
Note
Previously processed JSON transcripts can be re-uploaded to any folder in Awaken Conversations using these methods without the ASR engine needing to re-transcribe the files. If you want to maintain the association between the audio and transcript files, both files must be uploaded in a zip file and must share the same file name except for the extension. (For example, an audio file called File1.wav should have a corresponding JSON transcript file called File1.json).
 
See Creating Applications for more details about checking the status of processed and pending files.
 
Once you have successfully uploaded your audio, you can then download transcripts of all the audio files contained in a folder by going to the Folders section and using the download button shown in Folder Management.
 

Web-based Audio Upload

As shown in Folder Management item 6, there is a blue upload icon to the right of each folder that enables you to upload a single audio file or a zip of multiple audio files to be ingested into Awaken Conversations. File size is limited to 1 GB. Once your file has been uploaded, you can navigate to the Dashboard page and select your folder from the breadcrumb menu. After a few minutes you will start to see your audio data appear.
 
Whenever you upload audio files, you will see a Request ID in the Upload Audio Files pop-up window after your upload has been confirmed, as shown in the following screenshot:
 
 
This Request ID will also appear in the JSON transcript, enabling you to track each transcript back to the original upload, view the Request ID on the File details page, and use the Request ID in search terms in the UI.
 

Web Services Audio Upload

 

Bulk File Download

Bulk download of MP3s, JSON files, and text transcripts are available via the orange download icon shown in item 7 in Folder Management. Downloads are sent as one or more zip file(s), with up to 10,000 files per zip file.
 
Note
The maximum size of this zip file is 2 GB. Trying to download files that produce a zip file larger than 2 GB will fail with an error message. To work around this issue, you can download multiple sets of files, using a smaller date range for each or by downloading specific types of files together.
 

Removing Audio Files

To delete individual audio files from a Folder, view the file using the Dashboard Files View. Click the "x" on the rightmost side of the audio file to be deleted. A dialog displays to confirm that you want to delete the file.
 
Once you confirm, Awaken Conversations queues the file for deletion. A system under heavy load may take several minutes for the file to be fully deleted, but this situation is unlikely.
 
Summary charts and tables are not updated when an individual file is removed, but the file will no longer be available in the Dashboard Files View, nor will it appear in search results.