Туториал

Отправка сообщений в Telegram из Konso Observability

Пошаговая инструкция: настройте Telegram-провайдер в Dispatch и подключите его к алертам Observability — получайте уведомления о проблемах прямо в мессенджер.

Попробовать Konso arrow_forward
bolt

TL;DR

  • check_circleРезультат: алерт Konso Observability отправляет сообщение в Telegram-канал при срабатывании
  • check_circleНужно: Telegram-аккаунт для создания бота, доступ к Konso Dispatch и Observability
  • check_circleВремя на настройку: 15–20 минут
  • check_circleШаги: создать бота → получить chat ID → добавить провайдер в Dispatch → подключить к алерту → протестировать
  • check_circleПосле настройки смена канала или бота не требует изменений в коде приложения

Что вы настроите

В конце этого туториала алерт Konso Observability будет автоматически отправлять Telegram-сообщение при каждом срабатывании — с именем алерта, временем и ссылкой на детали.

Для этого потребуется: создать Telegram-бота, добавить его в Konso Dispatch как провайдера и привязать провайдера к алерту.

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

Откройте Telegram и найдите бота @BotFather. Отправьте команду /newbot, введите имя бота (например, «Konso Alerts») и username (должен заканчиваться на bot, например konso_alerts_bot).

BotFather выдаст токен вида 1234567890:ABCdefGHIjklMNOpqrSTUvwxyz — сохраните его, он понадобится на шаге 3.

[Скриншот: диалог с BotFather, выделен токен бота]

Получите Chat ID канала или группы

Добавьте созданного бота в Telegram-канал или группу, куда должны приходить уведомления. Для каналов дайте боту права администратора.

Чтобы узнать Chat ID, отправьте любое сообщение в канал/группу, затем откройте в браузере:
https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates

В ответе найдите поле chat.id — это числовое значение, например -1001234567890. Для каналов ID обычно отрицательный и начинается с -100.

[Скриншот: ответ getUpdates с выделенным полем chat.id]

Добавьте Telegram-провайдер в Konso Dispatch

Перейдите в Konso → Utility → Messaging → Providers. Нажмите Add.

В форме выберите Type = Telegram и заполните:

  • Provider Name: например «Telegram Alerts Bot»
  • Bot Token: токен от BotFather
  • Chat ID: значение из шага 2
  • Отметьте Active

Нажмите Save. Провайдер появится в списке.

[Скриншот: форма добавления провайдера с заполненными полями Type=Telegram, Bot Token и Chat ID]
[Скриншот: новый провайдер в списке со статусом Active]

Откройте алерт в Konso Observability

Перейдите в раздел Observability → Alerts. Откройте существующий алерт или создайте новый кнопкой Add.

Если создаёте новый — настройте условие алерта: выберите метрику или уровень логов, задайте порог и временное окно.

[Скриншот: список алертов в Konso Observability]
[Скриншот: форма настройки условия нового алерта]

Подключите Telegram-провайдер к алерту

В настройках алерта найдите раздел Delivery Providers (или Notifications). Нажмите Add Provider и выберите созданного на шаге 3 Telegram-провайдера.

Опционально настройте шаблон сообщения — можно использовать переменные: {{alertName}}, {{triggeredAt}}, {{value}}.

Сохраните алерт кнопкой Save.

[Скриншот: раздел Delivery Providers в настройках алерта с выбранным Telegram-провайдером]

Протестируйте уведомление

Нажмите кнопку Test (если доступна) или дождитесь реального срабатывания алерта. Проверьте Telegram-канал — уведомление должно прийти в течение нескольких секунд.

Если сообщение не пришло — проверьте:

  • Бот добавлен в канал и имеет права на отправку сообщений
  • Chat ID указан корректно (для каналов — со знаком минус)
  • Провайдер отмечен как Active

[Скриншот: пришедшее Telegram-сообщение с данными алерта]

tips_and_updates

Совет

Создайте отдельного бота и отдельный канал для production-алертов, и ещё один — для dev/staging. Настройте два провайдера в Dispatch и используйте правила маршрутизации по полю env, чтобы тестовые алерты не засоряли production-канал.

lightbulb

Следующий шаг

Настройте шаблон сообщения алерта с переменными — добавьте имя сервиса, ссылку на логи и значение метрики. Так дежурный инженер получит всё необходимое прямо в Telegram, без перехода в интерфейс Konso.

Полезные материалы

Подробнее о возможностях Dispatch и маршрутизации сообщений:

  • check_circleЧто такое Konso Dispatch — /kb/guides/what-is-konso-dispatch
  • check_circleПравила маршрутизации Dispatch — /kb/guides/dispatch-routing-rules
  • check_circleШаблоны сообщений в Konso Dispatch — /kb/guides/dispatch-message-templates

Готово — алерты идут в Telegram

Подключите Konso и настройте уведомления для вашего проекта за 15 минут

Начать бесплатно arrow_forward

Частые вопросы

Можно ли отправлять алерты в личный чат Telegram, а не в канал? expand_more

Да. Отправьте боту любое сообщение в личку, затем вызовите getUpdates — в ответе будет chat.id вашего личного чата (положительное число). Используйте его как Chat ID в настройках провайдера.

Несколько алертов могут использовать одного провайдера? expand_more

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

Как изменить канал, не трогая настройки алерта? expand_more

Отредактируйте провайдера в Dispatch (Providers → Edit) — обновите Chat ID. Все алерты, использующие этого провайдера, автоматически начнут отправлять сообщения в новый канал без изменений в самих алертах.

Что делать, если сообщения не приходят? expand_more

Проверьте три вещи: 1) бот добавлен в канал и имеет права администратора, 2) Chat ID указан правильно — для каналов он отрицательный и начинается с -100, 3) провайдер отмечен как Active в Dispatch. Для отладки вызовите getUpdates вручную с токеном бота.