Документация

Канал Telegram

Версия v2.3.1 · Обновлено

Канал Telegram#

Telegram — это исходящий канал уведомлений на основе Telegram Bot API.

Он отправляет уведомления об алертах и поддерживает встроенные действия Acknowledge, Resolve, Shelve 1h и Unshelve, когда включена обработка polling/callback.

Обязательная конфигурация канала#

Типичная конфигурация:

{
  "bot_token": "123456789:AA...",
  "chat_id": "-1001234567890"
}

bot_token должен содержать двоеточие. Используйте BotFather для создания бота и получения токена.

Воркер Telegram#

Если используются действия или опрос Telegram, запустите сервис воркера Telegram, если ваша установка его предоставляет:

systemctl enable --now incidentrelay-telegram-worker

Для установок из RPM:

journalctl -u incidentrelay-telegram-worker -f

Telegram ID пользователя#

У пользователя в профиле может быть Telegram user ID. Он может использоваться для атрибуции действий и будущих сценариев прямого взаимодействия с пользователем.

Прокси#

Если серверу нужен прокси для доступа к Telegram, настройте прокси глобально. Храните bot token и chat ID в конфигурации канала.

Устранение неполадок#

Проверьте:

  • Токен содержит :.
  • Бот добавлен в целевой чат или канал.
  • chat_id корректен.
  • Воркер запущен, если ожидаются действия.
  • Прокси настроен, если сервер не может напрямую достичь Telegram.

Shelving#

В интерактивном сообщении доступны Shelve 1h и Unshelve. Telegram-пользователь должен быть связан с IncidentRelay user и иметь responder-доступ к команде алерта. Подробнее: Shelving.