Skip to main content
Build Agents with VAW Native

Choose the Agent's Language

Set the language your VAW Native agent listens for: auto-detect for mixed callers, or a fixed language for accuracy and boosted words.

Written By voiceaiwrapper

Last updated 26 days ago

The Language setting tells your agent which language callers will speak, so it can understand them accurately. You can let the agent detect the language on each call, or fix it to one language. This article explains which to choose and how the choice affects your voice, your voice model and your boosted words.

Applies to: agents on a VAW Native Pod (an engine or provider connection). For Vapi, Retell AI and ElevenLabs agents, language is set in the provider's own account. See How Provider Agents Appear in VoiceAIWrapper.

Before you start

How the language setting works

The language setting controls how the agent hears callers: it turns their speech into text. It doesn't make the agent reply in that language. The agent speaks the language of your greeting and prompt, so write those in the language you want, or tell the agent in the prompt which language to use. See Write the Prompt and Greeting.

Agents you create from scratch start on Auto-detect. The AI Agent Builder sets the language from your answers.

Auto-detect or a fixed language?

OptionBest forKeep in mind
Auto-detectCallers who speak different languages, or switch between them mid-call.Covers English, Spanish, French, German, Hindi, Russian, Portuguese, Japanese, Italian and Dutch only. Boosted words are ignored.
A fixed languageCallers who all speak one language.Needed for any language outside the Auto-detect list, and for boosted words.

Choose a fixed language when:

  • Your callers speak a language Auto-detect doesn't cover, such as Arabic, Chinese, Korean, Polish or Turkish. Auto-detect won't understand them.
  • You use boosted words. Boosted words help the agent recognise names and terms like product names. They only work with a fixed language. See Fine-Tune Conversation Behaviour.
  • You want a specific regional variant, such as English (UK) or Portuguese (Brazil).
  • You want the English-only voice model. Flash v2 can only be used when the language is set to English. See Choose a Voice for Your Agent.

Languages you can choose

Besides Auto-detect, the list offers:

  • English, English (US), English (UK), Spanish, French, German, Hindi, Portuguese, Portuguese (Brazil), Portuguese (Portugal), Dutch, Italian, Japanese, Polish, Turkish, Chinese, Korean, Russian, Indonesian, Danish and Hungarian.
  • Arabic, Bulgarian, Croatian, Czech, Filipino, Finnish, Greek, Malay, Norwegian, Romanian, Slovak, Swedish, Ukrainian and Vietnamese.
  • Afrikaans, Armenian, Belarusian, Bosnian, Cantonese, Catalan, Estonian, Georgian, Hebrew, Kazakh, Latvian, Lithuanian, Macedonian, Mongolian, Nepali, Pashto, Persian, Serbian, Slovenian and Thai. Only the Eleven v4 Turbo, Eleven v3 Conversational and Eleven v3 voice models can speak these. See "The voice model must speak the language" below.

Change the language

  1. In the sidebar, open Agents and click your agent.
  2. On the Agent Settings tab, click the Language row. The Language sheet shows your Current language.
  3. Click the current language to open Select language.
  4. Click the language you want. The sheet returns to its main view.
  5. Click Save changes in the sheet's footer or on the Unsaved changes bar.
Agent page β†’ Agent Settings β†’ Language row clicked β†’ Select language view. The header shows 'Select language' with the Auto-detect coverage note underneath, and the list of languages with flags starts with Auto-detect, English, English (US), English (UK), Spanish. One language is selected (blue border and check mark).

Test a call in the new language before you send real callers to the agent. See Test Your Agent: Web Calls, Phone Calls and Chat.

Match the voice to the language

Every voice can speak every language, but a voice made for your language sounds the most natural. Once you fix a language:

  • The voice library opens on the voices made for that language. If none is made for it yet, the library says so and shows every voice.
  • If your current voice isn't made for it, the Voice sheet warns: "{name} isn't made for {language}, so callers may hear a slight accent." Click See {language} voices to pick a better match.

For agents on Auto-detect, choose a voice that is made for several languages. The Language sheet notes: "Multilingual voices work with any language. Voices marked for specific languages sound best in those." See Choose a Voice for Your Agent.

The voice model must speak the language

The voice model is what turns the agent's replies into speech, and not every model speaks every language. For example, Flash v2.5 (the default) doesn't speak Thai or Hebrew, and Flash v2 only speaks English.

  • If you never picked a voice model, you don't need to do anything. The agent automatically uses a model that speaks the new language.
  • If you picked a model that can't speak the new language, the Language and Voice sheets show an amber note, for example "Flash v2.5: Doesn't speak Thai, your agent's language." Click Use {model} in the note to switch to one that can, then save. You can't save the language change until you do.

Frequently asked questions

The language setting only controls how the agent understands callers. Write the greeting and prompt in Spanish, or add an instruction such as "Always reply in Spanish" to the prompt. Then save and test again.

The agent can only understand the languages in the list. If you choose Auto-detect for a language outside its ten, the agent won't understand those callers reliably.

Your saved voice model probably doesn't speak the new language. Open the Language or Voice sheet, click Use {model} in the amber note, and save again.

Check the Language row on the Agent Settings tab. If it says Auto-detect, boosted words are ignored. Pick a fixed language and save.

Yes. Leave the language on Auto-detect, pick a voice made for both languages, and tell the agent in the prompt to reply in the caller's language. Boosted words won't apply in this setup.