Wiki source code of Тип действия: Telegram-уведомление
Last modified by admin on 2026/06/17 20:50
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
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 | |||
| |
7.1 | 36 | После перехода по ссылке запустите бота. Вы получите сообщение вида: |
| |
1.1 | 37 | |
| |
4.1 | 38 | {{code language="java"}} |
| |
1.1 | 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 | |||
| |
4.1 | 53 | {{code language="java"}} |
| |
1.1 | 54 | Id: 1055492440 |
| 55 | First: Ваше имя | ||
| 56 | Last: Ваша фамилия | ||
| 57 | {{/code}} | ||
| 58 | {{/info}} | ||
| 59 | |||
| 60 | **ID канала группы** | ||
| 61 | |||
| 62 | {{info}} | ||
| 63 | НЕЙРОСС-бот позволяет узнать только идентификатор канала пользователя. Для получения идентификатора канала группы воспользуйтесь инструкцией ниже. | ||
| 64 | {{/info}} | ||
| 65 | |||
| 66 | Откройте приложение телеграмм из браузера по адресу: | ||
| 67 | |||
| |
4.1 | 68 | {{code language="java"}} |
| |
1.1 | 69 | https://web.telegram.org/ |
| 70 | {{/code}} | ||
| 71 | |||
| |
5.1 | 72 | Выберите требуемую группу. Её ID будет в адресной строке, например: |
| |
1.1 | 73 | |
| |
4.1 | 74 | {{code language="java"}} |
| |
1.1 | 75 | https://web.telegram.org/a/#-1002477873357 |
| 76 | {{/code}} | ||
| 77 | |||
| |
7.1 | 78 | (% class="auto-cursor-target" style="letter-spacing:0.0px" %)Где 1002477873357 — идентификатор канала группы. |
| |
1.1 | 79 | |
| 80 | |||
| |
7.1 | 81 | На следующем шаге введите полученный ID в поле **Идентификатор чата/канала**. |
| |
1.1 | 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 | |||
| |
4.1 | 117 | {{code language="java"}} |
| |
1.1 | 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 | ((( | ||
| |
7.1 | 152 | Укажите длину фрагмента видеоархива в случае, если в поле** Отправлять фрагменты видеоархива** задано **Да**. |
| |
1.1 | 153 | |
| 154 | Вам потребуется указать число секунд. | ||
| 155 | |||
| 156 | {{error}} | ||
| 157 | **ВНИМАНИЕ** | ||
| 158 | |||
| |
3.2 | 159 | Если запись ведется по событиям, необходимо включить предтревогу и установить значение длительности предтревоги не меньшее, чем заданное в этом поле ~[[[neyross.Настройка Платформы НЕЙРОСС.Настройка функций видеонаблюдения.Настройка задач на запись.Запись по событиям 247 + комбинированный режим.WebHome]]]. |
| |
1.1 | 160 | {{/error}} |
| 161 | ))) | ||
| 162 | ))) | ||
| 163 | |||
| 164 | Нажмите на кнопку **Сохранить задание**. | ||
| 165 | |||
| 166 | {{info}} | ||
| |
7.1 | 167 | При необходимости и организационной возможности выполнения теста, нажмите **выполнить тест** в заголовке блока **Параметры действия**, при этом видеоматериалов не будет, так как нет источника тревоги. |
| |
1.1 | 168 | {{/info}} |
| 169 | |||
| 170 | |||
| 171 | [[image:attach:telegram_example.jpg||thumbnail="true" height="250"]] | ||
| 172 | |||
| 173 | //Пример Telegram-уведомления с кадром по тревоге видеоаналитики// | ||
| 174 | |||
| 175 | |||
| |
2.1 | 176 | [[image:attach:telegram_example_video.jpg||width="236"]] |
| 177 | |||
| 178 | //Пример Telegram-уведомления с кадрами и видеофрагментами по тревоге точки доступа по шаблону// | ||
| 179 | |||
| |
4.1 | 180 | {{code language="java"}} |
| |
2.1 | 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 | |||
| |
1.1 | 193 | {{info}} |
| |
3.2 | 194 | Дополнительная информация по настройке заданий автоматизации приведена в разделе ~[[[doc:ui.Параметры узла.Автоматизация.WebHome]]]. Примеры заданий приведены в разделе [[здесь>>neyross.НЕЙРОСС Автоматика.WebHome]]. |
| |
1.1 | 195 | {{/info}} |
| 196 | |||
| |
7.1 | 197 | == Порядок работы == |
| |
1.1 | 198 | |
| |
3.1 | 199 | 1. По факту получения события, удовлетворяющего фильтру событий, осуществляется запуск задания автоматизации. |
| |
1.1 | 200 | 1. Вычленяется источник события. Для этого источника определяется список «связанных камер». Если источника события нет, отправляется текст из шаблона сообщения с пустыми параметрами. Если для источника события нет «связанных камер», кадры/видео не отправляются. |
| 201 | 1. Если в поле **Отправлять связанные кадры архива** установлено **Да**, для найденных камер производится формирование кадров архива за время возникновения события. Если архив не найден, кадры не отправляются. | ||
| 202 | 1. ((( | ||
| 203 | Если в поле **Отправлять фрагменты видеоархива** установлено **Да**, для найденных камер производится создаются задачи на экспорт видеоархива интервал: | ||
| 204 | |||
| |
4.1 | 205 | {{code language="java"}} |
| |
1.1 | 206 | [время события — N, время события] |
| 207 | {{/code}} | ||
| 208 | |||
| 209 | Где N — размер частей видеоархива | ||
| 210 | |||
| |
7.1 | 211 | Если архив не найден, кадры не отправляются. |
| |
1.1 | 212 | ))) |
| 213 | 1. По итогу в бот отправляется текст сообщения по шаблону, а также найденные кадры архива и видеофрагменты. | ||
| 214 | |||
| 215 | {{info}} | ||
| 216 | **ПОДСКАЗКА** | ||
| 217 | |||
| 218 | Если на момент события срабатывания задания автоматизации есть архивная запись по нескольким потокам камеры, в телеграмм будут отправлены фрагменты видеоархива по каждому потоку. | ||
| 219 | |||
| 220 | По кнопке **Выполнить тест** в бот отправляется следующий текст: | ||
| 221 | |||
| |
4.1 | 222 | {{code language="java"}} |
| |
1.1 | 223 | test |
| 224 | {{/code}} | ||
| 225 | {{/info}} |