> ## Documentation Index
> Fetch the complete documentation index at: https://chatbase.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Multilingual AI agent: reply to customers in their language

> How your Chatbase AI agent picks its reply language, how to control it with instructions, and how to localize the Chat Bubble, voice, and Helpdesk.

Your Chatbase AI agent replies in the language the customer writes in, on every channel, with no setting to turn on. You can train it on content in one language and still get answers in another. This page is for anyone serving customers in more than one language: it covers how to control the reply language with instructions, translate the Chat Bubble's interface, set up voice languages, and let your human team read and answer tickets in any language.

## What's built in and what you set up

| Part of the conversation | How it's handled | Where to change it |
| - | - | - |
| The AI agent's replies | Follows the customer's language by default | Your [instructions](#control-the-reply-language-with-instructions) |
| Chat Bubble and Center Stage buttons and menu | Translated for each language you add | [Localization](#translate-the-chat-bubble-interface) |
| Display name, initial messages, suggested messages, footer | Fixed text you write | `setOptions` on your website, per language |
| Voice conversations | Depends on the voice mode and transcriber | [Voice](#voice-languages) |
| Customer messages in Helpdesk tickets | Translated for your team on request | [Helpdesk Translation](#let-your-team-read-and-answer-any-language) |

How well the AI agent handles a given language depends on its [AI model](https://chatbase.co/docs/user-guides/chatbot/models-comparison.md). **Auto**, the default model, has multilingual understanding built in.

## Control the reply language with instructions

There's no reply-language setting. If the default (reply in the customer's language) isn't what you want, say so in **Build > Instructions**. Typical rules:

* Always reply in one language, whatever the customer writes in.
* Reply in the customer's language, but only for the languages your team supports, and fall back to one language for the rest.
* Use a specific register, such as formal German, or a regional variant, such as Brazilian Portuguese.
* Keep product names, plan names, or legal terms untranslated.

**Example** instructions for a store that supports three languages:

```text theme={null}
Reply in the language the customer writes in if it is English, Spanish, or French.
For any other language, reply in English and say that support is available in
English, Spanish, and French.
Always write "Acme Plus" as it is, without translating it.
If the customer switches language mid-conversation, switch with them.
```

To give one channel different rules, open the channel's **Overview** tab and turn off **Sync with global instructions**, then write instructions for that channel only. For example, a WhatsApp number for customers in Brazil can always answer in Brazilian Portuguese while the Chat Bubble follows the customer. Channel-specific instructions replace the global ones, so copy over everything else the channel still needs. See [Instructions and global instructions](https://chatbase.co/docs/user-guides/chatbot/playground.md#instructions-and-global-instructions).

### Data Sources in another language

You don't need a copy of your help content in every language. The AI agent can answer a Spanish question from English [Data Sources](https://chatbase.co/docs/user-guides/chatbot/data-sources.md). Two things are worth checking before you rely on it:

* **Q\&As are sent word for word.** A matching Q\&A reply is sent exactly as you wrote it, so test how your Q\&As behave when the customer writes in another language.
* **Exact wording matters.** Prices, policy terms, and legal text can shift slightly in translation. Test the questions where wording matters most.

## Translate the Chat Bubble interface

The AI agent's replies follow the customer automatically, but the buttons and menus around them come from **Localization**. Center Stage has the same settings.

**1. Open Localization**

Go to **Channels**, click **Manage** on the **Chat Bubble** card, and open the **Display** tab. Scroll to **Localization**.

**2. Choose the language source**

Pick **Visitor's browser** (the default) to use the browser's language, or **Website language** to use the page's `html lang` attribute. Choose **Website language** if your site has its own language switcher, so the Chat Bubble matches the page.

**3. Add your languages**

Click **Add language** for each language you support, including right-to-left languages, and set one as the **default**.

**4. Save and publish**

Save your changes, then **Publish** them so they reach your live Chat Bubble.

Once a language is added, the action buttons and the Chat Bubble menu (**Start a new chat**, **End chat**, **View recent chats**) are translated automatically. So is the **Waiting for support agent to join** message customers see during a [handoff](https://chatbase.co/docs/user-guides/chatbot/actions/chatbase-live-chat.md). If a visitor's language isn't in your list, the Chat Bubble uses your default language.

Text you write yourself, such as the display name, initial messages, message placeholder, footer, dismissable notice, and suggested messages, isn't translated. To show it in the visitor's language, set it from your website with `setOptions`, for example after your own language switcher changes. See [Runtime options](https://chatbase.co/docs/developer-guides/website-integration/chat-interface-control.md#runtime-options) and [Localization](https://chatbase.co/docs/user-guides/chatbot/channels.md#localization).

## Voice languages

[Voice](https://chatbase.co/docs/user-guides/chatbot/voice.md) conversations, in the Chat Bubble or on the phone, depend on the voice mode:

| | Live voice | Classic voice |
| - | - | - |
| Languages | English, Portuguese, French, German, Japanese, Hindi, and Korean | 100+ |
| Transcriber **Language** setting | Doesn't apply | Yes |

In Classic voice, open **Build > Voice** and set the transcriber's **Language**. **Multilingual (auto-detect)** detects the caller's language; picking one language improves accuracy. With the default **Soniox v5** transcriber, you can select up to 8 languages so it focuses on those. In the voice picker, filter by language and use **Preview language** to hear a voice speak each one.

Write the voice **Initial message** and the Live voice **Speaking style** in the language your callers use. See [Transcriber](https://chatbase.co/docs/user-guides/chatbot/voice.md#transcriber).

## Let your team read and answer any language

When a conversation reaches your team in the [Chatbase Helpdesk](https://chatbase.co/docs/user-guides/chatbot/help-desk/help-desk-overview.md), two features help with languages they don't speak:

* **[Translation](https://chatbase.co/docs/user-guides/chatbot/help-desk/translation.md)** detects the customer's language and translates their messages into your team's **Preferred language**, in 44 languages, on tickets from every channel. Turn it on in **Settings > Helpdesk > Translation**. It uses no message credits.
* **AI Compose > Translate** in the reply composer rewrites a teammate's draft into another language before they send it. Translation itself never changes outgoing replies. See [AI Compose](https://chatbase.co/docs/user-guides/chatbot/help-desk/help-desk-overview.md#ai-compose).

The summary your team sees when they [take over](https://chatbase.co/docs/user-guides/chatbot/help-desk/takeover.md) a conversation is written in the customer's language.

## Test each language

1. In the [Playground](https://chatbase.co/docs/user-guides/chatbot/playground.md), ask your real top questions in each language you support, including a switch of language mid-conversation.
2. In **Build > Instructions**, click **Compare** to send the same question to several models and check the reply in each language. See [Compare area](https://chatbase.co/docs/user-guides/chatbot/build.md#compare-area).
3. Add a [Test](https://chatbase.co/docs/user-guides/chatbot/tests.md) per language, for example a simulated user who "writes only in German and wants to return order #1042", with the success criterion "The agent replies in German and explains the return steps."
4. Preview the Chat Bubble with your browser set to each language to check the interface text.

## Frequently asked questions

> [accordion] Does my AI agent automatically reply in the customer's language?
>
> Yes. It replies in the language the customer writes in, on every channel, unless your instructions tell it otherwise. How well it handles a language depends on its [AI model](https://chatbase.co/docs/user-guides/chatbot/models-comparison.md).

> [accordion] Do I need Data Sources in every language?
>
> No. The AI agent can answer in one language from content written in another. Test the questions where exact wording matters, such as prices and policies, and remember that Q\&A replies are sent word for word.

> [accordion] How do I make my AI agent always answer in one language?
>
> Add a rule to **Build > Instructions**, for example "Always reply in English, whatever language the customer writes in." For one channel only, turn off **Sync with global instructions** on that channel and add the rule there.

> [accordion] Why is the Chat Bubble's interface still in English?
>
> The interface is translated only into languages you add under **Localization**, and falls back to your default language otherwise. Your own text, such as initial messages, isn't translated: set it per language with `setOptions`. Also check that you published your changes.

> [accordion] Does Helpdesk Translation translate my team's replies?
>
> No. It translates customer messages for your team to read. To send a reply in the customer's language, use **AI Compose > Translate** in the composer before sending.

> [accordion] Which languages does voice support?
>
> Live voice supports English, Portuguese, French, German, Japanese, Hindi, and Korean. Classic voice supports 100+ languages. See [Voice Mode](https://chatbase.co/docs/user-guides/chatbot/voice.md#voice-mode).

## Related

> [card] [Channels: Localization](https://chatbase.co/docs/user-guides/chatbot/channels.md#localization)
>
> Every Chat Bubble localization setting.

> [card] [Helpdesk Translation](https://chatbase.co/docs/user-guides/chatbot/help-desk/translation.md)
>
> How ticket translation works and which languages it supports.

> [card] [Tone and personality](https://chatbase.co/docs/user-guides/chatbot/behavior/tone-and-personality.md)
>
> Shape how your AI agent sounds in every language.

> [card] [Voice](https://chatbase.co/docs/user-guides/chatbot/voice.md)
>
> Voice modes, transcriber languages, and voices.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.