Telegram — настройка уведомлений на unRAID 6.8.3

Telegram — кроссплатформенный мессенджер, позволяющий обмениваться сообщениями и медиа файлами многих форматов.

Введение

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

Его блокировали на территории РФ, всячески запрещали и наказывали за обходы блокировки и по итогу, все равно он на плаву и продолжает развиваться, следуя курсу авторов, а блокировка снята и мессенджер полностью оправдан.

В статье будет описано как получать системные уведомления из OS unRAID, Radarr, Sonarr, Lidarr в свой телеграм канал и вещать их будет созданный бот.

О каких именно уведомлениях идет речь, можно чуть подробнее прочесть в статье по Pushover

Подготовка

Необходимо установить на свое мобильное устройство клиент Telegram для Вашей платформы и пройти регистрацию по номеру телефона. Не думаю, что это составит большого труда.

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

• Создание бота общая настройка;
• Создание отдельной группы для уведомлений;
• Настройка уведомлений из OS unRAID;

Настройка Telegram

Создание бота и общая настройка

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

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

По клику на этого «Отца ботов» в открывшемся окне последовательно выполняем действия.

Жмем кнопку «Запустить«:

Далее видим список команд управления, нас интересует создание нового бота, для этого отправляем команду:

/newbot

Продолжаем общаться, и вписываем его имя.

Я назову «MyNotifiGroupBoot«:

Теперь придумаем боту никнейм, чтобы заканчивалось на _bot

Я дам имя «MyNotifiGroup_bot«:

Итак, основная часть пройдена, у нас есть имя бота и его токен, сохраняем себе эту информацию, чтобы не потерять.

По желанию можно продолжить настройку и добавить описание и сменить аватарку.

Добавляем описание

Для добавления описания, команда /setdescription

Добавляем аватарку

Для установки аватарки боту, команда /setuserpic

Пару раз отправил ему как файл, начал ругаться. Отправляйте как фото, и ругаться не будет.

Если забыли Token

Вводим команду /mybots

Выбираем интересующего нас бота:

Далее кликаем по пункту API Token:

Результат вывода будет следующим:

Прочее

Для вызова общего списка команд пишем /help

Создание группы

Заходим в Telegram, в верхнем левом углу находим 3 горизонтальные линии нажав на которые во всплывшем меню выбираем:

«Создать группу»

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

После выбора названия и подходящей картинки нажимаем «Далее» и переходим к окну, в котором нам предлагается добавить участников.

Выбираем созданного нами ранее бота предварительно найдя его в поиске, в моем случае это «MyNotifiGroup_bot«

Далее нажимаем «Создать«:

Видим успешно созданную группу в которой уже присутствуют два участника, это естественно Вы и Ваш бот:

Активация бота в группе

Итак, мы имеем два чата:

• Один чат самого бота MyNotifiGroup_bot;
• Второй чат групповой, где находитесь Вы и Ваш бот;

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

Взаимностью он конечно не ответит…вообще никак не ответит, но активировался или нет, мы сразу поймем в следующем шаге.

Получаем Chat ID группы

Ссылка-приглашение

Для некоторых контейнеров не достаточно одного только API Token бота, дополнительно может понадобиться Chat ID.

Для начала необходимо получить ссылку на нашу созданную ранее группу. Для этого в открытом окне группы, в правом верхнем углу находим 3 точки

В выпадающем меню нажимаем

В открывшемся окне снова находим и нажимаем 3 точки

В выпадающем меню нажимаем

В открывшемся окне находим информацию о типе группы:

Нажимаем на «Частная«, в открывшемся окне следующая информация:

Нас интересует информация в самом низу, а именно «Ссылка-приглашение». Если не активирована, то активируем, получаем ссылку и идем с помощью нее получать ид у специализированного бота.

Чтобы узнать ид созданной группы Telegram, воспользуемся специализированным ботом.

Бот который выдает Chat ID

В строке поиска телеграм вводим «id bot«:

Пишем ему ссылку-приглашение из прошлого шага. Бот пройдет по нашей ссылке в группу и вернет информацию:

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

Настройка уведомлений из OS unRAID

Подтянем сервисные уведомления нашего домашнего сервера. Для этого переходим на вкладку SETTINGS, далее находим:

Notification Settings

Для начала нужно убедиться, что включены события, их периодичность, а также разрешены агенты для рассылки(галочки Agents), если нет — настраиваем и не забываем применить настройки кнопкой APPLY.

Для примера мои настройки выглядят следующим образом:

Спускаемся в самый низ, до заветного блока настроек Telegram уведомлений:

По пунктам:

• Agent function: включает или отключает уведомления в Telegram;
• Bot access token: вписываем сюда токен бота, который получили в шаге создания бота, или если забыли токен;
• Notification title: титул оповещения;
• Notification message: выбор типа уведомлений;

После ввода всех параметров, нажимаем кнопку APPLY, для применения настроек.

Итог будет выглядеть как у меня:

Обращаем внимание, что стала активна кнопка TEST, после нажатия которой и будет понятно, верно ли вписали Token бота, и активирован ли он в чате.

Если все выполнено верно, то именно в групповом чате, где Вы и Ваш бот, появится тестовое сообщение вида:

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

Решение проблем

Чаще всего тестовое уведомление приходит не в групповой чат, а в чат самого бота:

Чтобы исправить это, переходим в терминал анрейда и применяем команду:

rm /boot/config/plugins/dynamix/telegram/chatid

Теперь повторно проходим активацию бота в группе, а именно опять пишем боту сообщение:

Снова пробуем пройти тест:

Радуемся результату.

Настройка уведомлений из Radarr, Sonarr, Lidarr.

Подтянем уведомления из контейнеров медиаконтента, для этого понадобится:

• API Token
• Chat ID

Для всех трех контейнеров настройка идентична, заходим в WebUI каждого из контейнеров, далее SETTING, затем CONNECT.

В окне справа в разделе CONNECTIONS, нажимаем

Во всплывающем окне находим заветный Telegram, настраиваем в соответствии с пожеланиями, не забывая заполнить Bot Token = API Token и Chat ID.

Ниже не забываем протестировать и сохранить, кнопками TEST и SAVE

Приведу скрины готового результата:

Итог

Мы создали бота в мессенджере Telegram, группу для получения уведомлений из OS unRAID. Получили Token и Chat ID.

Активировали уведомления из таких контейнеров как: Sonarr, Lidarr, Radarr.