Интеграция с 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 и по-прежнему видны на своих отзывах.