Интеграция HelpDeskEddy с Jira позволит IT-команде и службе поддержки работать вместе для быстрого решения запросов пользователей.
Подключение в систему
Для интеграции Jira с HelpDeskEddy перейдите в меню "Настройки интеграции Jira" из Управления:
В облачной системе авторизацию можно произвести как по паролю, так и используя API токен. Коробочная версия предполагает авторизацию только по паролю. В будущем для облачных решений планируется оставить только авторизацию по API токену, поэтому рекомендуем изначально использовать для авторизации данный способ.
Для подключения с помощью логина и пароля используйте данные авторизации вашей системы Jira.
Если же Вы осуществляете авторизацию по логину и токену, то его необходимо изначально сгенерировать, авторизовавшись на портале Jira. Для этого:
- Авторизируйтесь в https://id.atlassian.com;
- Откройте настройки Вашего профиля/аккаунта - https://id.atlassian.com/manage-profile/profile-and-visibility
- В разделе "Безопасность" => Token API найдите "Создание токенов API и управление ими"
- В открывшемся окне нажмите на "Сreate API Token", введите Label (название) и скопируйте сам Токен:
Далее в HelpDeskEddy необходимо в интерфейсе добавления интеграция укажите:
- Домен системы. Например: https://hdejiratest.atlassian.net;
- Логин + API токен (который сгенерировали на предыдущем шаге) или пароль;
- Синхронизация полей. Позволяет записывать изменения с выбранными полями Jira (Приоритет, Статус, Исполнитель, Решение) в комментарии заявки HelpDeskEddy:
При успешном соединении вы увидите уведомление, а также ниже отобразится список доступных настроек для работы с проектами и заявками Jira:
Журнал ошибок Jira
Журнал ошибок включает в себя всю информацию по каким-либо ошибкам подключения или работы интеграции.
Ошибка "Домен уже используется" |
Может быть в случае отсутствии прав администратора Jira или при отсутствии возможности создать/редактировать вебхук в Jira. Для работы интеграции Вашей системе необходимо получать обратные вызовы с информацией, поэтому помимо авторизации пользователя система отправляет ряд запросов на настройку обмена сообщениями между системами. Проверьте права пользователя, пользователь должен иметь доступ к настройкам системы Jira (как правило достаточно просто изменить права на администратора), и должен иметь доступ к настройке вебхуков. |
Пример работы интеграции Jira
При работе с Jira существует несколько особенностей которые необходимо учитывать:
- При создании проекта или задачи в Jira от имени пользователя по которому происходит интеграция с системой HelpDeskEddy - данные игнорируются и не интегрируются в систему HelpdeskEddy. Поэтому рекомендуем для тестирования и работы с интеграцией использовать дополнительный профиль пользователя в Jira.(не используемый для интеграции между системами).
- Типизация Jira. При отсутствии хотя бы одного доступа к какому-либо из типов проекта в настройках интеграции - создать заявку в Jira - не предоставляется возможным. Потому необходим доступ хотя бы к одному из Типов проекта.
Принятие заявок из Jira
Создание новой задачи в проекте на стороне Jira:
Отображение этой задачи в HelpDeskEddy в виде заявки:
При добавлении ответов и внесение изменений в существующие задачи Jira, эти данные также будут синхронизированы в HelpDeskEddy.
Пример добавления ответа и изменения исполнителя на стороне Jira:
Отображение изменений на стороне HelpDeskEddy:
Создание заявок в Jira
Для создания задачи в Jira необходимо в существующей заявке открыть комментарий, нажать на кнопку "Jira", обязательно указать тип и проект в который будет добавлена данная задача:
По ссылкам в верхнем левом углу заявки можно перейти в проект и конкретную задачу в Jira:
Как HelpDeskEddy определяет, какие задачи из Jira связаны с текущей заявкой:
1. Когда в HelpDeskEddy в существующей заявке в комментарии по кнопке создается задача в Jira - HDE создает Jira задачу и связывает её с заявкой.
2. Когда в Jira создается новая задача в подключенном к интеграции проекте - Jira в HelpDeskEddy создает новую заявку и связывает их.
3. Когда в Jira создается задача, в теме которой есть [#unique_id] (уникальный айди) заявки HelpDeskEddy - она находит существующую заявку в HDE и привязывает задачу к ней, вместо создания новой.
При переходе в конкретную задачу Jira можно увидеть отправленный комментарий, а также мета-данные по заявке:
При повторном осуществлении отправки информации в Jira в рамках текущей заявки, можно как добавить комментарий в уже созданные задачи, так и создать новые. Данная информация отображается при выборе пункта Jira в комментарии.