Build your first agent in just a few minutes with [Rasa Copilot](https://hello.rasa.com/?utm_source=docs&utm_medium=referral&utm_campaign=docs_cta).

### 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](https://developer.vonage.com/). 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:

```yaml
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](https://ngrok.com/) 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](https://dashboard.vonage.com/).
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](https://ngrok.com/) 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`

4. 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**