> ## Documentation Index
> Fetch the complete documentation index at: https://rasa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Vonage

> Connecting to the Vonage Voice API

<Info>
  **New in 3.17**

  The Vonage connector has been made generally available in Rasa Pro 3.17.
</Info>

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 title="credentials.yml" theme={null}
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.

<Info>
  **Bot URLs for development**

  Visit this [section](/docs/reference/channels/messaging-and-voice-channels#testing-channels-on-your-local-machine) to learn how to generate
  the required bot URL when testing the channel on your local machine.
</Info>

## 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**


## Related topics

- [Call Recording](/docs/reference/config/call-recording.md)
- [Connecting to Messaging and Voice Channels](/docs/reference/channels/messaging-and-voice-channels.md)
- [Rasa Pro Change Log](/docs/reference/changelogs/rasa-pro-changelog.md)
- [Speech Integrations](/docs/reference/integrations/speech-integrations.md)
- [Custom Connectors](/docs/reference/channels/custom-connectors.md)