Импорт из Zendesk

Shayan TaslimОбновлено

С помощью импортера Zendesk перенесите публикации, комментарии, голоса «за» и подписчиков с форума сообщества Zendesk (Zendesk Gather) на доски UserJot.

Note

Этот импортер переносит форумы сообществ Zendesk, а не заявки Zendesk Support или статьи базы знаний Справочного центра. Чтобы перенести статьи Справочного центра Zendesk, используйте функцию Импорт существующего справочного центра.

Доступно администраторам и владельцам рабочего пространства на любом тарифе, включая бесплатный.

Создайте конфиденциальный OAuth-клиент в Zendesk

UserJot подключается к Zendesk с помощью OAuth-гранта client_credentials (URI перенаправления не требуется).

  1. Откройте Центр администрирования Zendesk → Приложения и интеграции → API → OAuth-клиенты.

  2. Создайте конфиденциальный OAuth-клиент и предоставьте ему области доступа hc:read и users:read. Они позволяют UserJot читать темы сообщества, публикации, комментарии, голоса, подписки и адреса электронной почты участников, не получая доступ к заявкам Support.

  3. Скопируйте Идентификатор клиента и Секрет клиента.

UserJot не хранит ваши учетные данные Zendesk постоянно. Они шифруются только на время выполнения фонового задания импорта и сразу же удаляются после его завершения.

Запустите импорт

  1. В UserJot откройте Настройки → Данные & импорт и нажмите Импорт из Zendesk.

  2. Введите субдомен Zendesk (субдомен .zendesk.com, например acme.zendesk.com; пользовательские домены, привязанные к хосту, например support.acme.com, не поддерживаются), идентификатор клиента и секрет клиента, затем нажмите Продолжить.

  3. На шаге Выбор тем сопоставьте каждую тему Zendesk с доской UserJot или оставьте для темы значение Не импортировать. Темы с названиями, совпадающими с названиями существующих досок UserJot (без учета регистра), будут выбраны автоматически. Сопоставьте хотя бы одну тему и нажмите Продолжить.

  4. Проверьте сведения на шаге Готово к импорту (обычно импорт занимает около 15 минут) и нажмите Начать импорт.

UserJot выполняет импорт в фоновом режиме и по завершении отправляет письмо администратору, запустившему импорт (тема письма: Your Zendesk import is done). Импорт можно запускать повторно: ранее импортированные публикации, комментарии, голоса и подписчики не дублируются благодаря проверке идентификаторов Zendesk.

Что импортируется, а что пропускается

Данные Zendesk

Как это работает в UserJot

Публикации

Импортируются как общедоступные запросы с заголовком, текстом (HTML преобразуется в обычный текст, не более 20 000 символов), исходной датой создания, статусом и общим числом голосов «за».

Статусы

none → Ожидает, planned → Запланировано, completed → Выполнено, not_planned и answered → Закрыто.

Комментарии

Импортируются в виде плоского списка в публикациях (не более 10 000 символов) с датой создания и числом голосов «за». Пустые комментарии без текста и изображений пропускаются.

Изображения

Внешние изображения по HTTPS копируются и прикрепляются. Изображения /hc/, размещенные на Zendesk, остаются ссылками в тексте, так как Zendesk блокирует их скачивание с серверов.

Голоса

Голоса «за» импортируются, а голоса «против» пропускаются. Для пользователей с адресом электронной почты или внешним идентификатором создаются отдельные записи о голосах (голоса удаленных пользователей Zendesk по-прежнему учитываются в общем числе для публикации).

Подписчики

Импортируются как подписчики запросов с исходной датой подписки, если у пользователя есть адрес электронной почты или внешний идентификатор.

Не импортируется

Заявки Support, статьи Справочного центра, теги контента, голоса «против», несопоставленные темы и журналы изменений.

Устранение неполадок

  • «Не удалось найти учетную запись Zendesk». Укажите субдомен .zendesk.com, а не пользовательский домен.

  • «Zendesk не принял этот идентификатор и секрет». Убедитесь, что для OAuth-клиента в Zendesk установлен тип Конфиденциальный, а не «Публичный».

  • «У этого OAuth-клиента нет доступа к форуму». Убедитесь, что для клиента включены обе области доступа: hc:read и users:read.

  • Ограничения частоты запросов. Темы можно загружать не чаще 10 раз в час. Импорт можно запускать не чаще 3 раз в час и 5 раз в день.

Дальнейшие действия

Эта статья ответила на ваш вопрос?