Інтеграція з Jira

Перетворюйте відгук на задачу Jira без копіювання: задача створюється просто зі сторінки відгуку, уже заповнена відповідями, сторінкою, на якій був відвідувач, і його браузером, і містить посилання назад на відгук. Доступно на тарифах Business і Enterprise для Jira Cloud (your-company.atlassian.net).

Підтримується лише Jira Cloud: задачі створюються через її REST API v3. Jira Server і Data Center (Jira, розгорнуту на вашій власній адресі) підключити не можна.

Підключення Jira

Адміністратор простору підключає Jira один раз у розділі Налаштування → Інтеграції, після цього створювати задачі можуть усі в просторі.

Jira підключено: сайт, обліковий запис, від імені якого створюються задачі, і значення за замовчуванням для діалогу.
  1. Створіть API-токен у налаштуваннях облікового запису Atlassian (Security → API tokens).
  2. На картці Jira вкажіть адресу вашої Jira (https://your-company.atlassian.net — підійде й посилання, скопійоване з браузера), email облікового запису Atlassian, якому належить токен, і сам токен.
  3. Натисніть Connect Jira. Voxtrics перевірить дані в Jira до збереження, тож помилка виявиться одразу, а не під час першої задачі.

Токен зберігається в зашифрованому вигляді й більше не показується. Щоб пізніше змінити сайт, обліковий запис чи токен, натисніть Edit connection. Якщо залишити поле токена порожнім, збережений токен залишиться, доки сайт і email не змінюються.

Значення за замовчуванням

Після підключення виберіть Default project і Default issue type. З них починається діалог створення задачі; для кожної задачі їх можна змінити. У списку лише проєкти, у яких підключений обліковий запис може створювати задачі, а підзадачі виключено: у відгуку немає батьківської задачі.

Створення задачі з відгуку

Відкрийте будь-який відгук і знайдіть праворуч картку Jira. Кнопка Create Jira issue відкриває діалог:

  • Project і Issue type — за замовчуванням із налаштувань.
  • Summary — назва опитування і слова самого відвідувача (основний текст відгуку), а якщо тексту немає — оцінка і сторінка.
  • Description — усі відповіді, URL сторінки, опитування, час надсилання, браузер, ОС, пристрій, розмір вікна і мова. Можна редагувати як завгодно.
  • Attach the page snapshot — з'являється, якщо у відгуку є знімок сторінки або вибраного відвідувачем елемента.
Усе вже заповнено за відгуком: виправте потрібне й натисніть Create issue.

Натисніть Create issue. У кінець опису Voxtrics завжди додає посилання на відгук, щоб той, хто візьме задачу в Jira, міг відкрити відгук повністю; воно відкриється на потрібному сайті навіть у новій вкладці. Нова задача з'явиться на картці Jira і в журналі дій відгуку.

Один відгук можна надіслати в Jira до трьох разів (наприклад, баг і покращення) — діалог покаже, з якими задачами відгук уже пов'язаний. Коли задач три, картка Jira повідомляє про це замість кнопки створення.

Хто що може

  • Підключати, змінювати й відключати Jira — адміністратори простору.
  • Створювати задачі з відгуків — адміністратори й менеджери; в опитуваннях з обмеженням за командами — починаючи з ролі Writer (ті самі люди, що можуть змінювати статус відгуку).
  • Бачити задачі, пов'язані з відгуком — усі, хто може відкрити відгук.

Якщо щось пішло не так

  • «Jira did not accept this email and API token» — перевірте, що email саме той, під яким створено токен, і що токен скопійовано повністю.
  • «Jira no longer accepts the saved API token» — токени Atlassian мають термін дії, їх можна відкликати. На картці Jira буде Needs attention: створіть новий токен і збережіть його через Update token.
  • Jira відмовилася створювати задачу — зазвичай у проєкті Jira є обов'язкове поле, якого немає в діалозі (наприклад, компонент). У повідомленні буде причина від самої Jira.

Відключення

Disconnect видаляє збережений токен; створювати задачі не можна, доки Jira не підключать знову. Уже створені задачі залишаються в Jira і, як і раніше, видні на своїх відгуках.