Vonage

Vonage (now part of Ericsson) is a cloud communications platform providing programmable voice, messaging, and video APIs. Rapida integrates with Vonage to enable AI-powered phone conversations using Vonage’s WebSocket media streaming.

Vonage uses WebSocket audio streams for real-time media. When a call connects, Vonage opens a WebSocket to Rapida carrying linear PCM audio. Rapida handles all codec conversion and resampling transparently.

How It Works

Prerequisites

Vonage Account

An active Vonage account with at least one phone number and a Vonage Application

Rapida Account

An active Rapida account with a configured voice assistant

You will need your Vonage Application ID and Private Key, which you can find in the Vonage API Dashboard.

Step 1: Set Up Provider Credentials

Store your Vonage API credentials in Rapida so the platform can authenticate with Vonage for outbound calls and webhook handling.

Navigate to External Integrations

Go to Integration > Tools in the Rapida dashboard. You will see a grid of available external integrations.

Select Vonage

Find the Vonage card and click “Setup Credential”.

Enter Your Vonage Credentials

A modal will appear. Fill in the following fields:

Field	Description	Where to Find
Key Name	A friendly name for this credential (e.g., “Production Vonage”)	Your choice
Application ID	Your Vonage Application ID	Vonage Dashboard → Applications → Your App
Private Key	Your Vonage Application private key (full PEM content)	Downloaded when creating the Vonage Application

Click “Configure” to save.

The private key is the full PEM file content, not just a token. It typically begins with -----BEGIN RSA PRIVATE KEY-----. Paste the entire contents.

Verify Connection

After saving, the Vonage card should display “Connected”. Click on it to see credential details, last updated time, and management options.

Step 2: Configure Phone Deployment

With credentials saved, configure your assistant’s phone deployment to use Vonage.

Open Your Assistant

Navigate to Assistants and select the assistant you want to deploy via phone.

Go to Phone Deployment

Click “Deploy” → “Phone” to open the phone deployment configuration page.

Select Vonage as Telephony Provider

In the Telephony section:

Select Vonage from the telephony provider dropdown
Choose the Vonage credential you created in Step 1 from the Credential dropdown
Enter your Phone number — the Vonage virtual number for inbound calls and outbound caller ID (e.g., +15551234567)

Configure Experience Settings

Set up the conversation experience:

Setting	Description	Default
Greeting	The first message the AI speaks when answering	(optional)
Error Message	Message spoken when an error occurs	(optional)
Idle Timeout	Seconds before prompting an idle caller	`30`
Idle Message	Message spoken when caller is idle	`"Are you there?"`
Idle Timeout Retries	How many times to retry before ending call	`2`
Max Call Duration	Maximum call length in seconds	`300`

Configure Audio Providers

Select your Speech-to-Text (STT) and Text-to-Speech (TTS) providers. These determine how audio is transcribed and synthesized during the call.

Save Deployment

Click “Deploy” to save. Your assistant is now ready to handle phone calls via Vonage.

Step 3: Configure Your Vonage Application

Point your Vonage Application’s webhook URLs to Rapida so incoming calls are routed to your AI assistant.

Open Vonage Dashboard

Go to Vonage Dashboard → Applications and select your application.

Set Voice Webhooks

Under Capabilities → Voice, configure:

Field	Value
Answer URL	`https://websocket-01.in.rapida.ai/v1/talk/vonage/call/{your-assistant-id}?x-api-key={your-api-key}`
Event URL	`https://websocket-01.in.rapida.ai/v1/talk/vonage/ctx/{contextId}/event?x-api-key={your-api-key}`
HTTP Method	`POST`

Replace {your-assistant-id} with your Rapida assistant ID.

Link Phone Number

Under Numbers, link your Vonage virtual number to this application so inbound calls are routed through it.

Save

Click Save in the Vonage dashboard. Your phone number is now connected to Rapida.

Making Outbound Calls

Once your phone deployment is configured, you can initiate outbound calls using the Rapida API or SDKs.

Python
Node.js
cURL

from rapida import Rapida

client = Rapida(api_key="rpd-xxx-your-key")

call = client.calls.create(
    assistant_id=123456789,
    to_number="+15551234567",
    from_number="+15559876543",  # optional, uses deployment default
    metadata={"campaign": "follow-up"},
)

print(f"Call queued: conversation_id={call.conversation.id}")

import { Rapida } from 'rapida';

const client = new Rapida({ apiKey: 'rpd-xxx-your-key' });

const call = await client.calls.create({
  assistantId: 123456789,
  toNumber: '+15551234567',
  fromNumber: '+15559876543',
  metadata: { campaign: 'follow-up' },
});

console.log(`Call queued: ${call.conversation.id}`);

curl -X POST https://api.rapida.ai/v1/talk/call \
  -H "Authorization: Bearer rpd-xxx-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant": { "assistant_id": 123456789 },
    "to_number": "+15551234567",
    "from_number": "+15559876543",
    "metadata": { "campaign": "follow-up" }
  }'

Features

Feature	Description
Inbound Calls	Customers call your Vonage number and speak with your AI assistant
Outbound Calls	Initiate calls programmatically via SDK or API
Real-time Streaming	Bidirectional audio via Vonage WebSocket streams
Call Recording	Automatic conversation capture for review and compliance
Status Callbacks	Receive call lifecycle events via Vonage event webhooks
Number Insight	Get detailed information about phone numbers
Global Numbers	Use Vonage virtual numbers from 80+ countries

Troubleshooting

Calls don't reach Rapida

Verify the Answer URL in your Vonage Application settings
Ensure the URL uses https:// and the correct assistant ID
Confirm the phone number is linked to the correct Vonage Application

One-way audio or no audio

Verify your Vonage credential (Application ID + Private Key) is correct in Rapida
Ensure the private key is the complete PEM content
Check that your STT and TTS providers are configured in the phone deployment

Outbound calls fail

Verify the Vonage credential is connected in Integration > Tools
Ensure the from_number is a valid Vonage number linked to your application
Check that the phone deployment is configured and saved

Event callbacks not received

Ensure the Event URL is configured in Vonage Application settings
Verify the URL format includes the correct path
Check the Vonage API Dashboard for webhook delivery logs

Create an Assistant

Build your voice AI assistant

Phone Deployment

Overview of phone deployment options

Outbound Call API

API reference for creating calls

Conversation Logs

View call history and transcripts

For more information on Vonage’s platform, visit the Vonage API Developer Documentation.

Getting Started

Assistants

Knowledge

LLM Endpoint

Activity and logs

External Integrations

Credentials

Workspace

Governance

Deployment Options

How It Works

Prerequisites

Vonage Account

Rapida Account

Step 1: Set Up Provider Credentials

Step 2: Configure Phone Deployment

Step 3: Configure Your Vonage Application

Making Outbound Calls

Features

Troubleshooting

Create an Assistant

Phone Deployment

Outbound Call API

Conversation Logs

Getting Started

Assistants

Knowledge

LLM Endpoint

Activity and logs

External Integrations

Credentials

Workspace

Governance

Deployment Options

​How It Works

​Prerequisites

Vonage Account

Rapida Account

​Step 1: Set Up Provider Credentials

​Step 2: Configure Phone Deployment

​Step 3: Configure Your Vonage Application

​Making Outbound Calls

​Features

​Troubleshooting

​Related Resources

Create an Assistant

Phone Deployment

Outbound Call API

Conversation Logs

How It Works

Prerequisites

Step 1: Set Up Provider Credentials

Step 2: Configure Phone Deployment

Step 3: Configure Your Vonage Application

Making Outbound Calls

Features

Troubleshooting

Related Resources