Adding Voice Messages: Uploading and Managing Audio Files (.WAV)

In Voice (IVR) flows, audio quality can make or break the caller experience. RapidPro.app lets you attach your own recorded audio to a Play Message action so callers hear a clear, human voice instead of text-only prompts. This guide shows you how to record, convert, upload, and preview your audio files.

Add audio to Play Message actions

If you just need the essentials, follow this quick path:

  1. Record a clean voice clip (short, one idea per file)
  2. Convert the recording to .WAV (recommended for compatibility)
  3. Upload the .WAV inside a Play Message action
  4. Preview the audio and confirm clarity/volume
  5. Troubleshoot upload or playback issues

Clear audio improves caller trust and reduces keypad mistakes during IVR navigation.

Step-by-Step Process

1
Record your audio message

  1. Use a microphone or headset in a quiet room.
  2. Record your message using a basic tool (for example: QuickTime on macOS, Voice Recorder on Windows).
  3. Save the file locally with a clear name (example: ivr_menu_main_v1.mp3).
đź’ˇ
Tip: Keep each audio clip short (one idea per clip). It’s easier to reuse, swap, and update later.

2
Convert the file to WAV

  1. Open an audio converter tool (desktop app or trusted online converter).
  2. Upload your recorded file (MP3/M4A/etc.).
  3. Convert it to WAV.
  4. Download the converted .wav file to your computer.
⚠️
Warning: If your audio format isn’t supported, it may upload but fail to play during calls. Converting to WAV is the safest option.

3
Upload the audio in a Play Message action

  1. Open your Voice (IVR) flow in the flow editor.
  2. Add (or select) a Play Message action.
  3. Click Upload Recording.
  4. Select your .wav file and confirm the upload.

[CAPTURE: Voice flow editor showing a Play Message action with an “Upload Recording” button and a selected WAV file.]

⚙️
Technical Detail: Each uploaded recording is attached to that specific Play Message step, so you can mix different audio files across your IVR flow.

4
Preview the audio before testing calls

  1. After upload, find the play control on the audio attachment.
  2. Click Play to listen and confirm:
  • Volume is clear
  • The message is complete
  • The correct file was uploaded

[CAPTURE: Play Message action showing an uploaded recording with a play button visible.]

đź’ˇ
Tip: If you notice noise or inconsistent volume, re-record and re-upload a cleaner clip instead of trying to “fix it later” in the flow.

Common Issues & Quick Fixes

The recording won’t upload

Fix:

  • Confirm the file is .WAV (convert again if needed).
  • Rename the file to a simple name (avoid special characters).
  • Try a smaller file (shorter recording) and re-upload.
The audio uploads, but won’t play during calls

Fix:

  • Re-convert the audio to WAV and upload the new version.
  • Re-check the Play Message action to ensure the correct file is attached.
  • Test using a real call and review call/session logs for errors.
The audio sounds low or unclear

Fix:

  • Re-record with the mic closer and reduce background noise.
  • Speak slightly slower and leave a short pause at the start/end.
  • Split long recordings into shorter clips.