Подключение Telegram
Подключите Telegram-бота организации и получайте алерты в личные сообщения.
Incident Garden может доставлять алерты в Telegram. Каждая организация подключает собственного Telegram-бота: его создаёт администратор один раз, а затем каждый участник добавляет свой личный канал и получает уведомления в личные сообщения от этого бота.
Настройка состоит из двух частей:
- Администратор организации подключает бота — один раз на всю организацию.
- Каждый участник добавляет свой Telegram-канал в личных настройках.
Часть 1. Администратор подключает бота
Эту часть выполняет администратор организации один раз. Пока бот не подключён, участники не смогут добавить Telegram-канал.
Создайте бота через @BotFather
В Telegram откройте чат с @BotFather — это официальный бот Telegram для
создания других ботов. Отправьте команду /newbot и следуйте подсказкам:
задайте имя бота и его username (должен заканчиваться на bot).
После создания @BotFather пришлёт токен — строку вида
123456789:AA.... Скопируйте её.
Токен бота — это доступ к отправке сообщений от его имени. Не публикуйте его и не пересылайте в открытых чатах.
Вставьте токен в Incident Garden
Откройте Settings → General и найдите карточку Telegram Bot. Вставьте полученный токен в поле и нажмите Connect.
Проверьте статус
После успешного подключения карточка покажет статус Connected as @ВашБот — это имя бота, которое увидят участники.
Здесь же доступны действия:
- Replace token — заменить бота на другого (например, при ротации токена).
- Disconnect — отключить Telegram для организации.
Сообщите участникам username подключённого бота — он понадобится им на следующем шаге.
Часть 2. Участник добавляет свой канал
Эту часть выполняет каждый участник для себя. Канал привязывается к вашему аккаунту в текущей организации.
Откройте добавление канала
Перейдите в Settings → Notifications, нажмите Add Channel и выберите тип Telegram.
Если форма сообщает, что бот организации не подключён, обратитесь к администратору организации — он должен выполнить Часть 1.
Откройте бота и нажмите Start
В форме добавления канала нажмите Open bot (или перейдите по ссылке
t.me/<bot> с username вашего бота). В открывшемся чате нажмите Start.
Шаг Start обязателен. Telegram не разрешает боту писать пользователю первым: пока вы не нажали Start, бот не сможет прислать вам ни код подтверждения, ни алерт. Это правило Telegram, а не ограничение Incident Garden.
Узнайте свой Chat ID
Откройте в Telegram чат с @userinfobot и нажмите Start (или отправьте
любое сообщение). Бот ответит вашим Chat ID — это число вида
123456789. Скопируйте его.
Вставьте Chat ID
Вернитесь в форму добавления канала и вставьте скопированный Chat ID.
Chat ID вводится вручную — на текущем этапе это ограничение Telegram. Автоматическое определение Chat ID планируется в будущем.
Подтвердите канал кодом
Incident Garden отправит код подтверждения в Telegram через подключённого бота. Введите этот код в форме — после подтверждения канал станет активным и начнёт получать уведомления согласно вашим personal notification rules.
Если администратор сменил бота
Когда администратор заменяет бота организации (Replace token с другим ботом), каждый участник должен заново открыть нового бота и нажать Start — иначе новый бот не сможет доставлять ему сообщения по тому же правилу Telegram, что и при первом подключении. Сам Chat ID при этом не меняется.