SetupLanguages

Multilingual support setup

Ada supports multilingual functionality so your AI Agent can communicate with 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.

Enable languages

  1. To get started, in the Ada dashboard, go to AI Agent profile > Languages.
  2. Under Available Languages, select the languages you want your AI Agent to support in addition to English (which is always enabled).

Best practice: 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 your AI Agent’s starting language

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

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

Add the language to Embed2 script

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 our Embed2 documentation. Let’s take a look at how to set up an AI Agent’s starting language to French.

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

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

Language detection in web chat

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

  1. Embed2: If the Embed2 script specifies a default language, your AI Agent will use it.

  2. Browser language: If no language is set in the Embed2 script, your AI Agent checks the user’s browser language.

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

Language detection in other channels

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