Нотификация через Telegram от Аудиологгера
Нотификацию о пропаже/появлении сигнала в канале Логгера можно настроить через Telegram-бота. В данной инструкции мы рассмотрим один из способов, как настроить такое взаимодействие.
Перед тем как перейти к описанию настройки, следует отметить, что предлагаемый вариант может служить отличным дополнением для своевременного оповещения технической команды комплекса, однако мы рекомендуем наравне с ним использовать наше стандартное решение – почтовую нотификацию.
1. Создание Telegram Bot
В приложении Telegram необходимо найти через поиск специального бота - @botFather. Далее следует запустить его, введя команду /start и отправить команду /newbot. После этого бот предложит ввести название чата (в нашем примере logger_test) и ввести уникальный никнейм. Если введенный никнейм уже существует, либо содержит недопустимые символы бот предложит заменить его.
Если имя удовлетворяет всем требованиям, то в ответном сообщении будет поздравление с токеном доступа к боту (рис.1).
Рис.1. Информация о токене доступа к телеграмм-боту
После выполнения вышеуказанных действий, можно открывать в браузере страницу служебного интерфейса с сообщениями. Для этого необходимо сформировать URL-адрес следующего вида:
https://api.telegram.org/botтокен/getUpdates
Если все выполнено правильно, страница откроется с результатом:
{"ok":true,"result":[]}
Если где-то допущена ошибка, выведется сообщение следующего вида:
{"ok":false,"error_code":401,"description":"Unauthorized"}
2. Создание Telegram канала
Для отправки ботом сообщений необходимо будет определить параметр chat_id. Для нотификаций может использоваться как индивидуальный чат, так и чат канала.
Так как на канал можно подписать несколько пользователей, за счет чего такой вариант получается более гибким, рассмотрим именно его.
Канал можно создать в боковом меню Telegram (рис.2).
Рис.2. Создание канала
Далее следует придумать ему название – в нашем примере Logger Tract Test. После чего необходимо добавить созданного бота в качестве администратора.
После добавления бота в канал, обновите информацию в браузере. Там будет сообщение вида (рис.3):
Рис.3. chat_id из сообщения
Необходимо скопировать номер chat_id. А после проверить отправку сообщений ботом. Для этого необходимо сформировать ссылку вида:
В случае корректной настройки, бот отправит в канал сообщение вида (рис.4):
Рис.4. Сообщение от бота в Телеграмм-канал
3. Создание исполняемых файлов
Необходимо создать файлы, которые будут исполняться в случае отсутствия сигнала в каналах логгера. Для каждого канала создается 2 файла – первый срабатывает на пропажу сигнала, второй на появление сигнала.
Сохранять файлы лучше ближе к корневому каталогу диска (Например: C:\AlarmFiles).
!Примечание: в пути к каталогу хранения исполняемых файлов не должно быть пробелов.
Содержание файла CH1_OFF.cmd, исполняемого в случае отсутствия сигнала в первом канале:
@echo off
REM фиксируем время события и присваиваем его переменной message
set message="CH1+OFF+-+%time:~0,2%:%time:~3,2%:%time:~6,2%+%date:~0,2%-%date:~3,2%-%date:~6,4%"
REM отправляем запись в log.txt
echo %date:~6,4%-%date:~3,2%-%date:~0,2% %time:~0,2%:%time:~3,2%:%time:~6,2% CH1 OFF >> c:\AlarmFiles\LOG.txt
REM отправляем message в телеграм
cURL https://api.telegram.org/bot6182************ystI60SJNnlnNaPGjWfdfXHMS4/sendMessage?chat_id=-100******425^^^&text=%message%
Результатом исполнения этого файла будет отправленное в канал сообщение вида (рис.5):
Рис.5. Сообщение от бота в Телеграмм-канал при отсутствии сигнала в первом канале
Дополнительно с сообщением в Телеграмм, в текстовый файл LOG.txt будет добавлена запись вида: 2023-04-20 15:03:19 CH1 OFF. Это сделано для удобства дальнейшего анализа и фиксации события даже в случае недоставки сообщений.
Для настройки работы со своим ботом и со своим каналом необходимо изменить в ссылке токен бота и chat_id. Три значка ^^^ - необходимый атрибут в такой записи. Для удобства, править предпочтительнее в Notepad++.
Сообщение и запись в логе можно меняет. Запись в логе может содержать русские буквы. В качестве пробелов в сообщении ставится знак +.
Аналогично создается файл, исполняемый в момент появления сигнала в канале. В нашем примере это файл CH1_ON.cmd.
Примеры файлов прикреплены к настоящей инструкции в разделе Файлы.
4. Привязка исполняемых файлов к каналу Аудио Логгера
В Аудио Логгере необходимо открыть Свойства канала .
На вкладке Мониторинг настроить уровни срабатывания и разрешить запуск программ, указав пути к исполняемым файлам.
Рис.6. Настройка вкладки Мониторинг
После этого настройка окончена.
