After installing the app, all your service desk projects will be prepared to use it, but translation will initially be disabled.

You can use the "Get started" button in the app entry in the "Manage apps" section in Jira
or use the "Language Translation - Jira Service Desk" link in the left navigation panel in the "Manage apps" section.

Alternatively you can also select any service desk project, go to project settings and click on "Language Translation".
In that case you can jump to chapter two below.

1. Come on board!

1.1 Credentials

The first thing you will have to do to get up and running is to set in your Google API credentials. 
They are necessary because we use the Google translation API in our backend.

set in your Google API credentials

Click on "Learn here how to obtain Google API Credentials" if you don't have them already.
Save them and click Next.

1.2 Enable Translation for Service Desk Projects

 Enable Translation for Service Desk

In the select box you will find all your service desk projects.
Choose one, change the main language and disable translation directions if appropriate, and then click on “Enable Project for Translation“.

That's it! You are basically done. From then on requests and comments of languages other then the main language will be translated to the main language.
After that you can switch to the next project and do the same.

1.3 Advanced Settings

If your service desk is multi lingual or you want to enable experimental features like "Sentiment Analysis" then you can do that in the Project Settings.
As you might have noticed, after enabling the project the Enable button of the form changed to

open settings page

Click on it and it will open the Settings.
If you click on Next, you get further information about custom fields and what you can do with them.

2. The Settings Page

This page you can either reach from the on-boarding or by clicking on the "Language Translations" link in the project settings.

settings page

2.1 Credentials, translation directions and main language

Here you can update your Google Api credentials, modify the translation directions and change the main language,
which you may have set by going through the on-boarding already.

2.2 Agent languages

You can  add more “Agent Languages“, languages that your service agents speak and therefore don't have to be translated.

The custom field "Customer Language" is populated also for agent languages.

That means that you can automatically route incoming requests to service agents that speak this language. Here you find how you can do this.

2.2.1. Translate agent languages as internal comment

Since version 1.1 and if selected, agent languages can also be translated into the main language, but as internal comment.
That way, agents only speaking the main language, can still follow what other agents in one of the other agent languages are doing.

3. Advanced Settings

3.1. Project user and Language Detection

Since version 1.1, a project user needs to be selected. The default selection here is the first project administrator found for the project.
It can be any other user with a project role different from the customer role.

Language detection sometimes produces false results, if a customer has a big email footer with content in another language.
For instance a Dutch customer writing in English, have an email footer in Dutch.
Using only the first 120 characters of a text is a good default value for preventing that, but you may change the settings here according to your needs.

advanced settings - a project user needs to be selected

3.2. Experimental Functions

You can also experiment with some more advanced features using Microsoft's Azure Text Analytics API:
Language Sentiment and Key Phrases

Language Sentiment measures the sentiment of incoming requests and responses of customers and places them in two custom fields: Initial Sentiment and Last Sentiment
Once enabled the fields are shown in the issue. And they can be used for automation and reporting.

Key Phrases try to extract the meaning of requests and responses and place them in key phrases. They are shown as tags and can be addressed like such.

We are interested in use cases of these features ourselves, they are fairly new and if you are interested in exchange or need further features, please get in touch with use.