Интеграция Jira + Пачка

Рассказываем о том, как сделать чат-бота c push-уведомлениями в чат из Jira, используя механизм Webhook или API. И все это прямо внутри Пачки.

Описание интеграции

Интеграция Пачка×Jira позволит вам получать события из вашей Jira прямо в чаты Пачки. Участники чата смогут быстро реагировать на проектные задачи, обсуждать их в тредах и ставить реакции.

Выглядит это следующим образом: в Пачке создается чат-бот, который забирает выбранного информацию из конкретного аккаунта Jira. Затем вы можете добавить этого бота в любой чат, куда он будет отправлять вам сообщения о событиях из этого проекта.

Можно создавать и добавлять в чаты любое количество ботов.

Возможные сценарии интеграции

Через Webhook или через API

Подключение Jira к Пачке по webhook подойдет для простых сценариев по типу получения уведомлений о новых задачах в чате. Она довольно легко настраивается прямо из интерфейса и доступна любому сотруднику.

Подключение Jira к Пачке по API подойдет для более сложных интеграций с кастомными сценариями и взаимодействием с ботом. Например, для того, чтобы через бота можно было создать новую задачу прямо из чата или посмотреть все задачи на день. При таком подключении пользователь самостоятельно пишет программу, по которой будет работать бот и подключает ее к Пачке и Jira, используя специальные токены.

Подключение через Webhook

Получение уведомлений из Jira в Пачку

1. Cоздайте интеграцию в Пачке

• Откройте раздел “Автоматизации” - “Интеграции”
• Выберите “Чат-боты и вебхуки”
• Нажмите “+”
• Придумайте название боту и поставьте логотип сервиса, который подключаете.
• Выберите тех, кто сможет настраивать бота. Они увидят его в своем разделе интеграций и смогут менять настройки.
• Выберите тех, кто сможет добавлять вашего бота в чаты. Эти пользователи смогут добавлять бота в чаты и получать от него сообщения

2. Создайте интеграцию в Jira

• Войдите в систему как пользователь с глобальным разрешением «Администрирование Jira»
• Выберите ⚙️ (в правом верхнем углу) >  Система > «Дополнительно» выберите WebHooks
• Нажмите «Создать веб-хук»

3. Настройте интеграцию в Jira

• В появившейся форме введите имя и описание вебхука. Эти поля нужны, чтобы вы легко смогли найти интеграцию в Jira, захотите ее поменять

• В строку url вставьте webhook url, который вы скопировали при создании интеграции из Пачки (см. п.1). Это адрес интеграции в Пачке, на него Jira будет присылать всю информацию.
• Выберите триггерные события, на которые будет реагировать интеграция. То есть, если вы выбрали “задача” - “создано”, то каждый раз, когда будет создаваться новая задача, Jira будет отправлять информацию об этом в Пачку. Таких событий может быть очень много, все они представлены чек-боксами, где нужно поставить галочку

• После того, как все события выбраны проверьте, чтобы не стояло галочки в поле “исключить основу”. Если она там будет стоять, то Jira будет отправлять пустые сообщения в Пачку

• Нажмите «Создать»

4. Настройте интеграцию в Пачке

Теперь, чтобы нужная информация приходила в Пачку нужно настроить шаблон. В настройках чат-бота нужно прописать, какие поля из всех, которые отправляет Jira, мы хотим транслировать. Для этого необходимо заполнить шаблон. В Пачке поддерживается два формата таких шаблонов: Mustache и Liquid. Чтобы его заполнить:

• Откройте интеграцию в Пачке, которую вы создавали в п.1
• Перейдите в раздел “Входящий Webhook”
• Найдите раздел "Шаблон"

В него можно добавлять фразы, которые не будут меняться и значение полей, которые присылает Jira. Вот как выглядит заполненный шаблон и сообщение бота, который его использует.

Ниже написали код Liquid, который позволит получать основные сведения о задачах. Просто скопируйте и вставьте его себе:

🔖**Новое событие в JIRA**
**Проект:**   {{issue.fields.project.name}}
**Название задачи:**   {{issue.fields.summary}}
👤**Кто изменил:**   {{user.displayName}}
‍**Статус задачи:**    {{issue.fields.status.name}}
**Приоритет:**   {{issue.fields.priority.name}}
**Ответственный:**   {{issue.fields.assignee.displayName}}
💭**Описание задачи:**
{{issue.fields.description}}
🪄**Ссылка:**
https://тут вставьте url вашего пространства(например: pachca.atlassian.net)/browse/{{issue.key}}

Если же вам нужно сделать интеграцию под более конкретный кейс, то можете самостоятельно заполнить шаблон. Подробнее о том откуда брать названия полей и как их прописывать в шаблоне можно почитать тут.

5. Добавьте интеграцию в нужный чат

• Зайдите в настройки чата (серая иконка в правом верхнем углу чата)
• Выберете “Интеграции”
• Добавите созданную интеграцию

Подключение через API

При подключении по API вы сами пишете код программы, по которой будет работать бот и подключаете его к Пачке и Jira, используя access-токены.

1. Получите Access-токен бота из Пачки

• Перейдите Автоматизации - Интеграции - Чат боты и Вебхуки
• Откройте бота из списка или создайте нового, нажав на +
• Заполните раздел “Основное”. Нужно придумать имя и аватарку боту, а также настроить его приватность
• Перейдите в раздел “API”
• Скопируйте Access-токен, по нему можно подключиться к Пачке и писать сообщения от лица бота

Теперь можно выполнять API запросы к Пачке

2. Получите Access-токен из Jira

Сначала нужно создать API token в JIRA, чтобы получить доступ к JIRA API.

• Перейдите по ссылке https://id.atlassian.com/manage/api-tokens
• Создайте API token
• Задайте имя токена -> нажимите Create
• Сохраните созданный токен, терять его нельзя

Теперь можно выполнять API запросы к JIRA. В каждый запрос передается заголовок, содержащий email (пользователя для которого был создан токен) и сам токен