Skip to Content
Version 6.1 by admin on 2026/06/07 18:49
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
82 На следующем шаге введите полученный ID в поле **Идентификатор чата/канала**. \\
83
84 == {{id name="Типдействия:Telegram-уведомление-Порядокдействий"/}}Порядок действий ==
85
86 Чтобы создать новое задание автоматизации:
87
88 В списке заданий нажмите на кнопку **Добавить новое задание** [[image:attach:ui.Параметры узла.Автоматизация.WebHome@btn_plus_new.png||thumbnail="true" height="22"]].
89
90 [[image:attach:ui.Параметры узла.Автоматизация.WebHome@action_newtask.png]]
91
92 Настройте параметры сигнала ~[[[doc:ui.Параметры узла.Автоматизация.Сигналы автоматизации.WebHome]]].
93
94 {{info}}
95 Рекомендуется настроить задание на запуск по событиям и настроить фильтр событий на «отлавливание» целевых событий.
96 {{/info}}
97
98 \\
99
100 \\
101
102 В блоке **Параметры действия** выберите из раскрывающегося списка **Telegram-уведомление**.
103
104 [[image:attach:action_telegram.png]]
105
106 \\
107
108 Настройте параметры задания согласно таблице ниже.
109
110 |=(((
111 Поле
112 )))|=(((
113 Комментарий
114 )))
115 |(((
116 Сообщение
117 )))|(((
118 (((
119 Введите текст сообщения, например:
120
121 {{code language="java"}}
122 Возникла тревога ${event.headline}
123 Время отправки ${event.sent}
124 Элемент-источник ${element.name}
125 {{/code}}
126
127 Полный перечень доступных переменных приведён в подразделе ~[[[doc:ui.Параметры узла.Автоматизация.Действия автоматизации.Тип действия\: отправка письма по email.WebHome]]].
128 )))
129 )))
130 |(((
131 Идентификатор чата/канала
132 )))|(((
133 Укажите идентификатор (ID), полученный на предыдущем этапе.
134 )))
135 |(((
136 Отправлять связанные кадры архива
137
138 Отправлять фрагменты видеоархива
139 )))|(((
140 (((
141 Если осуществляется видеонаблюдение, ведется запись видео места возникновения события, и на момент фиксации события есть видеоархив по одной или нескольким камерам, то текст сообщения может быть дополнен кадрами видеоархива за время события, по одному кадру с каждой камеры. Для включения функции установите **Да.**
142
143 {{info}}
144 При этом должно быть выполнено несколько условий:
145
146 1. Задание автоматизации должно быть настроено на действие по событию ~[[[doc:ui.Параметры узла.Автоматизация.Сигналы автоматизации.Тип сигнала\: по событию.WebHome]]].
147 1. У источника события должна быть настроена связь с медиаисточником(ми) ~[[[«Привязка» камер источникам тревог>>doc:ui.Параметры узла.Элементы.«Привязка» камер источникам тревог.WebHome]]].
148 1. У «связанных» медиаисточников есть задания на запись и есть видеоархив на время возникновения события.
149 {{/info}}
150 )))
151 )))
152 |(((
153 Размер частей видеоархива (в секундах)
154 )))|(((
155 (((
156 Укажите длину фрагмента видеоархива в случае, если в поле** Отправлять фрагменты видеоархива** задано **Да**.
157
158 Вам потребуется указать число секунд.
159
160 {{error}}
161 **ВНИМАНИЕ**
162
163 Если запись ведется по событиям, необходимо включить предтревогу и установить значение длительности предтревоги не меньшее, чем заданное в этом поле ~[[[neyross.Настройка Платформы НЕЙРОСС.Настройка функций видеонаблюдения.Настройка задач на запись.Запись по событиям 247 + комбинированный режим.WebHome]]].
164 {{/error}}
165 )))
166 )))
167
168 Нажмите на кнопку **Сохранить задание**.
169
170 {{info}}
171 При необходимости и организационной возможности выполнения теста, нажмите **выполнить тест**(%%) в заголовке блока **Параметры действия**, при этом видеоматериалов не будет, так как нет источника тревоги.
172 {{/info}}
173
174 \\
175
176 [[image:attach:telegram_example.jpg||thumbnail="true" height="250"]]
177
178 //Пример Telegram-уведомления с кадром по тревоге видеоаналитики//
179
180 \\
181
182 [[image:attach:telegram_example_video.jpg||width="236"]]
183
184 //Пример Telegram-уведомления с кадрами и видеофрагментами по тревоге точки доступа по шаблону//
185
186 {{code language="java"}}
187 10.1.29.38
188 ${event.headline}
189 ${element.name} — источник события
190 ${pass.facility} — код предприятия
191 ${pass.card} — номер карты
192 Владелец
193 ${person.name} ${person.patronymic} ${person.surname}
194 ${person.organization}, ${person.division}, ${person.post}
195 ${(person.properties?filter(p -> p.key == "extra")?first.value)!''}
196 {{/code}}
197
198 \\
199
200 {{info}}
201 Дополнительная информация по настройке заданий автоматизации приведена в разделе ~[[[doc:ui.Параметры узла.Автоматизация.WebHome]]]. Примеры заданий приведены в разделе [[здесь>>neyross.НЕЙРОСС Автоматика.WebHome]].
202 {{/info}}
203
204 {{excerpt atlassian-macro-output-type="INLINE"}}
205 == {{id name="Типдействия:Telegram-уведомление-Порядокработы"/}}Порядок работы ==
206
207 1. По факту получения события, удовлетворяющего фильтру событий, осуществляется запуск задания автоматизации.
208 1. Вычленяется источник события. Для этого источника определяется список «связанных камер». Если источника события нет, отправляется текст из шаблона сообщения с пустыми параметрами. Если для источника события нет «связанных камер», кадры/видео не отправляются.
209 1. Если в поле **Отправлять связанные кадры архива** установлено **Да**, для найденных камер производится формирование кадров архива за время возникновения события. Если архив не найден, кадры не отправляются.
210 1. (((
211 Если в поле **Отправлять фрагменты видеоархива** установлено **Да**, для найденных камер производится создаются задачи на экспорт видеоархива интервал:
212
213 {{code language="java"}}
214 [время события — N, время события]
215 {{/code}}
216
217 Где N  — размер частей видеоархива
218
219 Если архив не найден, кадры не отправляются. \\
220 )))
221 1. По итогу в бот отправляется текст сообщения по шаблону, а также найденные кадры архива и видеофрагменты.
222 {{/excerpt}}
223
224 \\
225
226 {{info}}
227 **ПОДСКАЗКА**
228
229 Если на момент события срабатывания задания автоматизации есть архивная запись по нескольким потокам камеры, в телеграмм будут отправлены фрагменты видеоархива по каждому потоку.
230
231 По кнопке **Выполнить тест** в бот отправляется следующий текст:
232
233 {{code language="java"}}
234 test
235 {{/code}}
236 {{/info}}

Интерфейс НЕЙРОСС