Skip to Content
Version 3.2 by admin on 2026/05/30 23:01
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}}
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}}
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}}
69 https://web.telegram.org/
70 {{/code}}
71
72 Выберите требуемую группу. (% style="letter-spacing: 0.0px;" %)Её ID будет в адресной строке, например:
73
74 {{code}}
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 (% class="content-wrapper" %)
119 (((
120 Введите текст сообщения, например:
121
122 {{code}}
123 Возникла тревога ${event.headline}
124 Время отправки ${event.sent}
125 Элемент-источник ${element.name}
126 {{/code}}
127
128 Полный перечень доступных переменных приведён в подразделе ~[[[doc:ui.Параметры узла.Автоматизация.Действия автоматизации.Тип действия\: отправка письма по email.WebHome]]].
129 )))
130 )))
131 |(((
132 Идентификатор чата/канала
133 )))|(((
134 Укажите идентификатор (ID), полученный на предыдущем этапе.
135 )))
136 |(((
137 Отправлять связанные кадры архива
138
139 Отправлять фрагменты видеоархива
140 )))|(((
141 (% class="content-wrapper" %)
142 (((
143 Если осуществляется видеонаблюдение, ведется запись видео места возникновения события, и на момент фиксации события есть видеоархив по одной или нескольким камерам, то текст сообщения может быть дополнен кадрами видеоархива за время события, по одному кадру с каждой камеры. Для включения функции установите **Да.**
144
145 {{info}}
146 При этом должно быть выполнено несколько условий:
147
148 1. Задание автоматизации должно быть настроено на действие по событию ~[[[doc:ui.Параметры узла.Автоматизация.Сигналы автоматизации.Тип сигнала\: по событию.WebHome]]].
149 1. У источника события должна быть настроена связь с медиаисточником(ми) ~[[[«Привязка» камер источникам тревог>>doc:ui.Параметры узла.Элементы.«Привязка» камер источникам тревог.WebHome]]].
150 1. У «связанных» медиаисточников есть задания на запись и есть видеоархив на время возникновения события.
151 {{/info}}
152 )))
153 )))
154 |(((
155 Размер частей видеоархива (в секундах)
156 )))|(((
157 (% class="content-wrapper" %)
158 (((
159 Укажите длину фрагмента видеоархива в случае, если в поле** Отправлять фрагменты видеоархива** задано **Да**.
160
161 Вам потребуется указать число секунд.
162
163 {{error}}
164 **ВНИМАНИЕ**
165
166 Если запись ведется по событиям, необходимо включить предтревогу и установить значение длительности предтревоги не меньшее, чем заданное в этом поле ~[[[neyross.Настройка Платформы НЕЙРОСС.Настройка функций видеонаблюдения.Настройка задач на запись.Запись по событиям 247 + комбинированный режим.WebHome]]].
167 {{/error}}
168 )))
169 )))
170
171 Нажмите на кнопку **Сохранить задание**.
172
173 {{info}}
174 При необходимости и организационной возможности выполнения теста, нажмите (% style="color: rgb(0,0,255);" %)**выполнить тест**(%%) в заголовке блока **Параметры действия**, при этом видеоматериалов не будет, так как нет источника тревоги.
175 {{/info}}
176
177 \\
178
179 [[image:attach:telegram_example.jpg||thumbnail="true" height="250"]]
180
181 //Пример Telegram-уведомления с кадром по тревоге видеоаналитики//
182
183 \\
184
185 [[image:attach:telegram_example_video.jpg||width="236"]]
186
187 //Пример Telegram-уведомления с кадрами и видеофрагментами по тревоге точки доступа по шаблону//
188
189 {{code}}
190 10.1.29.38
191 ${event.headline}
192 ${element.name} — источник события
193 ${pass.facility} — код предприятия
194 ${pass.card} — номер карты
195 Владелец
196 ${person.name} ${person.patronymic} ${person.surname}
197 ${person.organization}, ${person.division}, ${person.post}
198 ${(person.properties?filter(p -> p.key == "extra")?first.value)!''}
199 {{/code}}
200
201 \\
202
203 {{info}}
204 Дополнительная информация по настройке заданий автоматизации приведена в разделе ~[[[doc:ui.Параметры узла.Автоматизация.WebHome]]]. Примеры заданий приведены в разделе [[здесь>>neyross.НЕЙРОСС Автоматика.WebHome]].
205 {{/info}}
206
207 {{excerpt atlassian-macro-output-type="INLINE"}}
208 == {{id name="Типдействия:Telegram-уведомление-Порядокработы"/}}Порядок работы ==
209
210 1. По факту получения события, удовлетворяющего фильтру событий, осуществляется запуск задания автоматизации.
211 1. Вычленяется источник события. Для этого источника определяется список «связанных камер». Если источника события нет, отправляется текст из шаблона сообщения с пустыми параметрами. Если для источника события нет «связанных камер», кадры/видео не отправляются.
212 1. Если в поле **Отправлять связанные кадры архива** установлено **Да**, для найденных камер производится формирование кадров архива за время возникновения события. Если архив не найден, кадры не отправляются.
213 1. (((
214 Если в поле **Отправлять фрагменты видеоархива** установлено **Да**, для найденных камер производится создаются задачи на экспорт видеоархива интервал:
215
216 {{code}}
217 [время события — N, время события]
218 {{/code}}
219
220 Где N  — размер частей видеоархива
221
222 Если архив не найден, кадры не отправляются. \\
223 )))
224 1. По итогу в бот отправляется текст сообщения по шаблону, а также найденные кадры архива и видеофрагменты.
225 {{/excerpt}}
226
227 \\
228
229 {{info}}
230 **ПОДСКАЗКА**
231
232 Если на момент события срабатывания задания автоматизации есть архивная запись по нескольким потокам камеры, в телеграмм будут отправлены фрагменты видеоархива по каждому потоку.
233
234 По кнопке **Выполнить тест** в бот отправляется следующий текст:
235
236 {{code}}
237 test
238 {{/code}}
239 {{/info}}

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