Zendesk Guide Integration

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.

How Does The Integration Work

After you integrate the two systems, the texts from Zendesk Guide will be automatically added as XML files to your Crowdin project. Besides articles, you will be able to localize names and descriptions of your help desk categories and sections. 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.

Connecting Zendesk Guide with Crowdin

To connect the two systems follow these steps:

  1. Open Project Settings, Integrations tab in Crowdin. Scroll down to the Zendesk Guide section.
  2. Enter the Help Center URL (for example, https://support.mycompany.zendesk.com) and click Set Up Integration.
  3. Authorize the connection with Crowdin on the Zendesk Guide side.
  4. After the successful authorization, you will be redirected back to Crowdin. Click Settings to finish the setup.
  5. Choose the time interval to configure the synchronization schedule and select the categories you’d like to upload descriptions and articles from. Click Save.

You can leave Push translations every 1/3/6/12/24 hours box empty and use Sync Now button to launch synchronization instantly, once needed.

Was this article helpful?