Configure WebChat IM Translation

Note Enterprise plus license required .

It is possible to have all IM sessions translated with the Microsoft Translator Service. This is a (paid) Azure subscription.

Prerequisites

Before proceeding installation, please ensure following prerequisites are met.

 

 

​Configuration

​​First create a API key in Microsoft Azure:

  1. ​Sign in into https://portal.azure.com
  2. Click 'New' (green plus icon)
  3. Search for 'Translator Text API'
  4. Click 'Create'
  5. Enter the requested details and click 'Create'
  6. In the 'Keys' section under 'Resource Managment' copy the key under 'Key 1'

In the settings section of your UCC Sharepoint settings site create the following settings:

Setting

Value

Description

IMTranslationEnabled

true

Enables translation of chat messages between user and agent, and user and chatbot.

AzureKeyTextTranslationService

<KEY FROM AZURE YOU JUST COPIED>

Microsoft Cognitive translation service Azure key if TextTranslationService is set to Microsoft.

IMTranslationAgentLanguage

​The language of the agent (Eg. en)

Abbrevation of the language the Agents speak. See website of the desired text translation service for valid languages.

IMTranslationDefaultCustomerLanguage

​​

The fallback language of the customer when we cannot detect language (Eg. nl)

By default the language of the customer is auto detected. But in some circumstances the language cannot be determined. This setting defines a fallback language. Should be set to the target audience's language.

TextTranslationService

​Microsoft / Google

Sets the desired text translation service. Possible values are Microsoft and Google.

GoogleKeyTextTranslationService

<KEY FROM Google>

Google Translate api key if TextTranslationService is set to Google.

 

​​Usage

  1. ​Start a chat with an Agent as a customer
  2. Speak in a for the Agent foreign language
  3. You should see the message is translated to 'IMTranslationAgentLanguage'
  4. When you speak as the agent, the customer would see the translation in his own language.
  5. When both parties speak the same language, the message won't be translated.