> ## 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.

# Translate customer messages automatically in the Helpdesk

> Automatically detect and translate customer messages so your team can support anyone, in any language.

Helpdesk Translation lets your support team read customer messages in any of 44 languages. When it's on, the Chatbase Helpdesk detects the language a customer writes in and offers one-click translation of their messages into your team's preferred language, on tickets from every channel. It's set per AI agent and included on every plan with the Helpdesk (Basic plan or higher).

Only **customer messages** are translated. Agent replies remain in the language the agent writes them in.

## How Translation works

* **No credits:** translating and detecting languages uses no message credits.
* **One language per AI agent:** the **Preferred language** is a single setting on the AI agent, shared by every teammate.
* **Saved and shared:** each translation is saved on the message and reused for every teammate who views the ticket, so it isn't translated again. Each viewer still clicks **Translate** (or **Show original**) to switch their own view.

## Enable Translation

**1. Open translation settings**

Navigate to **Settings** > **Helpdesk** > **Translation**.

**2. Enable AI translation**

![Translation settings page showing the Enable button and how-it-works overview](https://mintcdn.com/chatbase/IdwsKzBZnpFWWv1e/user-guides/images/help-desk/translate/translation-enable.png?fit=max\&auto=format\&n=IdwsKzBZnpFWWv1e\&q=85\&s=2d45531e148c3465b820ec4a0c787def)

**3. Choose your preferred language**

Select your team's **Preferred language** from the dropdown. This is the language customer messages are translated into, for every teammate on this AI agent.

![Translation settings with AI translation toggle enabled and preferred language set to English](https://mintcdn.com/chatbase/IdwsKzBZnpFWWv1e/user-guides/images/help-desk/translate/translation-settings.png?fit=max\&auto=format\&n=IdwsKzBZnpFWWv1e\&q=85\&s=936e412997881757de6562d74d8293f0)

**4. Save**

Click **Save** to apply your settings. Translation is now active for all tickets.

To disable translation at any time, toggle **AI translation** off and click **Save**.

## How Translation Works in Tickets

When you open a ticket from a customer who wrote in a different language, the Helpdesk automatically detects the language and shows a **translation detection banner** at the top of the ticket.

Detection works like this:

* The Helpdesk reads the ticket's first 5 customer messages together and detects one language for the ticket.
* The banner appears only when the detected language differs from your preferred language **and** detection is confident. Very short messages may not give a confident result, so no banner appears.
* The detected language is saved on the ticket and isn't detected again.

### Before Translation

The banner displays the detected language (e.g., "German detected") along with a **Translate** button. Customer messages appear in their original language.

![Ticket view showing a detected language banner with Arabic messages and a Translate button](https://mintcdn.com/chatbase/IdwsKzBZnpFWWv1e/user-guides/images/help-desk/translate/translation-detected.png?fit=max\&auto=format\&n=IdwsKzBZnpFWWv1e\&q=85\&s=17da6aaf215ec480f12a9c5a33da6d97)

### After Translation

Click **Translate** to translate all customer messages into your preferred language. Each message is translated on its own, from whatever language it's written in, so a conversation that mixes languages is handled message by message. The banner updates to show the translation direction (e.g., "Translating German → English") and a **Show original** button appears so you can switch back at any time.

![Ticket view showing translated messages in English with the Show original button](https://mintcdn.com/chatbase/IdwsKzBZnpFWWv1e/user-guides/images/help-desk/translate/translation-translated.png?fit=max\&auto=format\&n=IdwsKzBZnpFWWv1e\&q=85\&s=28bb4213705c6603cb31ee55e81591db)

> [!NOTE]
>
> If you are viewing a ticket with an active live chat, new incoming messages from the customer will be **translated automatically** as they arrive, with no need to click Translate again.

### Toggle Between Original and Translated

You can switch between the original and translated versions at any time using the buttons in the translation banner:

* **Show original**: displays the customer's messages in their original language
* **Translate**: switches back to the translated view

### Translate Button in the Ticket Header

The ticket header has its own translate button, an icon next to **Update status**. Click it to translate the conversation, and click it again to show the original. Its tooltip names the current action: **Translate conversation** or **Show original**.

The button appears only on tickets where a different language was detected, the same tickets that show the translation banner.

## What Gets Translated

| Content | Translated? |
| - | - |
| Customer messages, on every channel (email, Chat Bubble, WhatsApp, Messenger, Instagram, Phone, Center Stage, API, and comments) | Yes. For email, the email body is translated. |
| Ticket subject | No |
| Attachments and text inside images | No |
| Agent replies | No |
| Internal notes | No |
| System events (status changes, assignments) | No |

> [!WARNING]
>
> Only customer messages are translated. Your replies are sent to the customer exactly as you write them. If you need to reply in the customer's language, use the **AI Compose > Translate** option in the message composer. It rewrites your draft with AI before you send it, uses no message credits, and is separate from the Translation setting.
>
> ![Ticket view showing translated messages in English with the Show original button](https://mintcdn.com/chatbase/IdwsKzBZnpFWWv1e/user-guides/images/help-desk/translate/ai-compose-translate-select.png?fit=max\&auto=format\&n=IdwsKzBZnpFWWv1e\&q=85\&s=d2f6ad7c7362934c4a0e351e9e2893af)
>
> ![Ticket view showing translated messages in English with the Show original button](https://mintcdn.com/chatbase/IdwsKzBZnpFWWv1e/user-guides/images/help-desk/translate/ai-compose-translated-text.png?fit=max\&auto=format\&n=IdwsKzBZnpFWWv1e\&q=85\&s=26d6cd43750e059be0f436b902be3cbb)

## Supported Languages

Translation supports **44 languages**. The **Preferred language** list has 45 entries because it includes **German (Formal)**, which is translated as standard German.

* Arabic
* Bengali
* Bulgarian
* Bosnian
* Catalan
* Chinese (Simplified)
* Chinese (Traditional)
* Croatian
* Czech
* Danish
* Dutch
* English
* Estonian

- Finnish
- French
- German
- Greek
- Hebrew
- Hindi
- Hungarian
- Indonesian
- Italian
- Japanese
- Korean
- Latvian
- Lithuanian

* Malay
* Mongolian
* Norwegian
* Persian
* Polish
* Portuguese
* Portuguese (Brazil)
* Romanian
* Russian
* Serbian
* Slovenian
* Spanish
* Swahili

- Swedish
- Thai
- Turkish
- Ukrainian
- Vietnamese

Right-to-left (RTL) languages such as Arabic, Hebrew, and Persian are fully supported.

## Frequently asked questions

> [accordion] Does Helpdesk translation use message credits?
>
> No. Translating customer messages, detecting their language, and the **AI Compose > Translate** option in the composer all use no message credits.

> [accordion] Can each teammate choose their own language?
>
> No. **Preferred language** is one setting per AI agent, shared by everyone who works on its tickets. To read tickets in another language, change the setting for the whole team.

> [accordion] Are Messenger, Instagram and Phone messages translated?
>
> Yes. Every customer message on a ticket can be translated, whatever the channel. Agent replies and internal notes aren't translated.

> [accordion] Why don't I see the language banner on a ticket?
>
> The banner only appears when the detected language differs from your preferred language and detection is confident. Short messages may not give a confident result. The detected language is saved on the ticket the first time, so it isn't detected again later.

> [accordion] Are ticket subjects and attachments translated?
>
> No. Only the message body is translated. Subjects, attachments and text inside images stay in the original language.


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