Skip to Content
Version 2.1 by pugachevskaya_elena on 2025/02/24 15:08
Hide last authors
pugachevskaya_elena 1.1 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 Если запись ведется по событиям, необходимо включить предтревогу и установить значение длительности предтревоги не меньшее, чем заданное в этом поле ~[[[confluencePage:page:neyross.Запись по событиям 24/7 + комбинированный режим]]].
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
pugachevskaya_elena 2.1 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
pugachevskaya_elena 1.1 203 {{info}}
204 Дополнительная информация по настройке заданий автоматизации приведена в разделе ~[[[doc:ui.Параметры узла.Автоматизация.WebHome]]]. Примеры заданий приведены в разделе [[здесь>>confluencePage:page:neyross.НЕЙРОСС Автоматика]].
205 {{/info}}
206
207 == {{id name="Типдействия:Telegram-уведомление-Порядокработы"/}}Порядок работы ==
208
209 1. По факту получения события, удовлетворяющего в параметрах запуска задания, фильтру, осуществляется запуск задания автоматизации.
210 1. Вычленяется источник события. Для этого источника определяется список «связанных камер». Если источника события нет, отправляется текст из шаблона сообщения с пустыми параметрами. Если для источника события нет «связанных камер», кадры/видео не отправляются.
211 1. Если в поле **Отправлять связанные кадры архива** установлено **Да**, для найденных камер производится формирование кадров архива за время возникновения события. Если архив не найден, кадры не отправляются.
212 1. (((
213 Если в поле **Отправлять фрагменты видеоархива** установлено **Да**, для найденных камер производится создаются задачи на экспорт видеоархива интервал:
214
215 {{code}}
216 [время события — N, время события]
217 {{/code}}
218
219 Где N  — размер частей видеоархива
220
221 Если архив не найден, кадры не отправляются. \\
222 )))
223 1. По итогу в бот отправляется текст сообщения по шаблону, а также найденные кадры архива и видеофрагменты.
224
225 {{info}}
226 **ПОДСКАЗКА**
227
228 Если на момент события срабатывания задания автоматизации есть архивная запись по нескольким потокам камеры, в телеграмм будут отправлены фрагменты видеоархива по каждому потоку.
229
230 По кнопке **Выполнить тест** в бот отправляется следующий текст:
231
232 {{code}}
233 test
234 {{/code}}
235 {{/info}}

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