Просмотреть исходный

В данном разделе приведены сведения по настройке заданий автоматизации на отправку уведомлений Телеграмм в автоматическом режиме. Настройка доступна только для узлов Платформа НЕЙРОСС.

Общие сведения об автоматизации и порядке настройке заданий автоматизации приведены в разделе [Автоматизация].

Общие сведения

Платформа НЕЙРОСС использует задачи автоматизации для информирования ответственных лиц о каких-либо событиях в системе. Кроме отправки электронных писем возможна отправка уведомлений в Телеграмм-канал.

Функция отправки Telegram-уведомлений наиболее востребования для информирования о тревожных событиях или других событиях системы, зафиксированных в Системном журнале. В этом случае удобно в тексте сообщения включить информацию о событии. Для этого используются те же переменные, которые перечислены в подразделе [Тип действия: отправка письма по email].

Для получения сообщений в мессенджер Telergam необходимо знать идентификатор канала и добавить бота @neyross_bot в свой список контактов. Может использоваться как личный канал пользователя, так и канал группы.

При выборе в качестве параметра действия «Telegram-уведомление», вам потребуется:

Сформулировать текст сообщения.
Ввести ввести идентификатор (id) канала пользователя/группы.
При необходимости, включить отправку во вложении к сообщению кадров со «связанных» камер видеонаблюдения.

Подготовка к настройке

Установите клиента Telegram на устройство и настройте свой аккаунт.

Выясните идентификатор (ID) своего канала.

ID канала пользователя

Для получения идентификатора своего канала вы можете воспользоваться QR-кодом или прямой ссылкой на бота, доступными при наведении на иконку поля Идентификатор чата/канала.

Интерфейс НЕЙРОСС > Тип действия: Telegram-уведомление > action_telegram_QR.png

После перехода по ссылке запустите бота. Вы получите сообщение вида:

Ваш 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 в поле Идентификатор чата/канала.

Порядок действий

Чтобы создать новое задание автоматизации:

В списке заданий нажмите на кнопку Добавить новое задание .

Интерфейс НЕЙРОСС > Автоматизация > action_newtask.png

Настройте параметры сигнала [Сигналы автоматизации].

Рекомендуется настроить задание на запуск по событиям и настроить фильтр событий на «отлавливание» целевых событий.

В блоке Параметры действия выберите из раскрывающегося списка Telegram-уведомление.

Интерфейс НЕЙРОСС > Тип действия: Telegram-уведомление > action_telegram.png

Настройте параметры задания согласно таблице ниже.

Поле

Комментарий

Сообщение

Введите текст сообщения, например:

Возникла тревога ${event.headline}
Время отправки ${event.sent}
Элемент-источник ${element.name}

Полный перечень доступных переменных приведён в подразделе [Тип действия: отправка письма по email].

Идентификатор чата/канала

Укажите идентификатор (ID), полученный на предыдущем этапе.

Отправлять связанные кадры архива

Отправлять фрагменты видеоархива

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

При этом должно быть выполнено несколько условий:

Задание автоматизации должно быть настроено на действие по событию [Тип сигнала: по событию].
У источника события должна быть настроена связь с медиаисточником(ми) [«Привязка» камер источникам тревог].
У «связанных» медиаисточников есть задания на запись и есть видеоархив на время возникновения события.

Размер частей видеоархива (в секундах)

Укажите длину фрагмента видеоархива в случае, если в поле Отправлять фрагменты видеоархива задано Да.

Вам потребуется указать число секунд.

ВНИМАНИЕ

Если запись ведется по событиям, необходимо включить предтревогу и установить значение длительности предтревоги не меньшее, чем заданное в этом поле [Запись по событиям 24/7 + комбинированный режим].

Нажмите на кнопку Сохранить задание.

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

Пример Telegram-уведомления с кадром по тревоге видеоаналитики

Дополнительная информация по настройке заданий автоматизации приведена в разделе [Автоматизация]. Примеры заданий приведены в разделе здесь.

Порядок работы

По факту получения события, удовлетворяющего в параметрах запуска задания, фильтру, осуществляется запуск задания автоматизации.
Вычленяется источник события. Для этого источника определяется список «связанных камер». Если источника события нет, отправляется текст из шаблона сообщения с пустыми параметрами. Если для источника события нет «связанных камер», кадры/видео не отправляются.
Если в поле Отправлять связанные кадры архива установлено Да, для найденных камер производится формирование кадров архива за время возникновения события. Если архив не найден, кадры не отправляются.
Если в поле Отправлять фрагменты видеоархива установлено Да, для найденных камер производится создаются задачи на экспорт видеоархива интервал:
[время события — N, время события]
Где N — размер частей видеоархива
Если архив не найден, кадры не отправляются.
По итогу в бот отправляется текст сообщения по шаблону, а также найденные кадры архива и видеофрагменты.

ПОДСКАЗКА

Если на момент события срабатывания задания автоматизации есть архивная запись по нескольким потокам камеры, в телеграмм будут отправлены фрагменты видеоархива по каждому потоку.

По кнопке Выполнить тест в бот отправляется следующий текст:

test