How to use Content Variables

Kore.ai bots platform provides a way to declare and use variables within the bot. These variables can be used to capture values that are commonly used by different tasks, nodes, and other bot elements

In this How-To, we will explore a scenario in a Banking Bot, where Bot Variables can be used. We will see how Content Variables can be used to pass language-specific messages.

For details on what Bot Variables are and how they are implemented in the Kore.ai Bots platform, refer here. For a use case with Global Variables, refer here.

Problem Statement

In our Banking Bot, we welcome users when they connect to the Bot. The bot is multilingual and we want the messages to be in the appropriate user language.

In this document, we will see how Content Variable can be used to store the message in multiple languages.

Pre-requisites

• Bot building knowledge
• A Banking Bot with the on Connect event configured as below:
  • From Natural Language -> Default Conversation select Event Handlers.
  • Click on On Connect event and configure to Show Message

  

• Enable the Spanish language for the bot
  • From Settings ->  Config Settings, select Language Management and enable the Spanish language.

Implementation

Declaring a Content Variable to hold the On Connect message will ensure it is not missed in the language translation.

1. Open the Banking Bot.
2. From Settings -> Config Settings select Content Variables section.
3. Click Add Content Variable to open the corresponding window.
4. Enter Variable Name and Variable Value. For this use case were are calling the Variable connectMessage, and for the value, we are entering the “Welcome to the Banking Portal – your one stop for all banking needs”.
5. Save.
   
6. Now switch the language to Spanish and for the same connectMessage variable using the edit icon enter the text in Spanish – “Bienvenido al portal bancario: su única parada para todas las necesidades bancarias“.
   
7. Return to the On Connect Event Handler and replace the text with reference to the content variable using the following code:
   {{content.connectMessage}}
   
8. Save the changes.

Testing

Use Talk to Bot to test the changes.

1. Open Talk to Bot.
2. The message will appear in English.
3. Use the cheat command to switch the language:
   cheat lang Es.
4. Reconnect to the bot and see the message in Spanish.