Внешние оповещения в мессенджер¶
Оператор видит аварию, пока он у экрана. Если реагировать должен дежурный инженер вне диспетчерской, оповещение нужно доставить туда, где человек его точно увидит, — во внешний мессенджер на телефоне. Платформа SCADA/BMS-платформа ГАУС умеет отправлять такие сообщения: текст формируется прикладной логикой и уходит указанным получателям.
Этот раздел описывает пользовательскую часть работы: что нужно подготовить на стороне мессенджера, как оповещение привязывается к аварии или другому условию, и какие у канала ограничения — их важно знать заранее, иначе сообщения просто не дойдут, хотя логика внешне работает.
Как это устроено¶
Отправку выполняет бот — служебная учётная запись в мессенджере, от имени которой платформа пишет людям. Схема одинакова для любого поддерживаемого мессенджера:
%%{init: {'flowchart': {'curve': 'basis', 'wrappingWidth': 200}}}%%
flowchart LR
A[Авария<br/>или условие] --> B[Задание<br/>триггер]
B --> C[Скрипт<br/>шаг «Отправка<br/>сообщения»]
C --> D[Бот<br/>в мессенджере]
D --> E[Получатель,<br/>подписанный на бота]
Ключевых частей три:
- Бот в мессенджере — создаётся средствами самого мессенджера и регистрируется на сервере ГАУС. Регистрацию бота на сервере выполняет администратор при развёртывании; пользователю проекта эта настройка не требуется.
- Шаг скрипта «Отправка сообщения» — место, где задаётся мессенджер, список получателей и текст. Отправка доступна именно из скрипта; отдельного поля «отправить в мессенджер» в карточке аварии нет.
- Подписка получателя — каждый, кому должны приходить сообщения, обязан сам обратиться к боту. Без этого шага сообщения не доставляются (см. Ограничения канала).
Что подготовить на стороне мессенджера¶
Бот создаётся штатными средствами мессенджера — платформа в этом не участвует. Порядок общий:
- Создайте бота средствами мессенджера и задайте ему имя, по которому получатели будут его находить.
- Получите выданный мессенджером идентификатор бота (токен отправителя). Он потребуется при настройке шага скрипта и при регистрации бота на сервере.
- Передайте идентификатор администратору, который разворачивает сервер ГАУС, — бот должен быть зарегистрирован на сервере, иначе платформа не сможет отправлять сообщения от его имени.
Проверка: бот отвечает в мессенджере при обращении к нему по имени.
Идентификатор бота — секрет
Токен отправителя даёт полный контроль над ботом. Не публикуйте его, не пересылайте по открытым каналам и не храните в общедоступных документах проекта.
Отправка сообщения из скрипта¶
Сообщение отправляет шаг «Отправка сообщения» — один из операторов скрипта-блок-схемы. Он ставится в ту ветку сценария, которая соответствует ситуации «людей надо оповестить».
Предусловие: бот создан и зарегистрирован на сервере; скрипт, в который добавляется шаг, уже существует в дереве проекта.
- Откройте скрипт в режиме редактирования.
- Вызовите контекстное меню в свободном месте редактора и выберите «Добавить» → «Отправка сообщения».
- В списке «Мессенджер» выберите мессенджер, через который уходит оповещение.
- В поле «Токен отправителя» введите идентификатор бота, полученный при его создании.
-
В поле «Получатели» введите имена пользователей мессенджера, которым адресовано сообщение — каждое имя с новой строки (после каждого имени нажмите
Enter). -
В поле «Сообщение» введите выражение, которое будет вычислено и отправлено. Постоянный текст заключайте в двойные кавычки — например,
"Авария: перегрев компрессора". - Соедините шаг с остальным сценарием и нажмите «Сохранить».
Проверка: после запуска скрипта подписанные получатели получают сообщение от бота в мессенджере.
В поле «Сообщение» работает язык выражений платформы, поэтому в текст можно подставлять текущие значения тегов — например, измеренную температуру или номер агрегата. Так дежурный получает не просто факт срабатывания, а данные, по которым сразу понятно, что произошло.
Как оповещение привязывается к аварии¶
Прямой связи «авария → сообщение» в карточке аварии нет: между ними стоит задание. Типовая цепочка выглядит так:
- Создайте аварию с нужным условием.
- Создайте скрипт с шагом «Отправка сообщения» и текстом оповещения.
- Создайте задание, у которого в списке «Тип запуска» выбрано «Отслеживание аварий», а в списке «Скрипт» — скрипт из шага 2.
- Включите задание.
Проверка: при срабатывании аварии подписанные получатели получают сообщение в мессенджере.
Тип запуска «Отслеживание аварий» реагирует на изменение состояния любой аварии проекта — конкретную аварию в задании не выбирают. Если оповещать нужно только по части аварий, разбор выполняет сам скрипт: перед шагом отправки поставьте шаг «Условие», который проверяет интересующие теги, и отправляйте сообщение только по ветке «да».
Тем же способом оповещение вешают не на аварию, а на любое другое условие — достаточно выбрать другой тип запуска задания: «Отслеживание условия» (выражение над тегами), «По времени» (регламентная рассылка), «Авторизация пользователя». Виды триггеров разобраны в разделе Расписания и задания.
Ограничения канала¶
Ограничения ниже заданы самим мессенджером и устройством канала — обойти их настройками проекта нельзя. Все три приводят к одному и тому же симптому: логика отрабатывает, а сообщения не приходят.
| Ограничение | Что это значит на практике |
|---|---|
| Бот не может написать первым | Мессенджеры запрещают ботам начинать переписку. Пока получатель сам не обратился к боту, ни одно сообщение ему не уйдёт. |
| Получатели должны быть заведены заранее | Список адресатов задаётся в поле «Получатели» шага скрипта. Человек, которого нет в списке, оповещения не получит, даже если подписан на бота. |
| Один экземпляр бота на сервер | Одновременно работает только один экземпляр бота. Если рассылка идёт с нескольких серверов, для каждого нужен свой отдельный бот; иначе сообщения будет отправлять только тот сервер, который запущен последним. |
Подписка получателя¶
Подписка — обязательный шаг, и выполняет его сам получатель, а не проектировщик:
- Найдите бота в мессенджере по имени, которое ему задали при создании.
- Откройте диалог с ботом.
- Введите команду
/start(или отправьте боту любое сообщение).
Проверка: бот отвечает подтверждением подписки.

Подписку можно приостановить командой /stop — тогда сообщения этому получателю приходить
перестанут, а сам он останется в списке «Получатели» скрипта.
Сервер должен быть запущен в момент подписки
Если при первом обращении к боту сервер ГАУС не работал, подписка не будет учтена
и сообщения не пойдут. В этом случае дождитесь запуска сервера и выполните команду /start
ещё раз.
Если сообщения не приходят¶
Проверяйте по порядку — сверху вниз, от самых частых причин:
- Получатель не подписан. Самая частая причина. Попросите его открыть диалог с ботом и
выполнить
/start. - Подписка сделана при остановленном сервере. Повторите
/startпосле запуска сервера ГАУС. - Получателя нет в списке. Проверьте поле «Получатели» шага «Отправка сообщения»: имя должно быть указано точно так, как в мессенджере, и на отдельной строке.
- Скрипт не запускается. Убедитесь, что задание включено и у него верный «Тип запуска», а скрипт отрабатывает — см. Расписания и задания.
- Один бот на нескольких серверах. Если рассылка настроена с двух и более серверов на одного бота, работать будет только последний запущенный. Заведите отдельного бота для каждого сервера.
- Бот не зарегистрирован на сервере. Регистрацию выполняет администратор при развёртывании — обратитесь к нему, если остальные пункты не помогли.
Смежные разделы¶
- Алармы и события — условия срабатывания и журнал оповещений.
- Скрипты и FBD — операторы скрипта и порядок их настройки.
- Расписания и задания — триггеры запуска логики, включая «Отслеживание аварий».
- Задачи (наряды) — если по аварии нужно не только оповестить, но и поручить работу.