Telegram

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

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

Шаг 1. Настройка телеграм-ботаШаг 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Шаг 2. Настройка Tracker

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

2. На панели слева нажмите Очереди и выберите очередь.

3. В правом верхнем углу нажмите Настройки очереди.

4. На панели слева выберите Автоматизация → Триггеры и нажмите кнопку Создать триггер.

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

6. Настройте условия срабатывания триггера так, чтобы он срабатывал, когда задача типа Задача переходит в статус Требуется информация:

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

   2. Добавьте условие Тип → равно → Задача.

   3. Добавьте условие Статус → стало равно → Требуется информация.

   

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

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

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

     {
         "chat_id": "<идентификатор_чата>",
         "text": "Требуется информация по задаче [{{issue.key}}: {{issue.summary}}](https://tracker.yandex.ru/{{issue.key}})"
     }
     

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

   Примечание

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

   

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

Чтобы проверить работу триггера, переведите задачу типа Задача в статус Требуется информация. Триггер отправит в чат Telegram сообщение с текстом: «Требуется информация по задаче TEST-123: Настроить триггеры».