Multilingual support setup

Overview

Configure your AI Agent to communicate with end users in multiple languages. You can choose which languages to support, set a starting language for web chats, and configure how the AI Agent detects and switches between languages.

For information about supported languages and how multilingual works, see About multilingual support.

Quick start

Enable multilingual support in a few steps.

On the Ada dashboard, go to Config > AI AGENT > Settings, then open the Languages tab.

Under Available Languages, select the languages you want your AI Agent to support.

Optionally, set a starting language for web chats using the Embed2 script.

For detailed instructions, see Implementation & usage.

Implementation & usage

Configure languages and detection settings for your AI Agent.

Enable languages

Select which languages your AI Agent supports in addition to English (which is always enabled).

To enable languages:

On the Ada dashboard, go to Config > AI AGENT > Settings, then open the Languages tab.
Under Available Languages, select the languages you want your AI Agent to support.

Only enable languages your team can support. Make sure someone on your team can review conversations in each language to help evaluate performance and maintain quality.

Set starting language

The starting language is the default language your AI Agent uses to begin web chats. If most of your end users speak a language other than English, you can set that language as the default.

By default, all AI Agents start in English, but end users can switch languages at any time.

Embed2 script configuration

You can change the AI Agent’s starting language by making a small addition to the Ada Embed2 script. You might already be familiar with it, but if you need a refresher, check out the Embed2 documentation. Let’s take a look at how to set up an AI Agent’s starting language to French.

Find the default embed script on your webpage. It should look like this:

<!-- <head> -->
<script
  id="__ada"
  data-handle="yourbothandle"
  src="https://static.ada.support/embed2.js">
</script>

To set the AI Agent language, add the following window.adaSettings snippet between the head and the script of the basic Ada Embed2 script, and add the language format code from the ISO 639-1 language format.

<script>
  window.adaSettings = {
    language: "fr",
  }
</script>

Your revised Ada Embed2 script should look similar to this:

<!-- <head> -->
<script>
  window.adaSettings = {
    language: "fr",
  }
</script>
<script
  id="__ada"
  data-handle="yourbothandle"
  src="https://static.ada.support/embed2.js">
</script>

Web chat detection

Your AI Agent follows this order when deciding what language to start a chat in:

Embed2: If the Embed2 script specifies a default language, your AI Agent uses it.
Browser language: If no language is set in the Embed2 script, your AI Agent checks the end user’s browser language.
Fallback to English: If neither is available, your AI Agent defaults to English.

Your AI Agent can only use the languages that are enabled on the Languages page in the Ada dashboard.

Other channel detection

When default language settings are not available, your AI Agent uses Ada’s built-in language detection to identify the end user’s language based on their input.

About multilingual support: Learn about supported languages and how multilingual works.
Language switching: Understand how end users can switch languages during a conversation.
Manual translations: Customize translations in Greetings and Handoffs.