<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><style>
p {
margin: 0;
}
span.fr-emoticon.fr-emoticon-img {
background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle;
}
span.fr-emoticon {
font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0;
}
blockquote {
border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px;
}
blockquote blockquote {
border-color: #00bcd4; color: #00bcd4;
}
blockquote blockquote blockquote {
border-color: #43a047; color: #43a047;
}
table.grid {
border-collapse: collapse;
}
table.grid td,
table.grid th {
border: 1px solid #ddd;
}
.fr-fic.fr-dib {
display: block; margin: 5px auto;
}
.fr-fic.fr-dib.fr-fir {
text-align: right; margin: 5px 0 5px auto;
}
.fr-fic.fr-dib.fr-fil {
text-align: left; margin: 5px auto 5px 0;
}
.fr-fic.fr-dii {
float: none; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fil {
float: left; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fir {
float: right; margin: 5px auto;
}
img.fr-dib.fr-fir {
margin-right: 0; text-align: right;
}
img.fr-dib.fr-fil {
margin-left: 0; text-align: left;
}
img.fr-dib {
margin: 5px auto; display: block; float: none;
}
img.fr-bordered {
box-sizing: content-box; border: solid 5px #CCC;
}
img.fr-shadow {
box-shadow: 10px 10px 5px 0px #cccccc;
}
img.fr-rounded {
border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;
}
</style><p><strong>In this guide we will cover:</strong></p><p><strong>- Enabling Azure AI Translator</strong></p><p><strong>- Configuring Azure AI Translator</strong></p><p><strong>- Using Translations on a Ticket</strong></p><p><strong>- User Translations in the Self-Service Portal</strong></p><p><strong>- <strong data-pasted="true">Translations in the</strong><strong data-pasted="true"><strong data-pasted="true"> </strong></strong>Live Chat</strong></p><p><strong>- Language Pack AI Translations</strong></p><p><strong>- Action Toggles</strong></p><p><br></p><p><br></p><p>The Azure Translator integration allows you to instantly translate notes from users or other agents into the language that you are currently viewing Halo in.</p><p><br></p><p><strong><span style="font-size: 14pt;">Enabling Azure AI Translator</span></strong></p><p>To use this integration, you must enable the Azure Translator module from within Configuration > Integrations by clicking the '+' icon:</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImM2MDIyZDIzLTljZmEtNDA5OC05YzkxLThhZGFjM2Q0NzA3NyJ9.Vz2zAAmpxbEPS-lHvrPML9Xv3PCz1cfZhCjHx16P77s" class="fr-fic fr-fil fr-dib" width="553" height="262"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enabling the module.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Configuring Azure AI Translator</span></strong></p><p id="isPasted">To configure, set up a Translator within Azure > Cognitive Services, and obtain an API Key from "Keys and Endpoints", and paste your API key in Configuration > Integrations > Azure Translator - Translator API key.</p><p><br></p><p>You will need to enter the correct region for your translator model, this can be found in Microsoft's documentation. For example if you were in canadacentral, it should appear the following way:</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjJmZjkwNTZjLWFmYTctNGFkNi04ZjNlLTgxYjU5MzFmODA3MCJ9.4iDVz8qEcDD1tgVQFxwo_J5fxabkYk-K7dQv0QsfgMw" class="fr-fic fr-fil fr-dib" width="652" height="254"></p><p><strong><span style="font-size: 10pt;">Fig 2. Adding the API key and region.</span></strong></p><p><br></p><p>Alternatively your region may need to be set to Global, which is the Halo default.</p><p><br></p><p>There are options to choose between translating only plain text (to reduce usage costs), or HTML (to include images and preserve the formatting in the translation). A monthly character limit can also be added here.</p><p><br></p><p><strong><span style="font-size: 14pt;">Using Translations on a Ticket</span></strong></p><p>When active, a translate button will show for each action note. Press it to translate the note. This will auto-detect the language of the note and translate it into your current language using Azure translator.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjgwZDBkMThlLWM1NjYtNDdiYS05OGVhLWE4Yzk2NmE5ZThiYSJ9.2vLIJKJZwkCsOEgqW96OLow7tf2mcuRlPkl3yTm3v6U" class="fr-fic fr-fil fr-dib" style="width: 402px; height: 368.758px;" width="402" height="368.758"></p><p><strong><span style="font-size: 10pt;">Fig 3. Untranslated ticket.</span></strong></p><p><br></p><p>The note will then be replaced with the translated version and pressing the button again will revert to the original.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImZjZmNlYWFmLTJjNGMtNDlmYS05YWZmLWZmYmI5OTYwYWM1NSJ9.xbTx8FpnNWuPUgJbUvZjIBVp_6P0buRuQRomgS4AYAs" class="fr-fic fr-fil fr-dib" style="width: 403px; height: 358.559px;" width="403" height="358.559"></p><p><strong><span style="font-size: 10pt;">Fig 4. Translated ticket.</span></strong></p><p><br></p><p>Any notes which are translated are stored in the database and the translation is automatically loaded the next time you view the ticket.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQzYjk0MjgwLTVmOWQtNDI4NS05OGFhLThiNWUyYWVlNjU2ZiJ9.yo2SjJYb9Tgwx4tW8CZWpp-p10ipGBw5bkSHIVEhdZQ" class="fr-fic fr-fil fr-dib" width="935" height="381"></p><p><strong><span style="font-size: 10pt;">Fig 5. Automatically loading the translation.</span></strong></p><p><br></p><p>The first time the translation is made, it may take a few seconds to process, the next time you need to click the translate button it will automatically update via Halo's database:</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQ3YzA0ODYwLTY5NzgtNGIwNi1iNDg3LTkzYmY3MWIyZWVkMCJ9.bjQCuSHBmLIxUJxxCWhgnFMHpVFGtHMPCOv4CRbvsTk" class="fr-fic fr-fil fr-dib" width="932" height="290"></p><p><strong><span style="font-size: 10pt;">Fig 6. The same email.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">User Translations in the Self-Service Portal</span></strong></p><p>In Configuration > Self-Service Portal, or Configuration > Integrations > Azure AI Translator, enable this checkbox.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZmMGU3ZmZiLWFjNzMtNDU4ZC1iODU3LWQ2YjIzNDBhMmUwZCJ9.A5Td7atJ_7yc21kCzGca_PxhUrGlffAqhx7cAE4M3aI" class="fr-fic fr-fil fr-dib" width="374" height="41"></p><p><strong><span style="font-size: 10pt;">Fig 7. Enable Users to use AI translation.</span></strong></p><p><br></p><p>This will show the "Translate"/"View Original" toggle on Actions viewable to Users in the Self-Service Portal.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjcxN2E0Y2ZkLTZlYWItNDIzNy1hMjhiLTE4NDBjOGJmMjI4MCJ9.4gtnAvGGHNbv60xYoPvd8E6mUTzzxAWNELk7Jg9Vhcw" class="fr-fic fr-fil fr-dib" width="958" height="267"></p><p><strong><span style="font-size: 10pt;">Fig 8. Translate toggle on an Action.</span></strong></p><p><br></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;" data-pasted="true"><strong style="box-sizing: inherit; font-weight: 700;"><span style="font-size: 14pt;"><strong data-pasted="true" style="box-sizing: inherit; font-weight: 700;">Translations in the</strong><strong data-pasted="true" style="box-sizing: inherit; font-weight: 700;"><strong data-pasted="true" style="box-sizing: inherit; font-weight: 700;"> </strong></strong>Live Chat </span></strong></p><p>Agents can translate messages in the live chat when the "Allow Agents to translate Live Chat messages from Users" checkbox is selected. The Azure AI Translator Integration also allows users to translate live chat messages in the portal.</p><p>This allows two way communication with translations on either side.</p><p><strong style="box-sizing: inherit; font-weight: 700;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFiMWU5NmJiLTIyNTctNDEzZC05MGFlLWUzMzhkNjM5NjQ1YSJ9.0HmgIHqJJ5oCdLGQ52_6r9ylkv6uHztwqzyJ_kYRe88" class="fr-fic fr-fil fr-dib" width="961" style="width: 963px; height: 233.032px;" height="233"></strong></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 9. Translate Live Chat options. </span></strong></p><p><br></p><p>This will show a button at the bottom of the text box which translates the message.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNiYWYzOGJmLTkyZmYtNDBiMy1hMjZjLWE5MTYwNWM2MjE1MyJ9.6arE79GPokj6BMlV-ca-Ir7tUuWkLzGo0TaR4HQpROQ" class="fr-fic fr-fil fr-dib" width="358" height="424"></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;" data-pasted="true"><strong><span style="font-size: 10pt;">Fig 10. Translate button on a chat message. </span></strong></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;"><br></p><p><strong><span style="font-size: 14pt;">Language Pack AI Translations </span></strong></p><p>The integration can also be used to auto-translate missing strings in a language pack.</p><p><br></p><p>In Configuration > Language > Customise Language, select a language to translate. Click the "AI Translate Untranslated" button.</p><p><br></p><p>You will see an option to use the "AI Translate Untranslated (Portal)" function to translate strings in the portal only.</p><p> </p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJiODJkZWRhLWE0MGMtNGIyMy1hZWQ4LTU5ZDA5Yzk4NjczYiJ9.rnKY-aZ06SUPtx8tTwGYcVKee99qmSpAP9X7HwXjfxI" class="fr-fic fr-fil fr-dib" width="1021" height="879"></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;"><strong><span style="font-size: 10pt;">Fig 11. AI Translate Untranslated button.</span></strong></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;"><br></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;">A loading popup will then show. This will take a while as there is a large amount of data to translate, though only non-translated strings will be translated when using this method to reduce cost of use.</p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;"><br></p><p><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjYzYzlmZWIyLWY2YjYtNGE4ZC04NTdmLTIxOGU4OGFiMjQ1MCJ9.pwDHlcMJ-m7xaKS7f4jix7ncL3nXtUSw98cVVt-nUds" width="205" height="146" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; text-align: left; max-width: none !important;" class="fr-fil fr-dib"></p><p><strong><span style="font-size: 10pt;">Fig 12. Creating the translations.</span></strong></p><p><br></p><p>Upon completion, a CSV file will be created with the translations. Here, you can review them to make sure they are what you expect.</p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><br style="box-sizing: inherit;"></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE2NTg5MDBiLTY0ZGEtNDBiYy1hOGYyLTJlNzQxYzQxM2RmMSJ9.s-HUWhCgP_hX40_K-RXgQo_0hAdfB6F794CuK0-KRIg" width="568" height="403" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; text-align: left; max-width: none !important;" class="fr-fil fr-dib"></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><strong><span style="font-size: 10pt;">Fig 13. Translated file.</span></strong></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><br></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;">After confirmation, the file with the translations can then be imported for use.</p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><br></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjVjOTlhZGNmLTY1YzktNGU5Yi04Yjk2LWY2MTZhY2Y2NWNkNCJ9.wcpJywhacQpIEx-rSPqxwE4AQY9vMNTlyRTi6hjS-kw" class="fr-fic fr-fil fr-dib" width="1021" height="879"></p><p><strong><span style="font-size: 10pt;">Fig 14</span></strong><strong><span style="font-size: 10pt;">. Import From CSV button.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Action Toggles</span></strong></p><p>The translation toggle as been split into two settings and can be defaulted to be switched on. Enable "Show the "Translate (into users language)" option" in Configuration > Tickets > Actions > Details tab, then enable "Translate" in Configuration > Tickets > Actions > Defaults tab.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFmMDI2YTU0LWRkNGUtNDEyMi1iMDBiLTU2MmMyMjg0NGY4MiJ9.AKwB_AaL-cPnTkF0p5UHNrjb1bH2eXlWnmuUya4dXDM" class="fr-fic fr-fil fr-dib" width="871" style="width: 873px; height: 481.591px;" height="482"></p><p><strong><span style="font-size: 10pt;">Fig 15. Translate toggle.</span></strong></p>
