Vonage | Rasa Documentation

Build your first agent in just a few minutes with Rasa Copilot.

New in 3.17

The Vonage connector has been made generally available in Rasa Pro 3.17.

Use this channel to connect your Rasa assistant to Vonage. Vonage is a cloud communications platform that provides Voice APIs and phone numbers.

Basic Rasa configuration

Create or edit your credentials.yml and add a new channel configuration:

vonage:
  server_url: "<your-domain>"
  username: "<username>"
  password: "<password>"
  asr:
    name: "deepgram"  # or "azure"
    # ASR-specific configuration
  tts:
    name: "deepgram"  # or "cartesia", "azure"
    # TTS-specific configuration
  interruptions:  # optional
    enabled: true
    min_words: 3

You can run that assistant using rasa run. To configure the Vonage channel, you will need a URL to your Rasa assistant. You can use a tunneling solution like ngrok to expose your assistant for development.

Configuring Vonage

To route calls to your Rasa assistant, you need to have a Vonage account and a phone number.

  1. Sign up for Vonage APIs.
  2. Once logged in, buy or port your number to Vonage.
  3. Create an Application with Voice capabilities. To route calls to your assistant, Vonage needs an Answer webhook URL and Event webhook URL. You'll either need to deploy your assistant to a server or use a tunneling solution like ngrok for development.

The Answer webhook URL will be in the format wss://<your-server>/webhooks/vonage/webhook or if using ngrok, it will look like this: wss://recently-communal-duckling.ngrok-free.app/webhooks/vonage/webhook

The Event webhook URL will be in the format wss://<your-server>/webhooks/vonage/call_status or in the case of ngrok look like this: wss://recently-communal-duckling.ngrok-free.app/webhooks/vonage/call_status

  1. After saving the application, in the Link numbers section, link the chosen number to your application.

Usage

You can call the Vonage number from any other number in order to talk to the deployed bot.

Audio format

The default audio format on Vonage channel is Linear 16 bit 24KHz PCM mono