Zendesk

Переглянути на Github

Zendesk – це постачальник рішень для обслуговування клієнтів. Його набір функцій включає систему квитків, чат, статті довідкового центру та CRM для продажів. Цей додаток Zendesk здебільшого зосереджений на статтях довідкового центру та функціях локалізації. Він також містить дії для квитків.

Перед налаштуванням

Перш ніж підключитися, переконайтеся, що:

• У вас є обліковий запис Zendesk на екземплярі, до якого ви хочете підключитися.
• Ваш обліковий запис Zendesk має належні дозволи. Рекомендується мати роль адміністратора для Zendesk guide. Крім того, якщо ви хочете налаштувати тригери подій, вам потрібно мати роль адміністратора для Zendesk suppport або користувацьку роль з дозволом на керування вебхуками.

Підключення

1. Перейдіть до додатків і знайдіть Zendesk.
2. Натисніть Add Connection.
3. Назвіть своє підключення для подальшого використання, наприклад, ‘Мій клієнт’.
4. Заповніть базову URL-адресу екземпляра Zendesk, до якого ви хочете підключитися. Базова URL-адреса має вигляд https://<назва екземпляра>.zendesk.com. Зазвичай ви можете скопіювати цю частину URL-адреси, коли увійшли в свій екземпляр Zendesk. Примітка: для різних брендів див. примітку нижче.
5. Натисніть Authorize connection.
6. Дотримуйтесь інструкцій, які надає Zendesk, авторизуючи Blackbird.io діяти від вашого імені.
7. Коли ви повернетеся до Blackbird, переконайтеся, що з’явилося підключення і його статус Connected.

Підключення до різних брендів: Якщо у вашому Zendesk кілька брендів, вам потрібно створити окреме підключення для кожного бренду. Бренди відрізняються за базовою URL-адресою. Ви можете знайти базову URL-адресу, перейшовши до Settings > Account > Brand management > Brands і переглянувши атрибут Subdomain для кожного бренду. Використовуйте атрибут Subdomain у полі Base URL при підключенні.

Actions

General

• Search helpcenter locales повертає як мову за замовчуванням для центру допомоги, так і список мов, які були налаштовані в Zendesk. Ви можете знайти ці налаштування в центрі допомоги Zendesk > Settings > Language settings.

Articles

• Search articles пошук статей за різними параметрами фільтрації
• Get/create/update/archive article (metadata) використовується для налаштування метаданих, таких як розділ, автор, позиція, група дозволів, сегмент користувачів тощо.
• Search article missing locales повертає список мов, які були налаштовані в Zendesk, але відсутні для цієї статті. Це можна використовувати для створення відсутніх перекладів.
• Download article content завантажує вміст статті, який можна перекласти, у форматі файлу. Використовуйте цю дію разом з додатком для перекладу та ‘Upload article content’.
• Upload article content оновлює переклад статті або створює новий переклад, якщо його немає. Приймає перекладений файл (HTML) як вхідні дані. Оскільки ID статті включено в заголовок HTML-файлу, він оновить правильну статтю, але ви також можете вказати Article ID в дії.
• Add label to article у професійному або корпоративному тарифі додає мітку до статті.
• Delete label from article у професійному або корпоративному тарифі видаляє мітку зі статті.

Categories

• Get all categories повертає всі категорії в цьому екземплярі Zendesk. Ви також можете вказати змінну Missing translation in, у такому випадку ця дія поверне лише категорії, в яких справді відсутні переклади цією мовою.
• Get category articles повертає всі статті в цій категорії.
• Create/update/delete category.
• Get category missing translations повертає список мов, які були налаштовані в Zendesk, але відсутні для цієї категорії. Це можна використовувати для створення відсутніх перекладів.
• Update category translation створює переклад, якщо його немає, або оновлює переклад, якщо він уже існує.

Sections

• Get all sections повертає всі розділи в цьому екземплярі Zendesk. Додатково ви також можете вказати категорію, що обмежить пошук саме цією категорією. Ви також можете вказати змінну Missing translation in, у такому випадку ця дія поверне лише розділи, в яких справді відсутні переклади цією мовою.
• Create/update/delete section.
• Get section missing translations повертає список мов, які були налаштовані в Zendesk, але відсутні для цього розділу. Це можна використовувати для створення відсутніх перекладів.
• Update section translation створює переклад, якщо його немає, або оновлює переклад, якщо він уже існує.

Tickets

• Create/update/delete ticket.

Events

• On article published є найкориснішою подією. Ця подія спрацьовує, коли будь-яка стаття публікується, і може бути ідеальним тригером для відправлення статті на переклад на основі відсутніх перекладів (див. приклад). Вона має додатковий параметр Only source articles, який, якщо встановлено значення true, буде спрацьовувати, лише якщо опублікована стаття в оригінальній мові. Це допомагає уникнути створення нескінченних циклів публікації перекладів.
• Other події для коментарів до статей, підписок, голосувань та подій користувачів.

Приклад

Цей приклад показує один із багатьох випадків використання. Тут, коли стаття публікується, ми отримуємо відсутні переклади та завантажуємо статтю як HTML-файл. Потім ми створюємо новий проект Lokalise з відсутніми мовами як цільовими мовами та завантажуємо статтю. Після цього ми надсилаємо повідомлення в Slack, щоб сповістити менеджера проекту.

Відсутні функції

Більшість дій, пов’язаних із вмістом, уже існують. Однак у майбутньому ми можемо додати дії для:

• Вкладень до статей
• Тем і публікацій
• Коментарів
• Підписок
• Голосувань
• Детальної роботи з квитками

Дайте нам знати, якщо вам це цікаво!

Зворотний зв’язок

Зворотний зв’язок щодо нашої реалізації Zendesk завжди дуже вітається. Зв’яжіться з нами через наявні канали зв’язку або створіть проблему.