Skip to main content
Vonage sends a webhook when a call arrives. Rapida responds with an NCCO (Nexmo Call Control Object) containing a connect action that opens a WebSocket carrying Linear PCM 16kHz audio — higher quality than Twilio’s μ-law.

​
Vault Credentials

In the Rapida dashboard go to Credentials → Create Credential, select provider type Vonage:
KeyDescription
api_keyVonage API key
api_secretVonage API secret
application_idVonage Application ID (required for JWT auth on outbound)
private_keyVonage Application private key — PEM string (required for JWT auth on outbound)

​
Setup

1

Set the required env var

# docker/assistant-api/.assistant.env
PUBLIC_ASSISTANT_HOST=your-hostname.com
2

Create a Vonage Voice Application

In the Vonage Dashboard → Applications → Create a new application, enable Voice capability and set:
FieldValue
Answer URL (POST)https://{PUBLIC_ASSISTANT_HOST}/v1/talk/vonage/call/{assistantId}
Event URL (POST)https://{PUBLIC_ASSISTANT_HOST}/v1/talk/vonage/ctx/{contextId}/event
Download the private key and save it in the vault credential.
3

Link a Vonage number

In Numbers, assign a virtual number to the application.
4

Attach vault credential to the assistant

In the assistant’s Phone Deployment, select the Vonage vault credential.
5

Test inbound call

Call your Vonage number. Rapida responds with:
[{
  "action": "connect",
  "endpoint": [{
    "type": "websocket",
    "uri": "wss://{PUBLIC_ASSISTANT_HOST}/v1/talk/vonage/ctx/{contextId}",
    "content-type": "audio/l16;rate=16000"
  }]
}]

​
Audio Spec

PropertyValue
EncodingLinear PCM 16-bit
Sample rate16000 Hz
ChannelsMono
TransportRaw binary WebSocket frames
Vonage uses 16kHz Linear PCM — higher quality than Twilio’s 8kHz μ-law. This can improve STT accuracy for providers that support 16kHz input.

ngrok — Local Testing

Expose localhost to Vonage for development

Twilio

Alternative global PSTN provider

Telephony Overview

All providers and URL routing reference

Configuration

PUBLIC_ASSISTANT_HOST and other env vars