Skip to main content
Update voice settings, fix mispronunciations, manage cached audio, and tune call behavior to maintain high-quality voice experiences for your callers.

Quick reference

Changing your agent’s voice

Consider updating when your brand refreshes, customers report clarity issues, you’re expanding to new languages, or newer voice models become available.
  1. Go to Voice > Settings
  2. Click Change to open the Voice Library
  3. Filter by Language, Region, and Gender
  4. Preview voices with custom text
  5. Click Select to apply
  6. Test in Agent Chat before publishing
For non-English projects, use a multilingual_v2 model to ensure proper language support.
For programmatic voice configuration, see voice classes and Add a voice.

Barge-in

Toggle in Voice > Advanced settings > Call. Lets callers interrupt the agent mid-sentence. Enable when: callers frequently interrupt, or you want more natural conversations. Disable when: delivering complete information (legal disclaimers), background noise causes false interruptions.

Managing audio quality

Cached audio

The Audio library tab lets you cache and optimize frequently-used audio for reduced latency and consistent quality.
  • Open Voice > Audio library
  • Click Edit to adjust stability/clarity settings or add IPA pronunciation corrections
  • Click the sync icon to regenerate, then preview
Audio is only cached after the same TTS is generated at least twice in 24 hours. For critical phrases (greetings, transfers), generate them repeatedly or upload manually.

Custom audio uploads

Upload pre-recorded audio (WAV or MP3) for maximum control over greetings, legal disclaimers, or brand-specific moments.

Fixing pronunciations

When the agent mispronounces words:
  1. Go to Voice > Advanced settings > SpeechPronunciation section
  2. Add a pronunciation rule
  3. Enter the regex pattern for the word as it appears in text
  4. Provide the IPA replacement (e.g., “PolyAI” → /ˈpɒli eɪ aɪ/)
  5. Test in Agent Chat
You can also use SSML for advanced control:

Troubleshooting

Maintenance routine

  • Monthly: Listen to recent calls and identify voice quality issues
  • As needed: Add pronunciations for new terms
  • After voice changes: Regenerate cached audio
Last modified on June 29, 2026