Імпорт із Zendesk

Shayan TaslimОновлено

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

Note

Цей засіб імпорту переносить дані з форумів спільнот Zendesk, а не із заявок Zendesk Support чи статей бази знань Zendesk Help Center. Щоб перенести статті Zendesk Help Center, скористайтеся функцією Імпорт наявного довідкового центру.

Доступно адміністраторам і власникам робочого простору на всіх тарифах, зокрема Free.

Створіть конфіденційний клієнт OAuth у Zendesk

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

  1. Відкрийте Zendesk Admin Center → Apps and integrations → APIs → OAuth clients.

  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 копіюються та додаються. Розміщені на Zendesk зображення /hc/ залишаються посиланнями в тексті допису, оскільки Zendesk блокує завантаження із сервера.

Голоси

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

Підписники

Імпортуються як підписники запиту із початковою датою підписки, якщо в користувача є адреса електронної пошти або зовнішній ідентифікатор.

Не імпортується

Заявки Support, статті Help Center, теги вмісту, голоси «проти», нез зіставлені теми та журнали змін.

Вирішення проблем

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

  • «Zendesk не прийняв цей ідентифікатор і секрет». Переконайтеся, що для клієнта OAuth у Zendesk вибрано тип Confidential, а не Public.

  • «Цей клієнт OAuth не може читати форум». Переконайтеся, що для клієнта ввімкнено дозволи hc:read та users:read.

  • Обмеження частоти запитів. Теми можна завантажувати не частіше ніж 10 разів на годину, а імпорт можна запускати не частіше ніж 3 рази на годину та 5 разів на день.

Наступні кроки

Чи відповіла ця стаття на ваше запитання?