Prerequisites
Start from a clean, working agent.
Multilingual setup updates an existing Vapi assistant. Make sure the current version is ready to become the rollback point before you change it.
Account and agent
Clean starting point
Supported set
Choose two, three, or four unique languages.
Language selection is configured per agent. Enabling it on one agent does not change every agent in the business.
Dashboard setup
Select the languages, review the change, then run the checks.
- 1
Open the caller-language settings
Go to Dashboard → Agents → Edit → 4. Voice, then find Caller languages. - 2
Choose the supported languages
Select between two and four unique languages from the supported set above. - 3
Review the planned update
Confirm that the language set is correct and that the agent has no unrelated unsaved draft changes. - 4
Run checks and enable
KaiCalls updates the language-related prompt and transcriber configuration, then evaluates the updated assistant before keeping it enabled.
Evaluation gate
The built-in checks use text. They are not audio test calls.
KaiCalls runs sequential mock-conversation checks for the selected languages and switching behavior. The result determines whether the update stays in place.
Enabled
Original settings restored
No changes applied
Attention required
Real-world proof
A passing text check is only the first gate. Place real calls next.
Audio behavior, accents, names, addresses, and industry terms need to be heard and reviewed in the same conditions your callers will use.
- Place an inbound test call in every selected language.
- During at least one call, switch naturally between two configured languages.
- Review the recording and transcript for the correct language, names, addresses, and business terms.
- Confirm the agent still follows its qualification, booking, transfer, and fallback instructions.
- Only direct customer traffic to the updated agent after those real-call checks pass.
Troubleshooting
When the update does not enable
The language picker will not continue
Original settings were restored
The result says attention is required
Text passes but the call sounds wrong
For developers
The same protected update is available through the public API.
Send POST /api/v1/agents/enable-multilingual with an API key that has the agents:write scope. The public API body uses agent_id; dashboard code uses agentId.
See the API reference for authentication and request details.
