To start requesting translations, make sure you have read through the steps on how to authenticate your brands subdomains with Unbabel and have your language setup properly configured. A language will only show up as available to translate to if it matches the source language to form a supported language pair.
You can access our integration tool at https://kb.unbabel.com. Be sure to use your Unbabel account credentials to log in. Also, make sure that the user doing so and managing the Help Center translations is a Zendesk Admin with full access to all brands containing the articles.
Once you log in, Unbabel will automatically screen your Help Center for the article's status. We will typically look for new articles, articles lacking translations in your supported languages, and changes to articles since the last translation was delivered by Unbabel (whether they are Published or Drafts). Note: we can only detect translations that have been delivered by Unbabel. If your article has both a default version and one or more translations completed outside Unbabel, we will not have visibility over them.
Please bear in mind that Unbabel will read any updates when the tool is launched, so be sure to only log in to https://kb.unbabel.com after you finish and save all intended changes in Zendesk.
If you are managing multiple brands, this will occur separately for each one once you select a brand from the list displayed initially.
Automatically selecting articles for translation
As the screening is completed, we will summarize all articles in need of translation (languages missing, changes made, etc). You have the possibility of immediately proceeding with a translation request for these articles, by clicking the Select Articles button and then Request Translation, and we will take care of the selection for you. All you need to do is confirm the translation request as described below, select the target languages and confirm the request.
Manually selecting articles for translation
It is possible to manually select which articles are due for translation, by navigating the left pane through the category and section paths. The parent folder will be the selected Zendesk Brand, identified by its subdomain. Expanding the folder will reveal all categories, and picking a category will display all the sections contained therein.
You are able to find your articles once you select their section. Articles within the section will display in the center pane, along with their status. Articles that have been subject to changes since the last translation, and sections and categories containing such articles will be identified by a red dot preceding them. You can also check on the article's status for additional clues:
- "No translations yet" - The article hasn't been translated at all
- "Translation in progress" - The article is being translated to the selected target languages
- "Translated" - The article was successfully translated into the listed target languages
- "Changed" - The article was edited after being translated
All articles will display a center column listing the languages Unbabel has translated them to in this view.
Clicking an article title will display its translation details, namely, the languages it has been translated to, the status of those translations, and the date of the last translation request.
Confirming the translation request
After you've selected the articles you wish to translate, you may click the green button reading Request Translation at the top-right corner. This will open a new window.
Here, you will have one last chance to select or deselect the articles you wish to translate (1). Confirm your source language (2), pick your target languages (3) and order the translations (4). From here on, all you need to do is wait until they are completed! Once they are, a translated version for the article will be available under the Guide Admin.
Category and section titles and descriptions
If you are looking into a child folder, you will find a row containing the info about its parent folder above each view. It will read the section name (if you are looking at listed articles) or the category name (if you are looking at sections). The checkbox before the section/category name will allow you to select/deselect all child items (that is, all sections and articles within a category, and all articles within a section).
We will translate any section and category titles and descriptions for which at least one child article has had one translation requested. If this has not happened before, it is normal that you find the checkboxes selected even when selecting a single article for translation.