You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: fern/voice-fallback-plan.mdx
+5-21Lines changed: 5 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,9 +10,11 @@ slug: voice-fallback-plan
10
10
11
11
## Introduction
12
12
13
-
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.
13
+
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.
14
14
15
-
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.
15
+
<Note>
16
+
Without a fallback plan configured, your call will end with an error in the event that your chosen voice provider fails.
17
+
</Note>
16
18
17
19
## How It Works
18
20
@@ -22,10 +24,6 @@ When a voice failure occurs, Vapi will:
22
24
- Switch to the first fallback voice in your plan
23
25
- Continue through your specified list if subsequent failures occur
24
26
- Terminate only if all voices in your plan have failed
25
-
3. If no custom fallback plan is configured:
26
-
- Automatically switch to other available voices
27
-
- Continue attempting different voices
28
-
- Terminate only if all available voices have failed
29
27
30
28
## Configuration
31
29
@@ -54,25 +52,11 @@ Add the `fallbackPlan` property to your assistant's voice configuration, and spe
54
52
}
55
53
```
56
54
57
-
Although **not recommended**, you may choose to disable the default fallback behavior by providing an empty list of voices in your fallback plan:
58
-
59
-
```json
60
-
{
61
-
"voice": {
62
-
"provider": "openai",
63
-
"voiceId": "shimmer",
64
-
"fallbackPlan": {
65
-
"voices": []
66
-
}
67
-
}
68
-
}
69
-
```
70
-
71
55
## Best practices
72
56
73
57
- Use <b>different providers</b> for your fallback voices to protect against provider-wide outages.
74
58
- Select voices with **similar characteristics** (tone, accent, gender) to maintain consistency in the user experience.
75
59
76
60
## How will pricing work?
77
61
78
-
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.
62
+
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.
0 commit comments