Skip to Content
Last modified by admin on 2026/06/17 20:50
Show last authors
1 В данном разделе приведены сведения по настройке заданий автоматизации на отправку уведомлений Телеграмм в автоматическом режиме. Настройка доступна только для узлов Платформа НЕЙРОСС.
2
3 {{info}}
4 Общие сведения об автоматизации и порядке настройке заданий автоматизации приведены в разделе ~[[[doc:ui.Параметры узла.Автоматизация.WebHome]]].
5 {{/info}}
6
7 == {{id name="Типдействия:Telegram-уведомление-Общиесведения"/}}Общие сведения ==
8
9 Платформа НЕЙРОСС использует задачи автоматизации для информирования ответственных лиц о каких-либо событиях в системе. Кроме отправки электронных писем возможна отправка уведомлений в Телеграмм-канал.
10
11 Функция отправки Telegram-уведомлений наиболее востребования для информирования о тревожных событиях или других событиях системы, зафиксированных в Системном журнале. В этом случае удобно в тексте сообщения включить информацию о событии. Для этого используются те же переменные, которые перечислены в подразделе ~[[[doc:ui.Параметры узла.Автоматизация.Действия автоматизации.Тип действия\: отправка письма по email.WebHome]]].
12
13 {{info}}
14 Для получения сообщений в мессенджер [[Telergam>>url:https://ru.wikipedia.org/wiki/Telegram||shape="rect"]] необходимо знать идентификатор канала и добавить бота @neyross_bot в свой список контактов. Может использоваться как личный канал пользователя, так и канал группы.
15 {{/info}}
16
17 При выборе в качестве параметра действия «//Telegram-уведомлени//е», вам потребуется:
18
19 1. Сформулировать текст сообщения.
20 1. Ввести ввести идентификатор (id) канала пользователя/группы.
21 1. При необходимости, включить отправку во вложении к сообщению кадров со «связанных» камер видеонаблюдения.
22
23 == {{id name="Типдействия:Telegram-уведомление-Подготовкакнастройке"/}}Подготовка к настройке ==
24
25 Установите [[клиента Telegram>>url:https://ru.wikipedia.org/wiki/Telegram#%D0%9A%D0%BB%D0%B8%D0%B5%D0%BD%D1%82%D1%8B||shape="rect"]] на устройство и настройте свой аккаунт.
26
27 Выясните идентификатор (ID) своего канала.
28
29 **ID канала пользователя**
30
31 Для получения идентификатора своего канала вы можете воспользоваться QR-кодом или прямой ссылкой на бота, доступными при наведении на иконку [[image:attach:fa-info.png||thumbnail="true" height="21"]] поля **Идентификатор чата/канала**.
32
33 [[image:attach:action_telegram_QR.png||width="400"]]
34
35
36 После перехода по ссылке запустите бота. Вы получите сообщение вида:
37
38 {{code language="java"}}
39 Ваш ID: →1055492440→
40 User name: логин
41 Имя: имя
42 Фамилия: фамилия
43 {{/code}}
44
45
46 Где цифры между стрелками → — идентификатор вашего канала. На примере это **1055492440**.
47
48 {{info}}
49 QR-код со ссылкой доступен с версии 20.8 Платформы НЕЙРОСС. При работе на более ранних версиях Платформы НЕЙРОСС вы можете воспользоваться ботом **@userinfobot**, чтобы выяснить идентификатор своего канала.
50
51 Введите **@userinfobot** в строке поиска контактов. Вы получите сообщение вида:
52
53 {{code language="java"}}
54 Id: 1055492440
55 First: Ваше имя
56 Last: Ваша фамилия
57 {{/code}}
58 {{/info}}
59
60 **ID канала группы**
61
62 {{info}}
63 НЕЙРОСС-бот позволяет узнать только идентификатор канала пользователя. Для получения идентификатора канала группы воспользуйтесь инструкцией ниже.
64 {{/info}}
65
66 Откройте приложение телеграмм из браузера по адресу:
67
68 {{code language="java"}}
69 https://web.telegram.org/
70 {{/code}}
71
72 Выберите требуемую группу. Её ID будет в адресной строке, например:
73
74 {{code language="java"}}
75 https://web.telegram.org/a/#-1002477873357
76 {{/code}}
77
78 (% class="auto-cursor-target" style="letter-spacing:0.0px" %)Где 1002477873357 — идентификатор канала группы.
79
80
81 На следующем шаге введите полученный ID в поле **Идентификатор чата/канала**.
82
83 == {{id name="Типдействия:Telegram-уведомление-Порядокдействий"/}}Порядок действий ==
84
85 Чтобы создать новое задание автоматизации:
86
87 В списке заданий нажмите на кнопку **Добавить новое задание** [[image:attach:ui.Параметры узла.Автоматизация.WebHome@btn_plus_new.png||thumbnail="true" height="22"]].
88
89 [[image:attach:ui.Параметры узла.Автоматизация.WebHome@action_newtask.png]]
90
91 Настройте параметры сигнала ~[[[doc:ui.Параметры узла.Автоматизация.Сигналы автоматизации.WebHome]]].
92
93 {{info}}
94 Рекомендуется настроить задание на запуск по событиям и настроить фильтр событий на «отлавливание» целевых событий.
95 {{/info}}
96
97
98
99 В блоке **Параметры действия** выберите из раскрывающегося списка **Telegram-уведомление**.
100
101 [[image:attach:action_telegram.png]]
102
103
104 Настройте параметры задания согласно таблице ниже.
105
106 |=(((
107 Поле
108 )))|=(((
109 Комментарий
110 )))
111 |(((
112 Сообщение
113 )))|(((
114 (((
115 Введите текст сообщения, например:
116
117 {{code language="java"}}
118 Возникла тревога ${event.headline}
119 Время отправки ${event.sent}
120 Элемент-источник ${element.name}
121 {{/code}}
122
123 Полный перечень доступных переменных приведён в подразделе ~[[[doc:ui.Параметры узла.Автоматизация.Действия автоматизации.Тип действия\: отправка письма по email.WebHome]]].
124 )))
125 )))
126 |(((
127 Идентификатор чата/канала
128 )))|(((
129 Укажите идентификатор (ID), полученный на предыдущем этапе.
130 )))
131 |(((
132 Отправлять связанные кадры архива
133
134 Отправлять фрагменты видеоархива
135 )))|(((
136 (((
137 Если осуществляется видеонаблюдение, ведется запись видео места возникновения события, и на момент фиксации события есть видеоархив по одной или нескольким камерам, то текст сообщения может быть дополнен кадрами видеоархива за время события, по одному кадру с каждой камеры. Для включения функции установите **Да.**
138
139 {{info}}
140 При этом должно быть выполнено несколько условий:
141
142 1. Задание автоматизации должно быть настроено на действие по событию ~[[[doc:ui.Параметры узла.Автоматизация.Сигналы автоматизации.Тип сигнала\: по событию.WebHome]]].
143 1. У источника события должна быть настроена связь с медиаисточником(ми) ~[[[«Привязка» камер источникам тревог>>doc:ui.Параметры узла.Элементы.«Привязка» камер источникам тревог.WebHome]]].
144 1. У «связанных» медиаисточников есть задания на запись и есть видеоархив на время возникновения события.
145 {{/info}}
146 )))
147 )))
148 |(((
149 Размер частей видеоархива (в секундах)
150 )))|(((
151 (((
152 Укажите длину фрагмента видеоархива в случае, если в поле** Отправлять фрагменты видеоархива** задано **Да**.
153
154 Вам потребуется указать число секунд.
155
156 {{error}}
157 **ВНИМАНИЕ**
158
159 Если запись ведется по событиям, необходимо включить предтревогу и установить значение длительности предтревоги не меньшее, чем заданное в этом поле ~[[[neyross.Настройка Платформы НЕЙРОСС.Настройка функций видеонаблюдения.Настройка задач на запись.Запись по событиям 247 + комбинированный режим.WebHome]]].
160 {{/error}}
161 )))
162 )))
163
164 Нажмите на кнопку **Сохранить задание**.
165
166 {{info}}
167 При необходимости и организационной возможности выполнения теста, нажмите **выполнить тест** в заголовке блока **Параметры действия**, при этом видеоматериалов не будет, так как нет источника тревоги.
168 {{/info}}
169
170
171 [[image:attach:telegram_example.jpg||thumbnail="true" height="250"]]
172
173 //Пример Telegram-уведомления с кадром по тревоге видеоаналитики//
174
175
176 [[image:attach:telegram_example_video.jpg||width="236"]]
177
178 //Пример Telegram-уведомления с кадрами и видеофрагментами по тревоге точки доступа по шаблону//
179
180 {{code language="java"}}
181 10.1.29.38
182 ${event.headline}
183 ${element.name} — источник события
184 ${pass.facility} — код предприятия
185 ${pass.card} — номер карты
186 Владелец
187 ${person.name} ${person.patronymic} ${person.surname}
188 ${person.organization}, ${person.division}, ${person.post}
189 ${(person.properties?filter(p -> p.key == "extra")?first.value)!''}
190 {{/code}}
191
192
193 {{info}}
194 Дополнительная информация по настройке заданий автоматизации приведена в разделе ~[[[doc:ui.Параметры узла.Автоматизация.WebHome]]]. Примеры заданий приведены в разделе [[здесь>>neyross.НЕЙРОСС Автоматика.WebHome]].
195 {{/info}}
196
197 == Порядок работы ==
198
199 1. По факту получения события, удовлетворяющего фильтру событий, осуществляется запуск задания автоматизации.
200 1. Вычленяется источник события. Для этого источника определяется список «связанных камер». Если источника события нет, отправляется текст из шаблона сообщения с пустыми параметрами. Если для источника события нет «связанных камер», кадры/видео не отправляются.
201 1. Если в поле **Отправлять связанные кадры архива** установлено **Да**, для найденных камер производится формирование кадров архива за время возникновения события. Если архив не найден, кадры не отправляются.
202 1. (((
203 Если в поле **Отправлять фрагменты видеоархива** установлено **Да**, для найденных камер производится создаются задачи на экспорт видеоархива интервал:
204
205 {{code language="java"}}
206 [время события — N, время события]
207 {{/code}}
208
209 Где N  — размер частей видеоархива
210
211 Если архив не найден, кадры не отправляются.
212 )))
213 1. По итогу в бот отправляется текст сообщения по шаблону, а также найденные кадры архива и видеофрагменты.
214
215 {{info}}
216 **ПОДСКАЗКА**
217
218 Если на момент события срабатывания задания автоматизации есть архивная запись по нескольким потокам камеры, в телеграмм будут отправлены фрагменты видеоархива по каждому потоку.
219
220 По кнопке **Выполнить тест** в бот отправляется следующий текст:
221
222 {{code language="java"}}
223 test
224 {{/code}}
225 {{/info}}