Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 5 additions & 21 deletions fern/voice-fallback-plan.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,11 @@ slug: voice-fallback-plan

## Introduction

By default, if an assistant's primary voice experiences any failure, Vapi will automatically attempt to use other available voices to continue the call. While this ensures call continuity, you might want more control over which specific voices are used as fallbacks.
Voice fallback plans give you the ability to continue your call in the event that your primary voice fails. Your assistant will sequentially fallback to only the voices you configure within your plan, in the exact order you specify.

Fallback plans give you precise control over the fallback sequence. Your assistant will sequentially fallback to only the voices you configure within your plan, in the exact order you specify.
<Note>
Without a fallback plan configured, your call will end with an error in the event that your chosen voice provider fails.
</Note>

## How It Works

Expand All @@ -22,10 +24,6 @@ When a voice failure occurs, Vapi will:
- Switch to the first fallback voice in your plan
- Continue through your specified list if subsequent failures occur
- Terminate only if all voices in your plan have failed
3. If no custom fallback plan is configured:
- Automatically switch to other available voices
- Continue attempting different voices
- Terminate only if all available voices have failed

## Configuration

Expand Down Expand Up @@ -54,25 +52,11 @@ Add the `fallbackPlan` property to your assistant's voice configuration, and spe
}
```

Although **not recommended**, you may choose to disable the default fallback behavior by providing an empty list of voices in your fallback plan:

```json
{
"voice": {
"provider": "openai",
"voiceId": "shimmer",
"fallbackPlan": {
"voices": []
}
}
}
```

## Best practices

- Use <b>different providers</b> for your fallback voices to protect against provider-wide outages.
- Select voices with **similar characteristics** (tone, accent, gender) to maintain consistency in the user experience.

## How will pricing work?

There is no change to the pricing of the voices. Your call will not incur any extra fees while using fallback voices, and you will be able to see the cost for each voice in your end-of-call report.
There is no change to the pricing of the voices. Your call will not incur any extra fees while using fallback voices, and you will be able to see the cost for each voice in your end-of-call report.
Loading