Подключите справочный центр Zendesk к движку локализации. Выберите категории, разделы и статьи — Lingo.dev переведёт их на нужные языки и загрузит переводы обратно в Zendesk.
Работает с контентом Zendesk Guide (справочный центр): категориями, разделами и статьями.
Интеграция с Zendesk подключается на уровне организации. Если вы не видите её в разделе Settings -> Integrations — напишите нам, и мы её включим.
Перед началом#
Понадобятся три вещи:
Права администратора в Zendesk. Для подключения используется OAuth — у авторизующего аккаунта должны быть права на управление контентом справочного центра.
Целевые языки должны быть включены в Zendesk. Zendesk принимает перевод только для языков, которые уже добавлены в Help Center. Включите их в Zendesk: Knowledge -> Settings -> Language settings.
Языки, добавленные через Admin Center -> Account -> Appearance -> Localization, хранятся в отдельном списке и не активируют язык в Help Center.
Чтобы точно узнать, какие языки поддерживает ваш Help Center, откройте
https://<subdomain>.zendesk.com/api/v2/help_center/locales.jsonпод учётной записью администратора. Именно эти коды и можно выбрать в Lingo.dev.Движок локализации. Его глоссарий, тональность бренда и правила будут определять, как переводится ваш справочный центр.
Коды локалей должны точно совпадать с Zendesk
Zendesk использует коды вида en-us и de-de. Если исходный язык вашего справочного центра указан как en-us, выберите в Lingo.dev English (United States), а не просто English — это две разные локали (en-US и en), и именно это несовпадение чаще всего приводит к ошибке подключения.
Подключение справочного центра#
Откройте интеграцию
Перейдите в Settings -> Integrations и нажмите Connect рядом с Zendesk.
Заполните форму
| Поле | Что вводить |
|---|---|
| Поддомен | Только метка из URL Zendesk. Для https://acme.zendesk.com введите acme — без https:// и без .zendesk.com |
| Движок | Движок локализации, который будет переводить этот контент |
| Исходная локаль | Язык статей — точно так, как он указан в Zendesk |
| Целевые локали | Языки для перевода. Все они должны быть заранее включены в Zendesk |
| Сохранять как черновики | Включите, чтобы переводы сохранялись как неопубликованные черновики. Выключите, чтобы публиковать сразу |
Авторизация в Zendesk
Вас перенаправят в Zendesk. Нажмите Allow — и вы вернётесь на страницу Zendesk в Lingo.dev с активным подключением.
Выбор контента для перевода#
На странице Zendesk есть две вкладки: Content и Runs.
Вкладка Content показывает всё содержимое справочного центра — категории, разделы и статьи в одной таблице. Используйте фильтры сверху (All, Categories, Sections, Articles), чтобы сузить список, и флажки, чтобы отметить нужное. Название каждой строки — ссылка на этот элемент в Zendesk, так что всегда можно проверить, что именно выбрано.
Выбор категории не включает её содержимое
Категории, разделы и статьи выбираются независимо. Если нужно перевести целую категорию, выберите её саму и все её разделы со статьями.
Сначала сохраните, потом синхронизируйте. Новое подключение начинается с пустой областью, а синхронизация берёт сохранённую область — не то, что отмечено на экране прямо сейчас. Запустите синхронизацию до сохранения — и задача вернётся пустой: переводить нечего. Нажмите Сохранить, а затем переводите.
Что переводится#
| Элемент | Переводимые поля |
|---|---|
| Категория | Заголовок, описание |
| Раздел | Заголовок, описание |
| Статья | Заголовок, текст |
Текст статей переводится как HTML — форматирование, ссылки и встроенные медиафайлы сохраняются.
Синхронизация и повторный перевод#
Две кнопки — два разных действия:
| Кнопка | Что делает | Когда использовать |
|---|---|---|
| Sync | Переводит только то, что изменилось с последнего запуска | Плановые обновления. В большинстве случаев нужна именно она |
| Retranslate | Переводит всё в области заново, с нуля | После изменения глоссария, тональности бренда или правил движка — когда нужно обновить уже существующие переводы |
Обе кнопки доступны в двух местах: в заголовке страницы — для всей сохранённой области, и над таблицей контента — только для выбранных строк.
Задачи запускаются вручную. Редактирование статьи в Zendesk ничего не запускает — вы сами решаете, когда переводить.
Одновременно может выполняться только один запуск. Пока он активен, обе кнопки недоступны.
Наблюдение за запуском#
Вкладка Runs показывает все запуски: статус, причину запуска, время начала и продолжительность. Активный запуск можно отменить прямо из списка.
Откройте задачу, чтобы увидеть детали: на каком этапе она находится — получение контента из Zendesk, перевод, запись результатов, — а также общий прогресс и прогресс по каждому языку. Сразу видно, что немецкий уже готов, а японский ещё в процессе.
Задача с результатом нечего переводить — не ошибка. Это значит, что всё в области уже совпадает с переводами. Обычный результат, если синхронизировать дважды, ничего не редактируя в промежутке.
Куда попадают переводы#
Каждый перевод прикрепляется к той же статье, разделу или категории как версия для конкретного языка — стандартная модель переводов в Zendesk. Читатели переключают язык в справочном центре и сразу видят нужный контент: ничего не дублируется и не перемещается.
От чьего имени публикуются переводы
В Zendesk автором каждого перевода значится учётная запись, которая авторизовала подключение, — а не тот, кто нажал «Синхронизировать». Если не хотите, чтобы имя одного коллеги стояло на всём справочном центре, подключитесь через общую сервисную учётную запись.
Черновики и публикация#
При включённом Save as drafts переводы попадают в Zendesk как неопубликованные черновики. Клиенты их не увидят, пока кто-то не проверит и не опубликует их в Zendesk. Это безопасный вариант по умолчанию — особенно пока вы оцениваете качество переводов.
Выключите эту настройку — и переводы будут публиковаться сразу после записи.
Изменить это можно позже в Settings -> Integrations -> Zendesk — там же меняются движок и целевые языки.
Отключение#
При отключении удаляются подключение, история задач и записи о том, что уже переведено для каждой статьи. Переводы, уже записанные в Zendesk, остаются — они принадлежат вашему справочному центру, а не нам.
Повторное подключение начинается с нуля
Данные о синхронизации статей удалены, поэтому первая синхронизация после повторного подключения воспринимает всю область как новую и переводит её заново — со всеми вытекающими расходами. Отключайтесь, когда действительно хотите остановить работу, а не чтобы разобраться с проблемой.
Ограничения#
| Ограничение | Подробности |
|---|---|
| Типы контента | Категории, разделы и статьи. Тикеты, макросы, темы и публикации сообщества не поддерживаются. |
| Блоки контента | Статьи, построенные из блоков контента Zendesk, не переводятся |
| Триггеры | Только вручную — без вебхука и автосинхронизации при изменении статьи |
| Одновременные запуски | Один на подключение |
| Целевые языки | Должны быть включены в справочном центре Zendesk до начала запуска |
Устранение неполадок#
Подключение прерывается сразу после нажатия «Разрешить». Почти всегда дело в несовпадении локали: выбранная исходная локаль не существует в Help Center. Откройте https://<subdomain>.zendesk.com/api/v2/help_center/locales.json, запишите точный код из списка и повторите подключение с ним.
Нужного целевого языка нет в выпадающем списке. Сначала включите его в Zendesk: Knowledge -> Settings -> Language settings, затем снова откройте настройки в Lingo.dev.
Синхронизация сообщает, что нечего переводить. Либо сохранённая область пустая — выберите контент на вкладке «Контент» и нажмите Сохранить, — либо всё в ней уже актуально.
Переводы не появляются в справочном центре. Проверьте, не включён ли режим черновиков. Черновики есть в Zendesk, но остаются невидимыми для клиентов до публикации.
