How do I translate an agent into other languages?

How do languages work?

An agent can be offered in 19 languages: English, Turkish, Arabic, German, French, Spanish, Portuguese, Dutch, Finnish, Greek, Hindi, Indonesian, Italian, Japanese, Korean, Norwegian, Polish, Russian and Swedish. You write the texts in one language, called the agent's main language; the other languages are translations of it. A new agent's main language is your panel's language. Ready-made agents come in your panel's language only; add other languages with the “Languages” button.

Visitors see the agent in their own language. If a text has no translation, it's shown in the main language.

The language settings are on the “Flow” tab, in the strip above the canvas. It starts with the “Languages” button, where you add and remove languages, followed by the “Editing language” menu that chooses which language you're editing, and the “Translate” button.

Translating an agent

1. Write and finish the texts in the main language.
2. To add another language, press “Languages”, tick the language and press “Save”; the new language is translated right away. To remove a language, untick it and press “Save”; you're asked to confirm first. The number on the “Translate” button shows how many texts are waiting for translation; each language is counted separately. Only new or changed texts are translated.
3. When it finishes, choose a language in the “Editing language” menu. Check the texts and fix them directly in the boxes if needed.
4. Press “Save”. Visitors get the translations when you press “Publish”.

If some texts couldn't be translated, a warning tells you which language is missing them; press “Translate” again to translate only the rest. If there's nothing to translate, “Translations are up to date” appears.

Translation uses credits. The spend appears under “Translation” on the “Spending” tab of the “Plan” page. Since each press translates only new and changed texts, you don't pay for the whole agent again and again.

Fixing translations by hand

When you pick another language, the boxes show that language's text. What you type becomes that language's translation, and the next “Translate” won't change it.

When you change an original text, the translation box shows “The original text changed; this translation may be outdated.” The text is translated again on the next “Translate”; until then visitors see the old translation.

To redo all translations, press the arrow next to “Translate” and choose “Retranslate everything”. Translations you fixed by hand change too; if you don't like the result, go back with “Undo”. This uses credits again for all texts.

What is and isn't translated?

Every text visitors see is translated: step texts, options, buttons, form fields, wait texts and the agent's name. Not translated:

• The AI Assistant step's instructions. The agent already replies in the language the visitor writes in, in any language, not only the agent's languages.
• {variable} placeholders in texts; they stay as they are.
• Options that come from a data source. Your source can get the visitor's language with {visitorLang} and reply in it.
• Subflows. Translate each subflow in its own editor.

Changing the main language

If you actually wrote the texts in another language, press the “Languages” button in the strip and choose the right one in the “Main language” box. If that language has no translations, it changes right away. If it does, you're asked how to change it:

• “Use the {language} translations as the original text”: that language's translations become the original text, and the current texts stay as the old language's translation.
• “The texts are already in {language}, just fix the language”: only the language label is fixed; that language's translations are removed and the other languages keep theirs.

Choosing the main language correctly matters: translation is done from it, and texts with no translation are shown to visitors in it.

Which language does the visitor see?

• If the link opens with a language prefix (e.g. /en/… or /ar/…), the agent opens in that language.
• Without a prefix, the language the visitor chose before is used, otherwise their browser's language, if the agent offers it. If neither applies, English opens if the agent has it, otherwise the main language.
• On the share link, visitors can change the language with the selector at the top of the page; changing it starts the conversation over. The agent embedded on your site and the store agent have no selector; the language comes from the setting in the embed code, the store plugin or the visitor's browser.
• In Arabic the page is shown right to left.
• Your agent's texts appear in the chosen language. The system's own buttons and messages are ready in the panel's seven languages; in other languages they appear in English.
• Translated texts are spoken in the visitor's language. If the visitor answers by voice, the language they speak is recognized automatically.

“Preview” opens with the same rules; you can try another language with the language selector on the preview page.

Who can change them?

Only owners and admins can translate, fix translations and change the main language. Other roles can use the language menu only to view the agent in other languages.