Bulk Uploading for Audio Prompts
Last updated
Last updated
The Audio Manager allows you to upload your own human-recorded audio files for any or all prompts in an survey. While you can upload your recorded audio files one-by-one to the desired prompts, you may want to upload files for multiple prompts all at once.
This guide describes how to bulk upload audio prompts in the Audio Manager, which includes the following steps:
Exporting all prompt filenames
Renaming your audio files to match your target prompts
Adding these renamed audio files to a .zip
archive
Uploading the .zip
archive to apply the renamed audio files
Testing your new audio prompts
All of your intended custom audio prompts, recorded in a compatible file format. See to decide for which prompts you'd like to record an audio file. If you do not already have a preferred recording application, Plum recommends the free Audacity application to record audio:
A spreadsheet application.
Examples include Microsoft Excel and Google Sheets. You will use this to view a .csv
spreadsheet.
A .zip
application.
Many current operating systems have built-in .zip
utilities. A free alternative is 7-Zip. You should be familiar with how to create a .zip
archive using your chosen application.
Terms and user interface elements discussed here are similarly covered in this documentation.
Finish building your Insight survey first. Once finished, you will likely have a finalized list of prompts in the Prompt Table. This would allow you to bulk upload for all prompts in one effort – or as few efforts as possible.
These filenames correspond to each prompt in your survey. Your audio file must use the same filename as its intended prompt.
Read the spreadsheet to locate each prompt that will receive an audio file. Figure 3 provides an example of how the prompts listed in the Audio Manager and the spreadsheet compare.
Confirm the prompt's filename, and rename the desired audio file to match it exactly*. This allows the Audio Manager to identify which prompt should receive that audio file from your bulk upload.
Add the renamed audio files to the same folder or directory, then add them to a .zip
archive. Save the .zip
archive in a memorable location.
The .zip
archive will be uploaded, and the Audio Manager will apply each renamed audio file within to the prompt with a matching filename. All other prompts will remain unchanged.
Note: Any uploaded recordings will override any text entered for a survey's prompt field.
Finally, create a deployment with the survey and dial the number of your deployment to test it. During your test calls, select each option connected to your prompts and ensure that each audio prompt plays back as intended.
If any audio prompts fail, open the survey in the Survey Editor, go to the Audio Manager, and check the following in order:
Was an audio file uploaded to the correct prompt? Carefully check the filenames you used for each audio file. They must be entered exactly as given in the .cvs
spreadsheet, and each filename is linked to a specific prompt in your application.
Does a failing prompt play any audio at all when you select the Play button? If not, try reuploading the desired audio file. File damage could also prevent playback.
If no issues are found, you've successfully bulk uploaded audio prompts for your survey.
. In the Survey Manager, select the desired survey. In the Survey Editor, select the gear icon, then select Prompts. The Audio Manager will be displayed as shown in Figure 1.
Select the tab for the desired language, then select Export CSV. Save the .csv
spreadsheet in a memorable location, and open it in your chosen spreadsheet application. The spreadsheet should contain a filename column and a prompt column as shown in Figure 2.
*Note: The file type does not have to match, but it must be compatible with Insight. See for more information.
Select Upload Zip. In the File Upload window, navigate to the folder or directory containing the .zip
archive, select it, then select Open.
TTS: Default prompt type. Indicates no audio file is attached.
Audio: These prompts have an uploaded audio file attached. Look for these.
In the Prompt Table, review the list of audio prompts. Select the Play button on each one, and listen to the entire playback to confirm that each prompt uses the correct audio file and that the audio plays as desired. Figure 4 provides an example.
Is the audio file in a compatible format and file size? Review the guidelines described under and verify that your audio files match them.