Інтеграція з Zendesk Guide

Zendesk Guide – це довідкова програма служби Zendesk. Це допомагає впорядкувати статті бази знань, поширені запитання, відомості про продукт, політики та інший корисний вміст.

Використовуючи інтеграцію Crowdin Enterprise із посібником із Zendesk, ви можете запропонувати користувачам підтримку рідною мовою. Working in Crowdin Enterprise, your translators will be able to use Glossaries, Translation Memory, and other localization resources you’ve added to your project. Це допоможе підтримувати узгодженість перекладів різними мовами.

Як працює інтеграція

Once you configure the integration, the content from your Zendesk Guide will be automatically added as XML files to your Crowdin Enterprise project. These XML source files are generated based on your Crowdin Enterprise project’s source language.

If you don’t have any content on your Zendesk Guide localized to the Crowdin Enterprise 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 Enterprise.

You can localize articles, names, descriptions of your help desk categories and sections, as well as dynamic content. Ці тексти будуть додані до проекту у вигляді окремих файлів XML.

Ось як виглядатимуть ваші файли проекту після успішної конфігурації:

Для кожної категорії, яку ви хочете локалізувати, створюється окрема папка. Ця папка містить файл із відповідною назвою категорії та описом, а також окремі файли із назвами розділів та описами, та окремі файли статей. Цифри, які ви бачите в іменах папок та файлів, є ідентифікаторами категорій, розділів та статей у Посібнику з Зендеська. Вони не будуть помітні для перекладачів та коректорів.

Завантаживши файли в проект, ви можете запросити учасників перекладати та перевіряти тексти. Learn about translation approaches you can use in Crowdin Enterprise.

Щоб завантажити переклади до Довідкового центру керівництва Zendesk, ви можете налаштувати графік синхронізації, щоб автоматично додавати переклади до довідкової служби із заданою частотою, або запускати синхронізацію миттєво, якщо це необхідно. Графік синхронізації є завершальним етапом налаштування інтеграції.

Preparing Zendesk Guide for Integration with Crowdin Enterprise

If you’re just starting with Zendesk Guide localization, here are a few things you might find helpful when integrating with Crowdin Enterprise.

Enabling Zendesk Guide for your Zendesk Account

To start working with the help center, you need to enable Zendesk Guide. Read more about Enabling Zendesk Guide.

Managing Help Center Content

Zendesk Guide structure consists of categories, sections, and articles. Add all the necessary content to your help center to sync it with your Crowdin Enterprise project. Read more about Creating and editing articles in your help center and Organizing knowledge base content in categories and sections.

Adding Languages to Help Center

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.

Activating Help Center

Once your help center is ready, you can make it visible to end users. Read more about Activating help center.

Connecting Zendesk Guide with Crowdin Enterprise

1. Open your project and go to Integrations > System.
2. Click on Zendesk Guide in the Integrations list.
3. Enter your help center URL (for example, https://support.mycompany.zendesk.com) and click Set Up Integration.
4. Authorize the connection with Crowdin Enterprise on the Zendesk Guide side.

Zendesk Guide Integration Settings

After the successful authorization, you will be redirected back to Crowdin Enterprise. Натисніть Налаштування, щоб завершити налаштування.

In the Zendesk Guide integration settings you can configure the following parameters:

• Push Translations Every 1/3/6/12/24 hours – Configure how often finished translations will be pushed to your Zendesk Guide. You can leave this option cleared and use the Sync Now button to launch synchronization manually once needed.
• Synchronize – Select the content that will be uploaded from your Zendesk Guide. You can choose the Dynamic Content and categories you’d like to upload descriptions and articles from. You can choose All Categories or only some of the available. Read more about managing your Dymanic Content translations.
• Translate Draft Articles – Select to synchronize articles that aren’t published.
• Push translations as drafts – Depending on the publication status of your articles, this option’s behavior may differ. Let’s review the possible scenarios below:
  • Option selected (published articles) – If translated articles were published on Zendesk Guide before the translation upload from Crowdin Enterprise, the integration will push new translations and unpublish the articles.
  • Option selected (unpublished articles) – If translated articles weren’t published on Zendesk Guide before the translation upload from Crowdin Enterprise, the integration will push new translations and keep the articles unpublished.
  • Option cleared – The integration will push translations to your Zendesk Guide and won’t change the prior publication status of the articles.

Once you configured the integration, click Save.

Uploading Translations from Zendesk Guide

By default, the translations stored on your Zendesk Guide are uploaded to Crowdin Enterprise during the first synchronization only. To upload translations to Crowdin Enterprise manually, click next to the Sync Now button, and click Upload Translations. The integration will upload existing translations to your Crowdin Enterprise project.