Connect a Vonage voice number for IVR
If you just need the essentials, follow this quick path:
- Buy a Vonage virtual number with Voice capability enabled
- Start adding a Vonage channel in RapidPro.app
- Connect your Vonage account (API Key + Secret)
- Select and connect the phone number
- Troubleshoot missing IVR options, number availability, and audio issues
Once the channel is connected, you can create and test Voice (IVR) flows using your Vonage number.
Step-by-Step Process
1
Create a Vonage account and purchase a voice-enabled number
- Sign up for a Vonage account (or sign in).
- In the Vonage APIs dashboard, open Numbers (left sidebar).
- Select Buy Numbers.
- Follow the purchase steps and make sure Voice capability is enabled.
- (Optional) Choose a toll-free number if it fits your use case and is available.
[CAPTURE: Vonage dashboard → Numbers → Buy Numbers with Voice capability selected.]
2
Start adding a Vonage channel in RapidPro.app
- Open Workspace Settings in RapidPro.app.
- Click + New Channel (top-right).
- Scroll to the Vonage section and select it.
[CAPTURE: Add Channel page showing the Vonage option.]
3
Connect your Vonage account (first-time setup)
If this is your first time connecting Vonage to this workspace:
- Enter your Vonage API Key and API Secret (from your Vonage account settings).
- Save to link your Vonage account to the workspace.
[CAPTURE: Vonage channel setup screen showing API Key + Secret fields.]
4
Select and connect the phone number
After connecting your account, you’ll be prompted to connect a number:
- Choose the country from the dropdown to list available numbers.
- (Optional) Use the Pattern field if you’re searching for a specific format.
- Select the number you want and finish setup.
Result: Once connected, you’re ready to run Voice (IVR) flows using that Vonage number.
[CAPTURE: Number selection screen showing Country dropdown and optional Pattern input.]
Common Issues & Quick Fixes
Voice (IVR) flow options don’t appear
- Confirm the number you purchased is voice-enabled (Voice capability enabled in Vonage).
- Confirm the channel is added and Enabled in Workspace Settings → Channels.
I can’t find my Vonage API Key / Secret
- Open your Vonage account settings page and copy the API Key and API Secret.
- Make sure you’re in the Vonage APIs dashboard (not a different Vonage product area).
I don’t see any available numbers for my country
- Try a different country/region selection.
- If availability is limited, consider an alternative provider or test IVR using an Android channel (if that’s part of your workflow).
Calls connect, but audio isn’t what I expect
- Confirm your flow uses the correct Voice (IVR) actions (Play Message, Menu Selection, Wait for Audio, etc.).
- If you’re uploading recordings, verify they’re in the supported format (see the audio upload guide).