Telegram

Предположим, что нужно автоматически отправлять уведомления в мессенджер, когда у задачи меняется статус. Например, чтобы отслеживать готовность релизов к тестированию. Для этого можно настроить триггер, который будет отслеживать статусы задач типа Релиз и отправлять HTTP-запрос, когда статус задачи изменится на Можно тестировать.

В мессенджере Telegram для автоматической отправки сообщений в групповые чаты и отдельным пользователям используются боты. Чтобы отправлять уведомления из Tracker в Telegram, создайте телеграм-бота и настройте триггер, который будет отправлять сообщения от имени бота с помощью HTTP-запросов.

Шаг 1. Настройка телеграм-бота

1. Создайте нового телеграм-бота:

   1. В мессенджере Telegram добавьте в контакты бота @BotFather и отправьте ему сообщение /start.

   2. Отправьте боту сообщение /newbot и следуйте инструкциям: придумайте для бота отображаемое имя (например, My Company) и имя аккаунта (например, MyCompanyBot). Имя аккаунта должно иметь окончание bot.

   В ответ вы получите сообщение об успешном создании бота. В сообщении будет указан токен — секретный код, который потребуется для обращения к вашему боту через API. Токен имеет вид 1234567890:ABC123-defHIJ...

2. Добавьте созданного бота в групповой чат Telegram, в который вы хотите отправлять оповещения из Tracker.
   Если вы хотите получать оповещения из Tracker в личных сообщениях, начните чат с ботом.

3. Узнайте идентификатор чата Telegram, в который вы хотите отправлять оповещения. Для этого можно использовать специальных ботов, например @myidbot:

   • Чтобы узнать идентификатор группового чата, добавьте в этот чат бота и отправьте ему сообщение /getgroupid. Обратите внимание, что идентификатор группового чата начинается с минуса -.
   • Чтобы узнать идентификатор вашего аккаунта для отправки личных сообщений, начните чат с ботом и отправьте ему сообщение /getid.

Подробнее о настройке телеграм-бота можно узнать на сайте https://core.telegram.org/bots.

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

1. Авторизуйтесь в Tracker. У вас должны быть права на администрирование очереди, для которой вы будете настраивать триггер.

2. Перейдите в настройки очереди и в разделе Триггеры нажмите кнопку Создать триггер.

3. Введите название триггера, например Уведомления в Telegram.

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

   1. Выберите опцию Будут выполнены условия → Все.

   2. Добавьте условие Тип → равно → Релиз.

   3. Добавьте условие Статус → стало равно → Можно тестировать.

   

5. Нажмите кнопку Добавить действие и выберите HTTP-запрос.

6. Настройте запрос:

   • Метод — POST.
   • Адрес: https://api.telegram.org/bot<токен>/sendMessage
     В адрес подставьте значение токена, который вы получили при настройке телеграм-бота.
   • Способ авторизации — NoAuth.
   • Тип содержимого — application/json.
   • Тело запроса:

     {
         "chat_id": "<ID чата>",
         "text": "Пора тестировать задачу [{{issue.key}}: {{issue.summary}}](https://tracker.yandex.ru/{{issue.key}})"
     }
     

     В качестве значения параметра chat_id укажите идентификатор чата, который вы получили при настройке телеграм-бота.
     Чтобы добавить в тело запроса значения полей задачи, справа от поля ввода нажмите кнопку { } и выберите имя поля.
   • Заголовки оставьте пустыми.

   Примечание

   Если вы хотите использовать в HTTP-запросе другие методы и параметры, вы можете найти описание API телеграм-ботов на сайте https://core.telegram.org/bots/api.

   

7. Сохраните триггер.

Чтобы проверить работу триггера, переведите задачу типа Релиз в статус Можно тестировать. Триггер отправит в чат Telegram сообщение c текстом: Пора тестировать задачу TEST-123: Настроить триггеры (https://tracker.yandex.ru/TEST-1234).