This documentation supports the 25.1 version of BMC Helix Virtual Agent.To view an earlier version, select the version from the Product version menu.

Localizing chatbot conversations by using localized Chatbot Skills for each language


For end users to interact with BMC Helix Virtual Agent in multiple languages, administrators can create localized  Skill by adding localized intents, entities, and dialogs in IBM Watson Assistant. 

you can use real-time translation if you don't want to create localizedSkill for each language, . You don't require localized Skill if you are by using real-time translation. For more information about this method, see Localizing-chatbot-conversations-by-using-real-time-translation

This functionality is available only if the IBM Watson Assistant is configured in your environment.

By default, BMC Helix Virtual Agent supports English. Localization is supported for BMC Helix Virtual Agent, Skype for Business on-premises, Microsoft Teams, and Slack. End users can interact only in English when using SMS to interact with BMC Helix Virtual Agent.

For localized live chat, BMC Helix Virtual Agent uses Google Cloud Translation Services for automatic language translation. You must purchase the Google Cloud Translation API key to use localization for the live chat capability. For more information, see Google Cloud Translation API  in Google documentation. You do not require the Google Cloud Translation API key if you do not want to enable localization for live chat capability.

Locales supported when using localized Chatbot Skill

BMC Helix Virtual Agent supports the following languages when you use IBM Watson Assistant:

Important

These languages are subject to change, and we recommend that you refer Supported languages list in the IBM documentation. 


  • Arabic—ar
  • Chinese—zh_CN
  • Danish—da
  • Dutch—nl
  • English (default)—en
  • English (Canada)—en-ca
  • French—fr
  • French(Canada)—fr-ca
  • German—de
  • Hebrew—he
  • Italian—it
  • Japanese—ja
  • Korean—ko
  • Norwegian—no
  • Portuguese—pt
  • Russian—ru
  • Spanish—es
  • Swedish—sv
  • Thai—th

Scenario: Configuring multiple localized Skill to enable localization

An organization - XYZ Limited decides to leverage the conversational capabilities of BMC Helix Virtual Agent. In addition to English, the organization supports languages such as French, German, Italian, etc. To make sure that end users can interact with BMC Helix Virtual Agent in their language, the administrator trains BMC Helix Virtual Agent to respond in each language by creating localized intents, entities, and dialogs. 

To make sure that the end users can create service requests through BMC Helix Virtual Agent in their locale, the administrator imports the localized service definitions in BMC Helix Virtual Agent.

To make sure that end users can interact with support agents in their locale, the administrator configures the language settings in Live Chat  and enters the Google API translation key. 

Localization workflow by using a localized Chatbot Skill

Administrators can create one IBM Watson Assistant Skill for each non-English locale. English is the default locale, and the Skill for English is provided out-of-the-box. If you attempt to create multiple skills for a locale, BMC Helix Virtual Agent generates an error. 

The following figure represents the workflow of enabling localization in BMC Helix Virtual Agent:

1905_Chatbot localization workflow.png

The following table describes the tasks to be performed in the process of configuring localized messages for BMC Helix Virtual Agent:

Task

Product

Action

Reference

1

IBM Watson Assistant

Create a localized IBM Watson Assistant Skill.

For multiple locales, create one skill for each locale, create localized intents, entities, and dialogs, and configure the chat actions.

After completing this task, you must return to BMC Helix Virtual Agent to complete the localization process.

2

BMC Helix Innovation Studio

Configure the IBM Watson Assistant credentials so that the BMC Helix Cognitive Automation can access IBM Watson.

3

BMC Helix Innovation Studio

Configure the appropriate IBM Watson Assistant Skill ID. For multiple locales, configure the Skill ID for each locale.

4

(Optional)

Live Chat

(If you want to configure localization for live chat)

Configure automatic translation in a live chat so that the support agent's messages are automatically translated to the user's locale.

5

(Optional)

BMC Helix Digital Workplace Advanced

(If you want BMC Helix Innovation Studio to create localized service requests in BMC Helix Digital Workplace Advanced)

Localize catalog items to publish a service in various supported locales.

6

(Optional)

BMC Helix Virtual Agent

(If you want BMC Helix Innovation Studio to create localized service requests in BMC Helix Digital Workplace Advanced)

Import the localized services in BMC Helix Virtual Agent.

Result of localizing chatbot conversation by using localized Chatbot Skill

The head of XYZ Limited communicates to the employees that they can interact with BMC Helix Virtual Agent in French—one of the supported locales. An employee wants to install Microsoft Visio on his laptop. The employee opens BMC Helix Virtual Agent and starts interacting in French. BMC Helix Virtual Agent identifies the locale, and replies to the user in French. After the employee has provided all the required details, BMC Helix Virtual Agent creates a service request (to install Microsoft Visio in his laptop) in French. The service request is created and tracked in BMC Helix Digital Workplace Advanced. 

  • What happens if the user's locale is not supported
    If the user initiates a conversation in a locale that is not supported by BMC Helix Virtual Agent, the chatbot responds with a message in English— I am not trained in your language, if you would like you can continue in English. 
  • Escalating to a live chat

    During an interaction in the supported locale, if the user is not satisfied with the chatbot's response, BMC Helix Virtual Agent checks whether live chat support is configured and asks whether the user wants to be transferred to a live chat. After the user connects with the support agent and interacts in his locale, the message is automatically translated to English for the support agent. The agent responds in English. The response is automatically translated for the user in his locale. For more information, see Leveraging-live-chat-capability.

  • Standard localized error message

    During an interaction in the supported locale, if something goes wrong in BMC Helix Virtual Agent, a standard message—Something has gone wrong, please contact the administrator or try again later—is displayed in the user's locale. 

Example of a chatbot interaction in French

The following image is an example of how a user interacts with BMC Helix Virtual Agent in French locale:

Localizing chatbot conversations by using localized Chatbot Skills for each language.png

For information about changing the chatbot conversation language preference, see Localizing-chatbot-conversations-by-using-real-time-translation.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*