Telegram
Предположим, что нужно автоматически отправлять уведомления в мессенджер, когда у задачи меняется статус. Например, чтобы отслеживать готовность релизов к тестированию. Для этого можно настроить триггер, который будет отслеживать статусы задач типа Релиз
и отправлять HTTP-запрос, когда статус задачи изменится на Можно тестировать
.
В мессенджере Telegram для автоматической отправки сообщений в групповые чаты и отдельным пользователям используются боты. Чтобы отправлять уведомления из Tracker в Telegram, создайте телеграм-бота и настройте триггер, который будет отправлять сообщения от имени бота с помощью HTTP-запросов.
Шаг 1. Настройка телеграм-бота
-
Создайте нового телеграм-бота:
-
В мессенджере Telegram добавьте в контакты бота
@BotFather
и отправьте ему сообщение/start
. -
Отправьте боту сообщение
/newbot
и следуйте инструкциям: придумайте для бота отображаемое имя (например,My Company
) и имя аккаунта (например,MyCompanyBot
). Имя аккаунта должно иметь окончаниеbot
.
В ответ вы получите сообщение об успешном создании бота. В сообщении будет указан токен — секретный код, который потребуется для обращения к вашему боту через API. Токен имеет вид
1234567890:ABC123-defHIJ...
-
-
Добавьте созданного бота в групповой чат Telegram, в который вы хотите отправлять оповещения из Tracker.
Если вы хотите получать оповещения из Tracker в личных сообщениях, начните чат с ботом. -
Узнайте идентификатор чата Telegram, в который вы хотите отправлять оповещения. Для этого можно использовать специальных ботов, например
@myidbot
:- Чтобы узнать идентификатор группового чата, добавьте в этот чат бота и отправьте ему сообщение
/getgroupid
. Обратите внимание, что идентификатор группового чата начинается с минуса-
. - Чтобы узнать идентификатор вашего аккаунта для отправки личных сообщений, начните чат с ботом и отправьте ему сообщение
/getid
.
- Чтобы узнать идентификатор группового чата, добавьте в этот чат бота и отправьте ему сообщение
Подробнее о настройке телеграм-бота можно узнать на сайте https://core.telegram.org/bots.
Шаг 2. Настройка Tracker
-
Авторизуйтесь в Tracker. У вас должны быть права на администрирование очереди, для которой вы будете настраивать триггер.
-
Перейдите в настройки очереди и в разделе Триггеры нажмите кнопку Создать триггер.
-
Введите название триггера, например
Уведомления в Telegram
. -
Настройте условия срабатывания триггера так, чтобы он срабатывал, когда задача типа Релиз переходит в статус Можно тестировать:
-
Выберите опцию Будут выполнены условия → Все.
-
Добавьте условие Тип → равно → Релиз.
-
Добавьте условие Статус → стало равно → Можно тестировать.
-
-
Нажмите кнопку Добавить действие и выберите HTTP-запрос.
-
Настройте запрос:
- Метод — 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.
-
Сохраните триггер.
Чтобы проверить работу триггера, переведите задачу типа Релиз в статус Можно тестировать. Триггер отправит в чат Telegram сообщение c текстом: Пора тестировать задачу TEST-123: Настроить триггеры (https://tracker.yandex.ru/TEST-1234)
.