> For the complete documentation index, see [llms.txt](https://docs.plumvoice.com/insight/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plumvoice.com/insight/prompt-manager/bulk-uploading-for-audio-prompts.md). # Bulk Uploading for Audio Prompts ## Introduction 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: 1. Exporting all prompt filenames 2. Renaming your audio files to match your target prompts 3. Adding these renamed audio files to a `.zip` archive 4. Uploading the `.zip` archive to apply the renamed audio files 5. Testing your new audio prompts {% hint style="info" %} **Note:** Bulk uploading is meant to make multi-file uploads of audio prompts efficient. However, this will work even if you are uploading for only one. This guide assumes that your Insight survey has at least two or more prompts. {% endhint %} ### Prerequisites 1. **All of your intended custom audio prompts, recorded in a compatible file format.** \ See [Audio Prompts](https://docs.plumvoice.com/insight/prompt-manager#audio-prompts) 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: 2. **A spreadsheet application.** \ Examples include Microsoft Excel and Google Sheets. You will use this to view a `.csv` spreadsheet. 3. **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. 4. [**Review the docs on Audio Prompts.**](https://docs.plumvoice.com/insight/prompt-manager#audio-prompts) Terms and user interface elements discussed here are similarly covered in this documentation. ### Recommendations 1. **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. ## Step 1: Export a spreadsheet of prompt filenames [Log in to Insight](https://insight.plumvoice.com/account_manager/login). 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.

Figure 1: Audio prompts in the Audio Manager.

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.

Figure 2: The exported list of audio prompt filenames.

These filenames correspond to each prompt in your survey. **Your audio file must use the same filename as its intended prompt.** ## Step 2: Rename your audio files 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.

Figure 3: Prompts in the Audio Manager compared with the exported .csv spreadsheet.
Select this image to zoom in.

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. {% hint style="info" %} **\*Note:** The file type does not have to match, but it must be compatible with Insight. \ See [Audio Formats](https://docs.plumvoice.com/insight/prompt-manager#audio-prompts) for more information. {% endhint %} ## Step 3: Add your audio files to a ZIP archive 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. ## Step 4: Upload the ZIP archive Select **Upload Zip**. In the File Upload window, navigate to the folder or directory containing the `.zip` archive, select it, then select **Open**. 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. {% hint style="info" %} **How do I know the upload(s) worked?** Look for the following icons to distinguish prompts: * ![](/files/0dgmjjBBKXDypevJsY19) **TTS**: Default prompt type. Indicates no audio file is attached. * ![](/files/OQHUn626W2jQ5RPVaOjY) **Audio**: These prompts have an uploaded audio file attached. **Look for these.** {% endhint %} {% hint style="warning" %} **Note:** Any uploaded recordings **will override** any text entered for a survey's prompt field. {% endhint %} ## Step 5: Test the prompts 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.

Figure 4: Select the Play button for each prompt that has it.
Listen to the playback to ensure that each prompt works as intended.

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. ### Troubleshooting If any audio prompts fail, open the survey in the Survey Editor, go to the Audio Manager, and check the following in order: 1. **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. 2. **Is the audio file in a compatible format and file size?** Review the guidelines described under [Audio Prompts](https://docs.plumvoice.com/insight/prompt-manager#audio-prompts) and verify that your audio files match them. 3. **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. ## Conclusion If no issues are found, you've successfully bulk uploaded audio prompts for your survey. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.plumvoice.com/insight/prompt-manager/bulk-uploading-for-audio-prompts.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.