В данном разделе приведены сведения по настройке заданий автоматизации на отправку уведомлений Телеграмм в автоматическом режиме. Настройка доступна только для узлов Платформа НЕЙРОСС.
Общие сведения об автоматизации и порядке настройке заданий автоматизации приведены в разделе [Автоматизация].
Общие сведения
Платформа НЕЙРОСС использует задачи автоматизации для информирования ответственных лиц о каких-либо событиях в системе. Кроме отправки электронных писем возможна отправка уведомлений в Телеграмм-канал.
Функция отправки Telegram-уведомлений наиболее востребования для информирования о тревожных событиях или других событиях системы, зафиксированных в Системном журнале. В этом случае удобно в тексте сообщения включить информацию о событии. Для этого используются те же переменные, которые перечислены в подразделе [Тип действия: отправка письма по email].
Для получения сообщений в мессенджер Telergam необходимо знать идентификатор канала и добавить бота @neyross_bot в свой список контактов. Может использоваться как личный канал пользователя, так и канал группы.
При выборе в качестве параметра действия «Telegram-уведомление», вам потребуется:
- Сформулировать текст сообщения.
- Ввести ввести идентификатор (id) канала пользователя/группы.
- При необходимости, включить отправку во вложении к сообщению кадров со «связанных» камер видеонаблюдения.
Подготовка к настройке
Установите клиента Telegram на устройство и настройте свой аккаунт.
Выясните идентификатор (ID) своего канала.
ID канала пользователя
Для получения идентификатора своего канала вы можете воспользоваться QR-кодом или прямой ссылкой на бота, доступными при наведении на иконку 
поля Идентификатор чата/канала.
После перехода по ссылке запустите бота. Вы получите сообщение вида:
Ваш ID: →1055492440→ User name: логин Имя: имя Фамилия: фамилия
Где цифры между стрелками → — идентификатор вашего канала. На примере это 1055492440.
QR-код со ссылкой доступен с версии 20.8 Платформы НЕЙРОСС. При работе на более ранних версиях Платформы НЕЙРОСС вы можете воспользоваться ботом @userinfobot, чтобы выяснить идентификатор своего канала.
Введите @userinfobot в строке поиска контактов. Вы получите сообщение вида:
Id: 1055492440 First: Ваше имя Last: Ваша фамилия
ID канала группы
НЕЙРОСС-бот позволяет узнать только идентификатор канала пользователя. Для получения идентификатора канала группы воспользуйтесь инструкцией ниже.
Откройте приложение телеграмм из браузера по адресу:
https://web.telegram.org/
Выберите требуемую группу. Её ID будет в адресной строке, например:
https://web.telegram.org/a/#-1002477873357
Где 1002477873357 — идентификатор канала группы.
На следующем шаге введите полученный ID в поле Идентификатор чата/канала.
Порядок действий
Чтобы создать новое задание автоматизации:
В списке заданий нажмите на кнопку Добавить новое задание 
.
Настройте параметры сигнала [Сигналы автоматизации].
Рекомендуется настроить задание на запуск по событиям и настроить фильтр событий на «отлавливание» целевых событий.
В блоке Параметры действия выберите из раскрывающегося списка Telegram-уведомление.
Настройте параметры задания согласно таблице ниже.
| Поле | Комментарий |
|---|---|
| Сообщение | Введите текст сообщения, например: Возникла тревога ${event.headline}
Время отправки ${event.sent}
Элемент-источник ${element.name}
Полный перечень доступных переменных приведён в подразделе [Тип действия: отправка письма по email]. |
| Идентификатор чата/канала | Укажите идентификатор (ID), полученный на предыдущем этапе. |
Отправлять связанные кадры архива Отправлять фрагменты видеоархива | Если осуществляется видеонаблюдение, ведется запись видео места возникновения события, и на момент фиксации события есть видеоархив по одной или нескольким камерам, то текст сообщения может быть дополнен кадрами видеоархива за время события, по одному кадру с каждой камеры. Для включения функции установите Да. При этом должно быть выполнено несколько условий:
|
| Размер частей видеоархива (в секундах) | Укажите длину фрагмента видеоархива в случае, если в поле Отправлять фрагменты видеоархива задано Да. Вам потребуется указать число секунд. ВНИМАНИЕ Если запись ведется по событиям, необходимо включить предтревогу и установить значение длительности предтревоги не меньшее, чем заданное в этом поле [Запись по событиям 24/7 + комбинированный режим]. |
Нажмите на кнопку Сохранить задание.
При необходимости и организационной возможности выполнения теста, нажмите выполнить тест в заголовке блока Параметры действия, при этом видеоматериалов не будет, так как нет источника тревоги.
Пример Telegram-уведомления с кадром по тревоге видеоаналитики
Дополнительная информация по настройке заданий автоматизации приведена в разделе [Автоматизация]. Примеры заданий приведены в разделе здесь.
Порядок работы
- По факту получения события, удовлетворяющего в параметрах запуска задания, фильтру, осуществляется запуск задания автоматизации.
- Вычленяется источник события. Для этого источника определяется список «связанных камер». Если источника события нет, отправляется текст из шаблона сообщения с пустыми параметрами. Если для источника события нет «связанных камер», кадры/видео не отправляются.
- Если в поле Отправлять связанные кадры архива установлено Да, для найденных камер производится формирование кадров архива за время возникновения события. Если архив не найден, кадры не отправляются.
Если в поле Отправлять фрагменты видеоархива установлено Да, для найденных камер производится создаются задачи на экспорт видеоархива интервал:
[время события — N, время события]
Где N — размер частей видеоархива
Если архив не найден, кадры не отправляются.
- По итогу в бот отправляется текст сообщения по шаблону, а также найденные кадры архива и видеофрагменты.
ПОДСКАЗКА
Если на момент события срабатывания задания автоматизации есть архивная запись по нескольким потокам камеры, в телеграмм будут отправлены фрагменты видеоархива по каждому потоку.
По кнопке Выполнить тест в бот отправляется следующий текст:
test