Подключиться
Yandex Tracker

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-123).

В этой статье: