Справочный центр Zendesk
Переводите категории, разделы и статьи справочного центра в существующие языковые версии и вручную управляйте синхронизацией и публикацией.
Переводите материалы справочного центра прямо в Zendesk. Подключение Lingo.dev считывает выбранные категории, разделы и статьи на языке справочного центра по умолчанию, переводит их с помощью движка локализации и записывает версии на целевых языках в те же элементы.
В меню Studio 2.5 откройте Интеграции в разделе Studio 2.5, а не в разделе Настройки. Прежние ссылки для подключения и настройки продолжают работать.
Вы запускаете перевод вручную. После изменения статьи запустите синхронизацию для материалов, которые хотите обновить. Перед первой записью выберите, как сохранять переводы: как черновики или сразу публиковать. Если сохранить уже опубликованный перевод как черновик, эта языковая версия может стать недоступной читателям до повторной публикации.
Настройте доступ и языки справочного центра #
Интеграция со справочным центром Zendesk доступна на тарифе Enterprise. Актуальную информацию о доступности см. на странице тарифов. Если тариф организации не даёт доступа к интеграции, в подразделе Интеграции раздела Настройки рядом с Zendesk появится надпись Недоступно на вашем тарифе.
Используйте учётную запись администратора Zendesk с доступом к материалам справочного центра. Права администратора нужны для регистрации вебхука публикации статей, который собирает события для Radar. Изменения записываются от имени учётной записи, предоставившей доступ. Если команде нужно указывать общего автора изменений, используйте подходящую служебную учётную запись. В Lingo.dev вам нужны разрешение и право доступа к подключениям организации, а также доступ к выбранному движку локализации.
Включите целевые языки в языковых настройках справочного центра. Общий список языков учётной записи Zendesk настраивается отдельно и не включает перевод на эти языки в справочном центре. При наличии нужных прав конечная точка https://<subdomain>.zendesk.com/api/v2/help_center/locales.json, доступная только для чтения, показывает настройки локалей справочного центра.
При каждом запуске Lingo.dev определяет язык справочного центра по умолчанию и использует его как исходный. В форме подключения другой исходный язык не выбирается.
Подключитесь и переведите первую статью #
- Откройте подраздел Интеграции раздела Настройки и выберите Подключить для Zendesk. Укажите название и поддомен справочного центра. Для
acme.zendesk.comвведитеacme. - Перейдите в Zendesk и предоставьте доступ. Подключение создаётся только после успешной авторизации.
- В Studio выберите справочный центр в разделе Подключённые, затем выберите Настроить.
- Выберите движок локализации и режим записи переводов, затем выберите Продолжить. Для первого запуска выберите один целевой язык из включённых в справочном центре. Исходный язык исключён из списка. Если других языков нет, сначала включите нужный язык в Zendesk.
- Откройте Статьи и включите переключатель Синхронизация для одной статьи, исходный текст которой пока не планируете менять. Дождитесь сохранения настройки, установите флажок в строке этой статьи и выберите Добавить синхронизацию в очередь.
- Проверьте результат рабочего процесса и саму переведённую статью в Zendesk: заголовок, текст, ссылки, локаль и статус — черновик или опубликованная версия. Если статья должна быть опубликована, также откройте её по ссылке для читателей.
При первой синхронизации Lingo.dev принимает существующие полные переводы без перезаписи, сохраняя текст и статус черновика. Недостающие материалы переводятся. Используйте повторный перевод, если хотите заменить существующий перевод.
Выберите все материалы, которые хотите перевести #
У категорий, разделов и статей отдельные таблицы и переключатели Синхронизация, состояние которых сохраняется. Если включить синхронизацию категории, будут переведены её название и описание, но синхронизация вложенных разделов и статей не включится. Выберите их отдельно, если готовите к переводу целую область справочного центра.
| Элемент | Переводимые поля |
|---|---|
| Категория | Название/заголовок и описание |
| Раздел | Название/заголовок и описание |
| Статья | Заголовок и текст |
Флажки в строках позволяют выбрать элементы для разового запуска команд Добавить синхронизацию в очередь и Добавить повторный перевод в очередь. При этом обрабатываются только элементы, у которых уже включён переключатель Синхронизация. Флажок в строке не включает этот переключатель. Команды в заголовке охватывают все элементы подключения с включённой синхронизацией. Перед запуском проверьте, какие элементы будут обработаны.
Текст статей обрабатывается как HTML, чтобы восстановить форматирование, ссылки и встроенные медиа. При записи переводов распознанные ссылки справочного центра могут адаптироваться под целевую локаль. Проверьте эти ссылки в результате, в том числе наличие переведённых страниц, на которые они ведут. Внешние ссылки и навигацию конкретного сайта нужно проверять отдельно.
Это подключение не переводит обращения, макросы, темы оформления, публикации сообщества и статьи на основе блоков контента Zendesk. Оно локализует материалы справочного центра, а не сортирует обращения в поддержку.
Обновите изменённые материалы или замените перевод #
Синхронизация сравнивает текущий исходный материал с сохранённым состоянием и существующими переводами. Используйте её для регулярных обновлений исходного текста, перевода недостающих материалов и завершения работы, оставшейся с прошлого запуска.
Повторный перевод заново переводит выбранные элементы на выбранные языки, даже если исходный текст не изменился. Он может заменить уже принятые правки, внесённые вручную. Массовая команда в заголовке запрашивает подтверждение. Для команд, работающих с выбранными строками, вам также нужно указать, какие переводы вы хотите заменить.
Для каждого подключения одновременно выполняется только один запуск. Дополнительные запросы попадают в очередь. Если она заполнена, нужно дождаться свободного места. Результаты показаны в разделе Запуски рабочих процессов. Команда Остановить отменяет работу, которую ещё можно остановить. Результат «Актуально» означает, что среди выбранных изменений не было требующих обработки, а не то, что качество перевода оценили заново.
Проверьте, что видят читатели #
В режиме публикации переводы сразу публикуются. В режиме черновика сохраняются неопубликованные языковые версии для проверки в Zendesk. Если обновить уже опубликованную языковую версию в режиме черновика, она может стать недоступной читателям до повторной публикации. Перед обновлением решите, допустим ли такой перерыв для этого выпуска.
После записи откройте страницу перевода по URL на нужном языке. Сравните заголовок и текст с исходной редакцией, перейдите по ссылкам и проверьте, не осталось ли фрагментов на исходном языке. Завершённый перевод — лишь часть выпуска. Решения о приёмке и публикации остаются за редакцией.
Обработайте изменения исходного текста и частичные результаты #
Перед записью перевода исходный элемент считывается заново. Если после планирования он изменился или был удалён, Lingo.dev пропускает целевую версию. Когда исходный материал будет готов, снова запустите синхронизацию вручную, чтобы учесть его новое состояние.
Ошибка для одной локали не отменяет успешную запись для других. Проверьте, какие элементы записаны, пропущены или завершились с ошибкой, затем повторите запуск для нужной области. Принудительная обработка всего справочного центра может заменить уже принятый текст, не устранив исходную причину ошибки.
Если результата нет, проверьте выбор элементов, включённые языки справочного центра, доступ к движку локализации, режим записи переводов, исключения для блоков контента и изменения исходного материала. Если Lingo.dev принял существующий полный перевод, новый текст намеренно не создаётся. Если целевой язык отключили в Zendesk, он будет пропускаться при запуске. Обновите выбор целевых языков подключения.
При временном сбое Zendesk повторите попытку после восстановления сервиса. Если нужно восстановить авторизацию, выберите Подключить повторно для существующего подключения. При отключении и создании нового подключения состояние синхронизации теряется.
Отключите или подключите повторно #
Вы можете изменить целевые языки, движок локализации и режим на вкладке Настройки справочного центра в Studio. Переименовать учётную запись или подключить её повторно вы можете в подразделе Интеграции раздела Настройки. Чтобы восстановить авторизацию существующего подключения, выберите Подключить повторно.
Отключение прекращает чтение и запись и удаляет локальное подключение, историю запусков и данные синхронизации каждого элемента. Существующие переводы в Zendesk сохраняются. Если затем создать новое подключение, оно установит новую точку отсчёта: первая синхронизация сохранит уже имеющиеся полные переводы и переведёт недостающие материалы. Когда доступ больше не нужен, отдельно отзовите авторизацию у провайдера. При необходимости восстановите прежний опубликованный текст прямо в Zendesk.
Собирайте события в Radar #
Подключение также передаёт в Radar события справочного центра. В статье Как собирать переводы для измерения описано, как настроить события и импортировать историю провайдера перед измерением на исторических данных.
Если ручной перевод работает, но новые события статей не появляются, проверьте регистрацию вебхука подключения и доставку событий. Авторизация может пройти успешно, даже если у учётной записи нет прав администратора для регистрации вебхука. В подразделе Интеграции раздела Настройки выберите Подключить повторно для существующего подключения Zendesk и авторизуйтесь как администратор. Прежде чем полагаться на автоматический сбор, опубликуйте тестовую статью и проверьте её событие в Radar.