Languages

Support multiple languages and internationalization using Bot CMS

Bot CMS supports any language.

If you’re connecting a Natural Language Understanding agent with Bot CMS you’ll need to make sure the NLU agent also supports the languages you’re using. For example, of the 100+ languages Bot CMS supports, DialogFlow supports 15 of them, while Wit.ai supports 50.

Adding multilingual content

The process for adding multilingual content is the same as adding content in your bot’s default language. In the Entity Editor, select the appropriate language from the Language drop-down menu.

Configuring your flow for multilingual content

Instead of creating multiple flows to handle different languages, you can create a single flow and replace your bot’s hard-coded responses with references to your Bot CMS content using Mustache syntax. See Tutorial 1 for an example of how this works.

If you have content in multiple languages, though--say, a welcome message in both English and in French--your bot needs to know which to display. In order to detect which language the user is speaking, use the cms_nlu intent.

Open the flow in Bot Studio. Open the Trigger settings. Select cms_nlu from the Trigger Type drop-down. Enter the space name and key that identify the entities that will trigger the flow. The important thing here is to ensure Detect Language is checked. This will pass language information into the flow. When you reference {{ cms.<space>.<key> }} in your flow, your bot will retrieve the content in the appropriate language. If Detect Language is not checked, your bot will retrieve the content matching its default language.

Configuring your NLU agent to support multiple languages

DialogFlow

While logged into your DialogFlow account, go to the console. On the left side of the console, you should see a gear icon to the right of the currently selected agent. Click the gear icon.

Click the Languages tab at the top of the console.

Note: You cannot change the default language of a DialogFlow agent. You set it in the agent creation process after which it cannot be changed.

Select an additional language from the Select Additional Language drop-down. Click Save at the top of the console.

Wit.ai

Currently Wit.ai requires you to create one app (i.e. an agent) per language.

While logged into your Wit.ai account, go to the console. Click the + symbol in the top right corner to create a new app. Give the app a name and choose the app’s language from the Language drop-down, and click Create App.

Setting a bot’s default language

If you have multilingual content in Bot CMS and wish to have your bot respond in one particular language unless spoken to in another language, set your bot’s default language in the Settings page.

From your bot’s dashboard, click Settings in the tab bar at the top of the dashboard or from the menu on the left side of the dashboard. In the Bot Settings section, select a default language from the Language drop-down list.