Интеграция Яндекс.Трекер + Пачка

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

Выглядит это следующим образом:

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

Интеграцию можно сделать в двух вариантах:
1. Простой вариант. Тогда всем будут приходить одинаковые уведомления в один/несколько чатов. Этот вариант подойдет, если вы хотите сделать бота только для себя или вам достаточно, чтобы бот присылал все уведомления в групповой чат с командой.
2. Более сложный вариант. Тогда каждому коллеге будут приходить уведомления только по его задачам в личные сообщения.

В данной статье мы покажем первый и более простой пример: как настроить интеграцию с Яндекс Трекер, чтобы бот присылал вам в личные сообщения уведомления о том, что кто то написал комментарий под вашей задачей

‍

Шаг 1. Создание и настройка бота внутри Пачки

1. Создайте нового бота в Пачке:
   1. Откройте раздел “Автоматизации” - “Интеграции”
   2. Выберите “Чат-боты и вебхуки”
   3. Нажмите “+”
   4. Придумайте название боту и поставьте логотип Яндекс Трекера или любую другую аватарку
   5. Выберите тех, кто сможет настраивать бота. Они увидят его в своем разделе интеграций и смогут менять настройки.
   6. Выберите тех, кто сможет добавлять вашего бота в чаты. Эти пользователи смогут добавлять бота в чаты и получать от него сообщения
   7. Поменяйте другие настройки, если необходимо
2. Добавьте созданного бота в чат с командой, если вы хотите получать уведомления вместе (Настройки чата -> Добавить интеграцию).
   Если вы делаете бота только для себя и он будет отправлять уведомления вам в личные чаты, то этого делать не нужно.
   ‍

Шаг 2. Настройка Yandex.Tracker

1. Авторизуйтесь в Tracker. У вас должны быть права на администрирование очереди, для которой вы будете настраивать триггер.
2. На панели слева нажмите  Очереди и выберите очередь.
3. На странице очереди в правом верхнем углу нажмите  Настройки очереди.
4. На панели слева выберите Автоматизация.
5. В правом верхнем углу нажмите кнопку Создать → Триггер.
6. Введите название триггера, например «Уведомления о новых комментариях в Пачку».
7. Задайте условия, когда будет срабатывать отправка уведомления.
   Например, чтобы триггер срабатывал, когда вам приходит новый комментарий в задаче:‍
   1. Добавьте условие Событие → Создан комментарий.
   2. Добавьте условие Исполнитель → равно → Вы.
   3. Убедитесь, что слева от группы условий указан логический оператор И, чтобы триггер сработал при одновременном выполнении условий. Если вы настраиваете интеграцию с другой логикой, то можете использовать ИЛИ. Чтобы сменить логический оператор И/ИЛИ нажмите на блок с ним слева.
      

8. Задайте действия триггера и сохраните его:

1. Нажмите кнопку Добавить действие и выберите HTTP-запрос.
2. Настройте запрос:
   • Метод — POST.
   • Адрес —  https://api.pachca.com/api/shared/v1/messages
   • Способ авторизации — OAuth 2.0
   • Токен — откройте созданного бота в разделе "интеграции" в Пачке и скопируйте Acess Token в разделе "API". Он находится в настройках самого бота.
   • Тип токена — Bearer
   • Тип содержимого — application/json.
   • Тело запроса:

1//Тело запроса, при котором бот будет присылать уведомление о новых комментариях под вашими задачами
2{
3  "message": {
4    "entity_type": "user", //Поставьте тип "discussion", если хотите, чтобы бот отправлял сообщения в групповой чат
5    "entity_id": 515613, //Скопируйте ссылку на свой профиль в Пачке и укажите цифры в конце ссылки. Если хотите, чтобы бот отправлял сообщения в групповой чат, то вставьте ID чата. Его можно скопировать в настройках чата.
6    "content": "[{{issue.key}} {{issue.summary}}](https://tracker.yandex.ru/{{issue.key}})
7✍️**{{issue.modifier}}**: {{comment.text}}" //Текст сообщения, которое будет присылать бот. Можете поменять под себя и добавить новых переменных. Для этого нажмите на значок {} справа в Yandex Tracker
8  }
9}

‍

‍

Примечание: Если вы хотите использовать в HTTP-запросе другие методы и параметры, вы можете найти описание API ботов на сайте Пачки https://crm.pachca.com/dev/getting-started/overview/

‍

Шаг 3. Проверка интеграции

Чтобы проверить работу триггера, оставьте комменарий под любой из своих задач, в которой вы указаны, как "Исполнитель". Готово! Вы можете таким же образом сделать идругие триггеры под ваши запросы.