Wiki source code of Отправка видеоподтверждения в телеграмм
Last modified by admin on 2026/06/17 20:50
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
| |
1.1 | 1 | В Платформе НЕЙРОСС добавлена возможность по факту событий видеоаналитики, а также любых других событий Платформы НЕЙРОСС и сети НЕЙРОСС (в том числе, — событий доступа) отправлять уведомление заинтересованным видео в чат мессенджера Telegram. |
| 2 | |||
| 3 | == {{id name="Отправкавидеоподтверждениявтелеграмм-Общиесведения"/}}Общие сведения == | ||
| 4 | |||
| 5 | Платформа НЕЙРОСС предоставляет широкие возможности автоматизации, в том числе, — в части информирования ответственных лиц о событиях в системе безопасности. Наряду с отправкой уведомлений и готовых отчётов по электронной почте, если возможность получения уведомлений напрямую в телеграмм как группе людей, так и в конкретному пользователю. Шаблон текста уведомления формируется произвольно и дополняется сведениями о происшествии. | ||
| 6 | |||
| 7 | Вы можете использовать следующие переменные: | ||
| 8 | |||
| |
3.1 | 9 | {{code language="java"}} |
| |
1.1 | 10 | Для выбранного типа сигнала поддерживаются следующие данные для подстановки: |
| 11 | |||
| 12 | ${event.headline} — название события | ||
| 13 | ${event.data.EventTags} — метки события | ||
| 14 | ${element.name} — название элемента-источника события | ||
| 15 | ${pass.uuid} — идентификатор пропуска | ||
| 16 | ${pass.facility} — код предприятия | ||
| 17 | ${pass.card} — номер карты | ||
| 18 | ${pass.pincode} — ПИН | ||
| 19 | ${pass.duress_pincode} — ПИН прохода под принуждением | ||
| 20 | ${pass.type} — тип пропуска | ||
| 21 | ${pass.state} — состояние пропуска | ||
| 22 | ${person.uuid} — идентификатор владельца пропуска | ||
| 23 | ${person.photo} — идентификатор фотографии владельца пропуска | ||
| 24 | ${person.name} — имя владельца пропуска | ||
| 25 | ${person.surname} — фамилия владельца пропуска | ||
| 26 | ${person.patronymic} — отчество владельца пропуска | ||
| 27 | ${person.organization} — организация | ||
| 28 | ${person.division} — подразделение | ||
| 29 | ${person.post} — должность | ||
| 30 | ${(person.properties?filter(p -> p.key == "extra")?first.value)!''} — значение дополнительного свойства владельца пропуска | ||
| 31 | {{/code}} | ||
| 32 | |||
| 33 | |||
| 34 | Если у события, вызвавшего запуск задания автоматизации, есть элемент-источник, и для этого элемента заданы «связанные» медиаисточники», то при наличии задач на запись телеграмм-уведомление может быть дополнено кадрами архива или целыми видеофрагментами. | ||
| 35 | |||
| 36 | {{info}} | ||
| 37 | **ПОДСКАЗКА** | ||
| 38 | |||
| 39 | Задание автоматизации может быть запущено как непосредственно на видеорегистраторе, так и на сервере-диспетчере, получающем видеоданные от нескольких видеорегистраторов. При этом экспорт видео осуществляется с «внешнего» видеоархива. | ||
| 40 | |||
| |
5.1 | 41 | Если на момент события срабатывания задания автоматизации есть архивная запись по нескольким потокам камеры, в телеграмм будут отправлены фрагменты видеоархива по каждому потоку. Если для источника события задано несколько «связанных» камер, то к сообщению прикладываются кадры и/или видеофрагменты от каждой из них. Видео экспортируется в формате MKV и может быть просмотрено напрямую в Телеграмм. |
| |
1.1 | 42 | {{/info}} |
| 43 | |||
| |
2.1 | 44 | == {{id name="Отправкавидеоподтверждениявтелеграмм-Подготовкакнастройке"/}}Подготовка к настройке == |
| 45 | |||
| 46 | === {{id name="Отправкавидеоподтверждениявтелеграмм-Лицензирование"/}}Лицензирование === | ||
| 47 | |||
| 48 | Сервис автоматизации лицензируется. Вам потребуются лицензии, перечисленные в таблице ниже | ||
| 49 | |||
| 50 | |=((( | ||
| 51 | Название | ||
| 52 | )))|=((( | ||
| 53 | Комментарий | ||
| 54 | ))) | ||
| 55 | |((( | ||
| 56 | //НЕЙРОСС Автоматика// | ||
| 57 | )))|((( | ||
| 58 | НЕЙРОСС Автоматика: подсистема организации автоматического управления (включает функцию запуска управляющей команды) | ||
| 59 | ))) | ||
| 60 | |((( | ||
| 61 | //НЕЙРОСС Telegram// | ||
| 62 | )))|((( | ||
| 63 | Возможность отправки Telegram-уведомлений по событиям подсистемы автоматического управления. | ||
| 64 | ))) | ||
| 65 | |||
| 66 | === {{id name="Отправкавидеоподтверждениявтелеграмм-ДоступвИнтернет"/}}Доступ в Интернет === | ||
| 67 | |||
| 68 | Для отправки телеграмм-уведомлений узел Платформы НЕЙРОСС, на котором запущено задание автоматизации, должен иметь доступ в сеть интернет. | ||
| 69 | |||
| 70 | == {{id name="Отправкавидеоподтверждениявтелеграмм-Порядокнастройки"/}}Порядок настройки == | ||
| 71 | |||
| 72 | Создайте задание автоматизации. Задайте тип сигнала. В примере используется запуск задания по событию. Вы можете использовать один из предустановленных фильтров Платформы НЕЙРОСС, например, — фильтр СКУД / Все тревоги, который включает тревожные события системы контроля доступа, такие как взломы и удержания двери. | ||
| 73 | |||
| |
5.1 | 74 | Задайте** Тип действия** — **Telegram-уведомление**. Введите текст сообщения, укажите идентификатор чата в Telegramm. Вы можете использовать настройки из примера ниже. |
| |
2.1 | 75 | |
| 76 | [[image:attach:telegram_example_params.jpg||width="900"]] | ||
| 77 | |||
| |
5.1 | 78 | == Порядок работы == |
| |
2.1 | 79 | |
| |
5.1 | 80 | 1. По факту получения события, удовлетворяющего фильтру событий, осуществляется запуск задания автоматизации. |
| 81 | 1. Вычленяется источник события. Для этого источника определяется список «связанных камер». Если источника события нет, отправляется текст из шаблона сообщения с пустыми параметрами. Если для источника события нет «связанных камер», кадры/видео не отправляются. | ||
| 82 | 1. Если в поле **Отправлять связанные кадры архива** установлено **Да**, для найденных камер производится формирование кадров архива за время возникновения события. Если архив не найден, кадры не отправляются. | ||
| 83 | 1. ((( | ||
| 84 | Если в поле **Отправлять фрагменты видеоархива** установлено **Да**, для найденных камер производится создаются задачи на экспорт видеоархива интервал: | ||
| 85 | |||
| 86 | {{code language="java"}} | ||
| 87 | [время события — N, время события] | ||
| 88 | {{/code}} | ||
| 89 | |||
| 90 | Где N — размер частей видеоархива | ||
| 91 | |||
| 92 | Если архив не найден, кадры не отправляются. | ||
| 93 | ))) | ||
| 94 | 1. По итогу в бот отправляется текст сообщения по шаблону, а также найденные кадры архива и видеофрагменты. | ||
| 95 | |||
| |
2.1 | 96 | |=((( |
| 97 | Относится к | ||
| 98 | )))|((( | ||
| 99 | Платформа НЕЙРОСС | ||
| 100 | ))) | ||
| 101 | |=((( | ||
| 102 | Документация | ||
| 103 | )))|((( | ||
| 104 | [[doc:neyross.НЕЙРОСС Автоматика.WebHome]] | ||
| 105 | |||
| 106 | [[doc:ui.Параметры узла.Автоматизация.Действия автоматизации.Тип действия\: Telegram-уведомление.WebHome]] | ||
| 107 | ))) |