Incident Garden

Подключение Telegram

Подключите Telegram-бота организации, получайте алерты в личные сообщения или групповой чат и подтверждайте их кнопками.

Администратор организации должен выполнить единоразовую операцию по подключению бота к организации. Далее каждый участник добавляет свой канал уведомлений (личные сообщения или групповой чат).

Часть 1. Подключение бота

Эта часть выполняется администратором.

Создайте бота через @BotFather

В Telegram откройте чат с @BotFather (официальный бот Telegram для создания других ботов). Отправьте команду /newbot и следуйте подсказкам. После создания бота скопируйте его токен.

Заведите отдельного бота для Incident Garden для каждой организации. Если бот уже где-то отвечал через webhook или опрос обновлений, после подключения он там работать перестанет.

Вставьте токен в Incident Garden

Откройте Settings → General и найдите карточку Telegram Bot. Вставьте полученный токен в поле и нажмите Connect.

Проверьте статус

В поле Bot карточки появится @<имя-вашего-бота>. Там же у бота можно сменить токен (Change token) или отключить его полностью (Disconnect).

Участники организации увидят имя бота при настройке Telegram-канала у себя в каналах нотификаций. Если вы замените бота, каждому придётся заново пройти процесс настройки. После отключения бота от организации (Disconnect) каждый участник подтверждает свой канал заново, даже если вы потом подключите того же бота.

Часть 2. Канал уведомлений

Алерты от бота в личные сообщения

Эту часть каждый участник выполняет у себя в настройках. Канал принадлежит вам и действует в текущей организации.

Откройте добавление канала

Перейдите в Settings → Notifications, нажмите Add Channel и выберите тип Telegram.

Если форма сообщает, что бот организации не подключён, обратитесь к администратору организации.

Откройте бота и нажмите Start

В форме добавления канала нажмите Open bot (или перейдите по ссылке t.me/<bot> с username вашего бота). В открывшемся чате нажмите Start.

Шаг Start обязателен. Telegram не разрешает ботам писать пользователю первым.

Узнайте свой Chat ID

Откройте в Telegram чат с @userinfobot и нажмите Start (или отправьте любое сообщение). Бот ответит вашим Chat ID (число вида 123456789). Скопируйте его.

Вставьте Chat ID

Вернитесь в форму добавления канала и вставьте скопированный Chat ID.

Подтвердите канал кодом

Бот пришлёт код подтверждения. Введите его в форме и канал станет активным. Чтобы по нему приходили алерты, добавьте его в правила уведомлений.

Алерты в групповой чат

Вместо личного Chat ID можно указать id группы, тогда алерты будут приходить в общий чат. Но помните, что это именно ваш канал нотификаций и он будет работать только когда ваши смены активны.

Узнайте id группы

Добавьте в группу бота @getidsbot и скопируйте из его ответа id группы (отрицательное число), после чего сразу удалите @getidsbot.

Вставьте id группы и подтвердите канал

В форме добавления канала вставьте id группы в поле Chat ID. Код подтверждения придёт в группу.

Когда Telegram превращает группу в супергруппу (например, после включения тем или публичной ссылки), id группы меняется. Канал со старым id перестанет работать и его нужно завести заново.

Управление алертами

Под алертом, который бот прислал вам в личные сообщения, есть две кнопки: Ack (взять в работу, то же, что Acknowledge) и Resolve (закрыть алерт). Нажатие равносильно такому же действию на странице алерта в системе.