Wiki source code of Тип действия: Telegram-уведомление
Version 6.2 by superadmin on 2026/06/15 21:57
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 | |||
| 36 | После перехода по ссылке запустите бота. Вы получите сообщение вида:\\ | ||
| 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 | |||
| 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 | |||
| |
4.1 | 121 | {{code language="java"}} |
| |
1.1 | 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 | |||
| |
3.2 | 163 | Если запись ведется по событиям, необходимо включить предтревогу и установить значение длительности предтревоги не меньшее, чем заданное в этом поле ~[[[neyross.Настройка Платформы НЕЙРОСС.Настройка функций видеонаблюдения.Настройка задач на запись.Запись по событиям 247 + комбинированный режим.WebHome]]]. |
| |
1.1 | 164 | {{/error}} |
| 165 | ))) | ||
| 166 | ))) | ||
| 167 | |||
| 168 | Нажмите на кнопку **Сохранить задание**. | ||
| 169 | |||
| 170 | {{info}} | ||
| |
5.1 | 171 | При необходимости и организационной возможности выполнения теста, нажмите **выполнить тест**(%%) в заголовке блока **Параметры действия**, при этом видеоматериалов не будет, так как нет источника тревоги. |
| |
1.1 | 172 | {{/info}} |
| 173 | |||
| 174 | \\ | ||
| 175 | |||
| 176 | [[image:attach:telegram_example.jpg||thumbnail="true" height="250"]] | ||
| 177 | |||
| 178 | //Пример Telegram-уведомления с кадром по тревоге видеоаналитики// | ||
| 179 | |||
| 180 | \\ | ||
| 181 | |||
| |
2.1 | 182 | [[image:attach:telegram_example_video.jpg||width="236"]] |
| 183 | |||
| 184 | //Пример Telegram-уведомления с кадрами и видеофрагментами по тревоге точки доступа по шаблону// | ||
| 185 | |||
| |
4.1 | 186 | {{code language="java"}} |
| |
2.1 | 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 | |||
| |
1.1 | 200 | {{info}} |
| |
3.2 | 201 | Дополнительная информация по настройке заданий автоматизации приведена в разделе ~[[[doc:ui.Параметры узла.Автоматизация.WebHome]]]. Примеры заданий приведены в разделе [[здесь>>neyross.НЕЙРОСС Автоматика.WebHome]]. |
| |
1.1 | 202 | {{/info}} |
| 203 | |||
| |
3.1 | 204 | {{excerpt atlassian-macro-output-type="INLINE"}} |
| |
1.1 | 205 | == {{id name="Типдействия:Telegram-уведомление-Порядокработы"/}}Порядок работы == |
| 206 | |||
| |
3.1 | 207 | 1. По факту получения события, удовлетворяющего фильтру событий, осуществляется запуск задания автоматизации. |
| |
1.1 | 208 | 1. Вычленяется источник события. Для этого источника определяется список «связанных камер». Если источника события нет, отправляется текст из шаблона сообщения с пустыми параметрами. Если для источника события нет «связанных камер», кадры/видео не отправляются. |
| 209 | 1. Если в поле **Отправлять связанные кадры архива** установлено **Да**, для найденных камер производится формирование кадров архива за время возникновения события. Если архив не найден, кадры не отправляются. | ||
| 210 | 1. ((( | ||
| 211 | Если в поле **Отправлять фрагменты видеоархива** установлено **Да**, для найденных камер производится создаются задачи на экспорт видеоархива интервал: | ||
| 212 | |||
| |
4.1 | 213 | {{code language="java"}} |
| |
1.1 | 214 | [время события — N, время события] |
| 215 | {{/code}} | ||
| 216 | |||
| 217 | Где N — размер частей видеоархива | ||
| 218 | |||
| 219 | Если архив не найден, кадры не отправляются. \\ | ||
| 220 | ))) | ||
| 221 | 1. По итогу в бот отправляется текст сообщения по шаблону, а также найденные кадры архива и видеофрагменты. | ||
| |
3.1 | 222 | {{/excerpt}} |
| |
1.1 | 223 | |
| |
3.1 | 224 | \\ |
| 225 | |||
| |
1.1 | 226 | {{info}} |
| 227 | **ПОДСКАЗКА** | ||
| 228 | |||
| 229 | Если на момент события срабатывания задания автоматизации есть архивная запись по нескольким потокам камеры, в телеграмм будут отправлены фрагменты видеоархива по каждому потоку. | ||
| 230 | |||
| 231 | По кнопке **Выполнить тест** в бот отправляется следующий текст: | ||
| 232 | |||
| |
4.1 | 233 | {{code language="java"}} |
| |
1.1 | 234 | test |
| 235 | {{/code}} | ||
| 236 | {{/info}} |