Zendesk Guide is a help desk software by Zendesk. It helps to organize Knowledge Base articles, frequently asked questions, product details, policies, and other helpful content.
With Crowdin integration with Zendesk Guide, you can offer customers support in their native language. Working in Crowdin, your translators will be able to use Glossaries, Translation Memory, and other localization resources you’ve added to your project. This will help to keep translations consistent across languages.
Once you configure the integration, the content from your Zendesk Guide will be automatically added as XML files to your Crowdin project. These XML source files are generated based on your Crowdin project’s source language.
If you don’t have any content on your Zendesk Guide localized to the Crowdin project’s source language, the primary language of the Zendesk Guide will be considered the source language, and the integration will add this content to Crowdin.
You can localize articles, names, descriptions of your help desk categories and sections, as well as dynamic content. These texts will be added to the project as separate XML files.
Here’s how your project files will look after the successful configuration:
A separate folder is created for every category you choose to localize. This folder contains a file with the corresponding category name and description, as well as separate files with the names and descriptions for the sections, and separate files for articles. The numbers you’ll see in the folder and file names are the IDs of categories, sections, and articles in Zendesk Guide, they won’t be visible to your translators and proofreaders.
Once you have the files uploaded to the project, you can invite contributors to translate and proofread the texts. Learn about translation approaches you can use in Crowdin.
To upload translations to your Zendesk Guide help center, you can both set up a sync schedule to add translations automatically to help desk within the set periods or launch sync instantly when needed. The sync schedule is the final step of the integration setup.
If you’re just starting with Zendesk Guide localization, here are a few things you might find helpful when integrating with Crowdin.
To start working with the help center, you need to enable Zendesk Guide. Read more about Enabling Zendesk Guide.
Zendesk Guide structure consists of categories, sections, and articles. Add all the necessary content to your help center to sync it with your Crowdin project. Read more about Creating and editing articles in your help center and Organizing knowledge base content in categories and sections.
To localize your help center to new target languages, you need to enable them in your Zendesk Guide settings. Read more about Adding Languages to Help Center.
Once your help center is ready, you can make it visible to end users. Read more about Activating help center.
After the successful authorization, you will be redirected back to Crowdin. Click Settings to finish the setup.
In the Zendesk Guide integration settings you can configure the following parameters:
Once you configured the integration, click Save.
By default, the translations stored on your Zendesk Guide are uploaded to Crowdin during the first synchronization only. To upload translations to Crowdin manually, click on the drop-down toggle on the Sync Now button, and click Upload Translations. The integration will upload existing translations to your Crowdin project.