Integrating with Zendesk Guide

Unbabel makes it easy to translate the content of your Help Center by integrating with Zendesk and allowing you to manage and request translations in a dedicated interface.

Note: you need to be an Admin of the ZD instance you are connecting to the Unbabel KB webpage for the first time in order to complete the integration process successfully.

Note 2: Please make sure that you are logged in your Zendesk instance in a different tab of the same browser when conducting the process, otherwise the connection won't be established.

Integrate your Help Center

1 - Be logged in to your Portal instance by using your credentials

2 - Access the Apps launcher in the top right corner of the Screen, and click Zendesk Guide.

3 - You'll be prompted to select the product you're integrating with. Click Continue.

4 - Next, we will ask you for the subdomain of the brand your HC is hosted in. Each Zendesk brand integrates individually. If you wish to add multiple brands, simply repeat these steps once finished.

You can confirm your subdomain (which may be different from the host mapping) in two ways:

• Select Brand Settings from the Guide Admin brands drop down list, which sends you to the Admin Center page
• Head to your Zendesk instance's Admin Center, search and select Account>Brands.

Click on the brand hosting your Help Center center to expand its details, and check the subdomain. Copy just what's preceding .zendesk.com (in the example, cxunbabel).

5 - Head back to Unbabel webpage and insert the subdomain. Click Authorize.

6 - We will fetch the structure and status of your HC. This process may take a few minutes depending on the size of the HC.

7 - When the integration is complete, the HC becomes visible and you can expand its category and section structure from the left panel.

You're done! Let's see how to request a translation next.

How to request a translation

1- To request an article translation, you need to select one or more articles. You can find them by clicking on the section they are included in.

2 - Select one or more articles and click Order translation. Category and section titles and descriptions are automatically sent for translation as well.

3 - In the order page, click Select a language to expand the list of available target languages.

Select the languages you want the article to be translated to, then click Order translation.

4 - The articles will be sent for translation. You can check their status in the section list and obtain more information by clicking in the article title, displaying the details page.

5 - Once the translation is finished, all that's left to do is find and publish your draft translation from Guide Admin.

Notes

You may want to check your Brand language settings to make sure the translation request is correctly performed and that all languages are available for selection.

If you are not using English as your default language, make sure the language pair formed by your request is a supported and configured pipeline.

If you want to add more HC hosted in different brands, have a look at this article.

You can find more information on how to request translations in this article.

To learn more about our Integration with Zendesk Guide, be sure to read our documentation.