--- metadata: - name: generator content: Diplodoc Platform v5.52.0 - property: og:type content: article - property: article:section content: Интеграция с другими сервисами - property: og:title content: Telegram - property: article:tag content: Техническая инструкция alternate: - https://yandex.ru/support/tracker/en/telegram.md - https://yandex.ru/support/tracker/ru/telegram.md - href: ru/telegram.md type: text/markdown title: Markdown version - href: llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/ru/llms.txt # Telegram {% note tip "" %} Чтобы получать уведомления из Трекера в Telegram, вы можете настроить подписку и выбрать Telegram в качестве канала для уведомлений. [Как настроить подписку](https://yandex.ru/support/tracker/ru/user/notification-constructor.md) Если возможностей стандартной подписки вам не хватает, можно использовать интеграцию с Telegram с помощью триггера, как описано на этой странице. {% endnote %} Предположим, что нужно автоматически отправлять уведомления в мессенджер, когда у задачи меняется статус. Например, чтобы отслеживать готовность релизов к тестированию. Для этого можно настроить [триггер](*trigger), который будет отслеживать статусы задач типа **Задача** и отправлять HTTP-запрос, когда статус задачи изменится на **Требуется информация**. В мессенджере Telegram для автоматической отправки сообщений в групповые чаты и отдельным пользователям используются боты. Чтобы отправлять уведомления из Трекера в Telegram, создайте Telegram-бота и настройте триггер, который будет отправлять сообщения от имени бота с помощью HTTP-запросов. ## Шаг 1. Настройка Telegram-бота {#bot-setup} 1. Создайте нового Telegram-бота: 1. В мессенджере Telegram добавьте в контакты бота `@BotFather` и отправьте ему сообщение `/start`. 1. Отправьте боту сообщение `/newbot` и следуйте инструкциям: придумайте для бота отображаемое имя (например, `My Company`) и имя аккаунта (например, `MyCompanyBot`). Имя аккаунта должно иметь окончание `bot`. В ответ вы получите сообщение об успешном создании бота. В сообщении будет указан [токен](*token), который потребуется для обращения к вашему боту через API. Токен имеет вид `1234567890:ABC123-defHIJ...` 1. Добавьте созданного бота в групповой чат Telegram, в который вы хотите отправлять оповещения из Трекера. Если вы хотите получать оповещения из Трекера в личных сообщениях, начните чат с ботом. Подробнее о настройке Telegram-бота можно узнать на сайте [https://core.telegram.org/bots](https://core.telegram.org/bots). ## Шаг 2. Получение идентификатора чата, темы чата, аккаунта {#get-id} Для получения идентификаторов чата, темы чата и аккаунта можно использовать специальных ботов, например `@myidbot`. - Чтобы узнать идентификатор группового чата, добавьте в этот чат бота и отправьте ему сообщение `/getgroupid`. Обратите внимание, что идентификатор группового чата начинается с минуса `-`. - Если групповой чат в Telegram разделен на темы, вы можете узнать идентификатор темы: 1. Отправьте сообщение в нужную тему. 1. Нажмите правой кнопкой мыши на отправленное сообщению и выберите **Копировать ссылку на сообщение**. 1. Вставьте ссылку в любой текстовый редактор. Вы получите ссылку вида `https://t.me/c/1112223334//3`, где `` — идентификатор темы чата. - Чтобы узнать идентификатор вашего аккаунта для отправки личных сообщений, начните чат с ботом и отправьте ему сообщение `/getid`. ## Шаг 3. Настройка Трекера {#tracker-setup} 1. Авторизуйтесь в Трекере. У вас должны быть права на администрирование очереди, для которой вы будете настраивать триггер. 1. На панели слева нажмите ![](_assets/svg/queues-ni.svg) **Очереди** и выберите очередь. {#queue} 1. На странице очереди в правом верхнем углу нажмите ![](_assets/svg/settings.svg) **Настройки очереди**. {#settings} 1. На панели слева выберите **Автоматизация**. {#automation} 1. В правом верхнем углу нажмите кнопку **Создать** → **Триггер**. {#create-trigger} 1. Введите название триггера, например «Уведомления в Telegram». 1. Задайте условия, чтобы триггер срабатывал, когда задача типа **Задача** переходит в статус **Требуется информация**: 1. [Добавьте условие](https://yandex.ru/support/tracker/ru/user/set-condition.md) **Тип** → **равно** → **Задача**. 1. Добавьте условие **Статус** → **стало равно** → **Требуется информация**. 1. Убедитесь, что слева от группы условий указан логический оператор **И**, чтобы триггер сработал при одновременном выполнении условий. ![](_assets/telegram-trigger-example.png){.border-yes} 1. Задайте действия триггера: 1. Нажмите кнопку **Добавить действие** и выберите **HTTP-запрос**. 1. Настройте запрос: - Метод — **POST**. - Адрес: `https://api.telegram.org/bot<токен>/sendMessage` Где `<токен>` — значение токена, который вы получили при [настройке Telegram-бота](#bot-setup). - Способ авторизации — **NoAuth**. - Тип содержимого — **application/json**. - Тело запроса: ``` { "chat_id": "<идентификатор_чата>", "message_thread_id": "<идентификатор_темы_чата>", "parse_mode":"markdown", "text": "Требуется информация по задаче [{{issue.key}}: {{issue.summary}}](https://tracker.yandex.ru/{{issue.key}})" } ``` Описание параметров: * `chat_id` — идентификатор чата, который вы получили при [настройке Telegram-бота](#bot-setup). * `message_thread_id` — идентификатор [темы чата](#get-id). * `parse_mode` — выбор способа для разбора текста. Укажите `"parse_mode":"markdown"`, чтобы использовать разметку Markdown. * `text` — текст сообщения. Чтобы добавить значения полей задачи, справа от поля ввода нажмите кнопку **{ }** и выберите имя поля. {% note info "" %} Если вы хотите использовать в HTTP-запросе другие методы и параметры, вы можете найти описание API Telegram-ботов на сайте [https://core.telegram.org/bots/api](https://core.telegram.org/bots/api#available-methods). {% endnote %} - Заголовки оставьте пустыми. ![](_assets/telegram-trigger-request-ext.png){.border-yes} 1. Сохраните триггер. Чтобы проверить работу триггера, переведите задачу типа **Задача** в статус **Требуется информация**. Триггер отправит в чат Telegram сообщение с текстом: «Требуется информация по задаче TEST-123: Настроить триггеры». [*token]: Токен — это секретный ключ для доступа к API. Он подтверждает пользователя или приложение, поэтому его нельзя передавать другим. [*trigger]: Триггер — это автоматическое правило. Оно выполняет действия с задачей, когда срабатывают заданные условия.