Справочный центр Zendesk
Подключите Zendesk Help Center к движку локализации. Включите синхронизацию для нужных категорий, разделов и статей — Lingo.dev переведёт их на языки вашего Help Center и запишет переводы прямо в Zendesk.
Работает с контентом Zendesk Guide (справочный центр): категориями, разделами и статьями.
Zendesk доступен с планом Enterprise. Если на странице подключения написано Zendesk не входит в ваш план — напишите нам, разберёмся.
Перед началом#
Понадобятся три вещи:
Права администратора в Zendesk. Подключение работает через OAuth, и у авторизующего аккаунта должны быть права на управление контентом Help Center. Каждый перевод Lingo.dev в Zendesk привязывается к этому аккаунту, поэтому используйте общий служебный аккаунт, если не хотите, чтобы имя одного из коллег фигурировало во всём Help Center.
Целевые языки должны быть включены в Zendesk. Lingo.dev предлагает ровно те языки, которые включены в вашем 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 и предложит.Движок локализации. Его глоссарий, тональность бренда и правила будут определять, как переводится ваш справочный центр.
Язык источника выбирать не нужно: Lingo.dev автоматически считывает язык по умолчанию вашего Help Center из Zendesk при каждом запуске.
Справочный центр уже переведён?
При первой синхронизации все переводы, которые уже есть в Zendesk, сохраняются. Для каждого материала и языка: если перевод уже полный — Lingo.dev его не трогает и переводит только то, чего не хватает. Чтобы заменить существующий перевод, используйте Retranslate.
Подключение справочного центра#
Откройте интеграцию
Перейдите в Studio -> All integrations и нажмите Connect на карточке Zendesk.
Заполните форму
| Поле | Что вводить |
|---|---|
| Название | Имя подключения, по которому вы будете различать свои Справочные центры |
| Help Center | Только поддомен из URL Zendesk. Для https://acme.zendesk.com введите acme — форма подставит .zendesk.com автоматически |
| Движок | Движок локализации, чьи глоссарий, правила и тональность бренда применяются к этим переводам |
| Режим | Draft сохраняет переводы как неопубликованные черновики, Publish публикует их сразу. См. раздел «Черновики и публикация» ниже |
Нажмите Continue to Zendesk.
Авторизация в Zendesk
Zendesk запросит доступ для Lingo.dev. Нажмите Allow. До этого ничего не создаётся: нажмёте Deny — вернётесь на форму без подключения.
Выберите языки
Вернувшись в Lingo.dev, вы увидите языки, включённые в вашем Help Center, кроме языка по умолчанию. Все они выбраны заранее. Снимите галочки с ненужных и нажмите Save and open.
Если в Help Center включён только один язык, Lingo.dev попросит сначала добавить ещё один в Zendesk.
Выбор контента для перевода#
На странице соединения пять вкладок: Categories, Sections, Articles, Workflow runs и Settings.
Первые три показывают контент соответствующего типа — по одной строке на элемент, с поиском по именам и ID. Название каждой строки ведёт на этот элемент в Zendesk, так что можно проверить, что именно вы выбираете. У каждой строки есть переключатель Sync: включите его — и элемент войдёт в соединение. Изменение сохраняется сразу при переключении, кнопки «Сохранить» нет. Переключатель в заголовке таблицы включает или выключает синхронизацию сразу для всего списка.
Флажки предназначены для разовых запусков. Отметьте строки — и появятся две кнопки: Queue sync (N) и Queue retranslation (N). Они запускают только выбранные строки, не меняя настройки синхронизации.
Каскадного применения нет
Включение категории переводит только её название и описание — но не разделы и статьи внутри. Чтобы охватить категорию целиком, включите её статьи на вкладке Articles. Переключатель в заголовке включает всё из списка, а ненужное можно снять.
Что переводится#
| Элемент | Переводимые поля |
|---|---|
| Категория | Заголовок, описание |
| Раздел | Заголовок, описание |
| Статья | Заголовок, текст |
Текст статей переводится как HTML — форматирование, ссылки и встроенные медиафайлы сохраняются.
Синхронизация и повторный перевод#
Две кнопки — два разных действия:
| Кнопка | Что делает | Когда использовать |
|---|---|---|
| Sync | Переводит только то, что изменилось с последнего запуска | Плановые обновления. В большинстве случаев нужна именно она |
| Retranslate | Переводит всё заново, независимо от наличия изменений | После изменения глоссария, тональности бренда или правил движка — когда нужно обновить уже существующие переводы |
Оба варианта есть в заголовке страницы — там они применяются ко всему с включённой синхронизацией — и появляются над таблицей при выборе строк, применяясь только к ним. Повторный перевод из заголовка потребует подтверждения: за каждый выбранный элемент и каждый язык списывается плата.
Задачи запускаются вручную. Редактирование статьи в Zendesk ничего не запускает — вы сами решаете, когда переводить.
Одновременно выполняется один запуск на соединение. Новый запрос во время выполнения встаёт в очередь; если очередь заполнена — попробуйте снова после завершения текущего запуска.
Наблюдение за запуском#
Вкладка Workflow runs показывает все запуски: время начала, что их инициировало, какие языки задействованы, сколько заняло и статус. У активного запуска есть кнопка Stop. Откройте строку, чтобы увидеть результат по каждому языку.
Статус Up to date — это не ошибка. Он означает, что с момента последнего запуска ничего не изменилось: обычный результат двух синхронизаций подряд без правок между ними.
Куда попадают переводы#
Каждый перевод прикрепляется к той же статье, разделу или категории как версия для конкретного языка — стандартная модель переводов в Zendesk. Читатели переключают язык в справочном центре и сразу видят нужный контент: ничего не дублируется и не перемещается.
Черновики и публикация#
В режиме Draft переводы поступают в Zendesk как неопубликованные черновики. Читатели ничего не видят, пока кто-то не проверит и не опубликует их в Zendesk. Это хороший стартовый режим, если переводов в Help Center ещё нет и вы оцениваете качество.
В режиме Publish переводы публикуются сразу после создания.
Переводы уже опубликованы? Используйте Publish
В режиме Draft перевод, который Lingo.dev создаёт для уже опубликованного языка, становится черновиком — и читатели теряют доступ к живой версии до повторной публикации. Если Help Center уже отдаёт переводы, выбирайте Publish.
Режим можно изменить позже на вкладке Settings — вместе с движком и целевыми языками.
Настройки#
Вкладка Настройки показывает, из какого Справочного центра берёт данные подключение и для какого контента включена синхронизация. Здесь же можно изменить название, целевые языки, движок и режим. Все изменения сохраняются сразу.
Если выбранный язык больше не включён в Zendesk, вкладка сообщит об этом. Синхронизации пропустят этот язык, а при следующем изменении списка он удалится.
Отключение#
Disconnect внизу вкладки Settings прекращает чтение и запись Lingo.dev в Help Center. Удаляется соединение, история запусков и запись о том, что уже переведено по каждой статье. Переводы, уже записанные в Zendesk, остаются — они принадлежат вашему Help Center, а не нам.
Повторное подключение
После повторного подключения история переведённого контента начинается заново. При первой синхронизации все переводы, которые уже есть в Zendesk — в том числе созданные Lingo.dev ранее, — сохраняются. Переводится только то, чего не хватает.
Ограничения#
| Ограничение | Подробности |
|---|---|
| Типы контента | Категории, разделы и статьи. Тикеты, макросы, темы и публикации сообщества не поддерживаются. |
| Блоки контента | Статьи, построенные из блоков контента Zendesk, не переводятся |
| Триггеры | Только вручную — без вебхука и автосинхронизации при изменении статьи |
| Одновременные запуски | По одному на соединение; остальные запросы встают в очередь |
| Целевые языки | Должны быть включены в Zendesk Help Center, прежде чем Lingo.dev сможет их предложить |
| Соединения | Несколько Справочных центров в одной организации — каждый подключён отдельно |
Устранение неполадок#
На странице подключения написано, что Zendesk не входит в ваш план. Zendesk доступен с Enterprise. Напишите нам — разберёмся; всё, что уже подключено, продолжает работать.
На странице подключения написано, что вы не можете это подключить. Для подключения нужно разрешение, которого нет у вашей роли. Администратор организации может подключить сам или выдать это разрешение вам.
Нужный целевой язык отсутствует в списке. Сначала включите его в Zendesk в разделе Knowledge в подразделе Settings, пункт Language settings, затем снова откройте вкладку Settings в Lingo.dev. Список каждый раз считывается из Zendesk заново.
После Allow Lingo.dev просит добавить язык в Zendesk. Help Center написан на одном языке и не предлагает других — переводить пока не во что.
Синхронизация завершается со статусом Up to date. Либо ничего не изменилось с момента последнего запуска, либо синхронизация ещё ни для чего не включена. Включите нужный контент на вкладках Categories, Sections и Articles.
Переводы не появляются в Help Center. Проверьте, не включён ли для соединения режим Draft. Черновики существуют в Zendesk, но остаются невидимыми для читателей до публикации.