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

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

Завдяки інтеграції Crowdin із Zendesk Guide ви можете запропонувати клієнтам підтримку їхньою рідною мовою. Працюючи в Crowdin, ваші перекладачі зможуть використовувати глосарії, пам’ять перекладів та інші ресурси локалізації, які ви додали до свого проєкту. Це допоможе підтримувати узгодженість перекладів різними мовами.

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

Щойно ви налаштуєте інтеграцію, вміст із Zendesk Guide буде автоматично додано як файли XML до вашого проєкту Crowdin. Ці вихідні XML-файли генеруються на основі вихідної мови вашого проєкту Crowdin.

Якщо у вашому Zendesk Guide немає жодного вмісту, локалізованого на вихідну мову проєкту Crowdin, основна мова Zendesk Guide вважатиметься вихідною мовою, а інтеграція додасть цей вміст до Crowdin.

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

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

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

Завантаживши файли в проект, ви можете запросити учасників перекладати та перевіряти тексти. Дізнайтеся про підходи до перекладу, які ви можете використовувати в Crowdin.

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

Підготовка Zendesk Guide для інтеграції з Crowdin

Якщо ви тільки починаєте локалізацію Zendesk Guide, ось кілька речей, які можуть бути вам корисними під час інтеграції з Crowdin.

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. Додайте весь необхідний вміст до свого довідкового центру, щоб синхронізувати його з проєктом Crowdin. 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.

З’єднання Zendesk Guide з Crowdin

1. Open your project and go to the Integrations tab.
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. Авторизуйте з’єднання з Crowdin на стороні Zendesk Guide.

Zendesk Guide Integration Settings

Після успішної авторизації ви будете перенаправлені назад на Crowdin. Натисніть Налаштування, щоб завершити налаштування.

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.
• Надіслати переклади як чернетки – Залежно від статусу публікації ваших статей, поведінка цього параметра може відрізнятися. Let’s review the possible scenarios below:
  • Вибраний варіант (опубліковані статті) – Якщо перекладені статті були опубліковані в Zendesk Guide до завантаження перекладу з Crowdin, інтеграція надішле нові переклади та скасує публікацію статей.
  • Вибраний варіант (неопубліковані статті) – Якщо перекладені статті не були опубліковані в Zendesk Guide до завантаження перекладу з Crowdin, інтеграція надішле нові переклади та залишить статті неопублікованими.
  • Option cleared – The integration will push translations to your Zendesk Guide and won’t change the prior publication status of the articles.

Після налаштування інтеграції натисніть Зберегти.

Uploading Translations from Zendesk Guide

За замовчуванням переклади, збережені у вашому Zendesk Guide, завантажуються в Crowdin лише під час першої синхронізації. Щоб завантажувати переклади на Crowdin вручну, натисніть на спадний перемикач кнопки Синхронізувати та натисніть Завантажити переклади. The integration will upload existing translations to your Crowdin project.