This documentation supports the 20.02 version of Live Chat.
To view an earlier version, select the version from the Product version menu.

Setting language options and translation

By default, Live Chat supports English. For end users to interact with Live Chat in multiple languages, administrators can configure the language options in the Language Translation section of the Live Chat Administration Console. 

For automatic language translation, Live Chat supports Google Cloud Translation Services. If you want to use localization for the live chat, you must purchase the Google Cloud Translation API key. For more information, see  Google Cloud Translation API Open link  in Google documentation. 


Important

Automatic language translation is applicable only for the Self Service Portal. For example if a self-service user sets the browser locale to Spanish, all buttons and other user interface elements are displayed in Spanish.

Before you begin

To use Google translation services for automatic language translation, you must purchase a translation API key.

To set language options

  1. From the IT Home page, select Live Chat > Administration Console.
  2. Under General Settings, click Language Translation.
    The Language Settings pane appears. 
  3. Set the following options:
    • Automatic Language Translation: Select whether to enable automatic language translation. By default, this option is disabled. If this setting is enabled, the self-service user sees a Settings link and can set the preferred language. Automatic translation is used only to translate the content of the chat session. Regardless of the settings for automatic language translation, the user interface (including system messages) is displayed in the first language that is configured in the browser and for which Live Chat is localized (or English, if Live Chat is not localized into any of the languages configured in the browser).
    • Production: This flag controls which languages users can select on the Settings screen for automatic translation, as follows:
      • Checkbox is clear—For automatic translation, the user can select any language that is available from Google Translate.  User interface (including system message) localization is based on the browser setting (or English, if Live Chat is not localized into that language). 
      • Checkbox is selected - For automatic translation, the user can select from any of the languages set in the browser settings. If the user has multiple languages set in the browser, the user can select any of them for automatic translation.

    • Language Server Address: Type the URL of the server that hosts the Chat Translation Servlet (CTS). Replace  [SERVER]  with the BMC Remedy Mid Tier server. If multiple Mid Tier servers are behind a Load Balancer, specify the Load Balancer.

      Example of Language Server Address
      http://cal-server-mt:8080/eschat/rest/cts/translate?
    • Google API Translation Key: The required key (purchased from Google) to use for translation services.
    • Google API URL: The Google URL used for translation. This URL points to the Google translation key and is coded as follows:
      https://www.googleapis.com/language/translate/v2?appId=[KEY]&from=[FROM]&to=[TO]&text=[TEXT]
      If you are using Google Translate, do not change this value.
    • Supported Languages: Define the languages supported by the chat application. You can create, modify, or delete languages by clicking the corresponding buttons to the right of the language list. These are the languages available for the self-service user to select, if you have enabled automatic language translation.
  4. Save the changes, as follows:
    • Click OK to save the changes and close the console.
    • Click Apply to save the changes and keep the console open.

Related topic

System requirements

Was this page helpful? Yes No Submitting... Thank you

Comments