Перейти к содержанию

Внешние оповещения в мессенджер

Оператор видит аварию, пока он у экрана. Если реагировать должен дежурный инженер вне диспетчерской, оповещение нужно доставить туда, где человек его точно увидит, — во внешний мессенджер на телефоне. Платформа SCADA/BMS-платформа ГАУС умеет отправлять такие сообщения: текст формируется прикладной логикой и уходит указанным получателям.

Этот раздел описывает пользовательскую часть работы: что нужно подготовить на стороне мессенджера, как оповещение привязывается к аварии или другому условию, и какие у канала ограничения — их важно знать заранее, иначе сообщения просто не дойдут, хотя логика внешне работает.

Как это устроено

Отправку выполняет бот — служебная учётная запись в мессенджере, от имени которой платформа пишет людям. Схема одинакова для любого поддерживаемого мессенджера:

%%{init: {'flowchart': {'curve': 'basis', 'wrappingWidth': 200}}}%%
flowchart LR
    A[Авария<br/>или условие] --> B[Задание<br/>триггер]
    B --> C[Скрипт<br/>шаг «Отправка<br/>сообщения»]
    C --> D[Бот<br/>в мессенджере]
    D --> E[Получатель,<br/>подписанный на бота]

Ключевых частей три:

  • Бот в мессенджере — создаётся средствами самого мессенджера и регистрируется на сервере ГАУС. Регистрацию бота на сервере выполняет администратор при развёртывании; пользователю проекта эта настройка не требуется.
  • Шаг скрипта «Отправка сообщения» — место, где задаётся мессенджер, список получателей и текст. Отправка доступна именно из скрипта; отдельного поля «отправить в мессенджер» в карточке аварии нет.
  • Подписка получателя — каждый, кому должны приходить сообщения, обязан сам обратиться к боту. Без этого шага сообщения не доставляются (см. Ограничения канала).

Что подготовить на стороне мессенджера

Бот создаётся штатными средствами мессенджера — платформа в этом не участвует. Порядок общий:

  1. Создайте бота средствами мессенджера и задайте ему имя, по которому получатели будут его находить.
  2. Получите выданный мессенджером идентификатор бота (токен отправителя). Он потребуется при настройке шага скрипта и при регистрации бота на сервере.
  3. Передайте идентификатор администратору, который разворачивает сервер ГАУС, — бот должен быть зарегистрирован на сервере, иначе платформа не сможет отправлять сообщения от его имени.

Проверка: бот отвечает в мессенджере при обращении к нему по имени.

Идентификатор бота — секрет

Токен отправителя даёт полный контроль над ботом. Не публикуйте его, не пересылайте по открытым каналам и не храните в общедоступных документах проекта.

Отправка сообщения из скрипта

Сообщение отправляет шаг «Отправка сообщения» — один из операторов скрипта-блок-схемы. Он ставится в ту ветку сценария, которая соответствует ситуации «людей надо оповестить».

Предусловие: бот создан и зарегистрирован на сервере; скрипт, в который добавляется шаг, уже существует в дереве проекта.

  1. Откройте скрипт в режиме редактирования.
  2. Вызовите контекстное меню в свободном месте редактора и выберите «Добавить» → «Отправка сообщения».
  3. В списке «Мессенджер» выберите мессенджер, через который уходит оповещение.
  4. В поле «Токен отправителя» введите идентификатор бота, полученный при его создании.
  5. В поле «Получатели» введите имена пользователей мессенджера, которым адресовано сообщение — каждое имя с новой строки (после каждого имени нажмите Enter).

  6. В поле «Сообщение» введите выражение, которое будет вычислено и отправлено. Постоянный текст заключайте в двойные кавычки — например, "Авария: перегрев компрессора".

  7. Соедините шаг с остальным сценарием и нажмите «Сохранить».

Проверка: после запуска скрипта подписанные получатели получают сообщение от бота в мессенджере.

В поле «Сообщение» работает язык выражений платформы, поэтому в текст можно подставлять текущие значения тегов — например, измеренную температуру или номер агрегата. Так дежурный получает не просто факт срабатывания, а данные, по которым сразу понятно, что произошло.

Как оповещение привязывается к аварии

Прямой связи «авария → сообщение» в карточке аварии нет: между ними стоит задание. Типовая цепочка выглядит так:

  1. Создайте аварию с нужным условием.
  2. Создайте скрипт с шагом «Отправка сообщения» и текстом оповещения.
  3. Создайте задание, у которого в списке «Тип запуска» выбрано «Отслеживание аварий», а в списке «Скрипт» — скрипт из шага 2.
  4. Включите задание.

Проверка: при срабатывании аварии подписанные получатели получают сообщение в мессенджере.

Тип запуска «Отслеживание аварий» реагирует на изменение состояния любой аварии проекта — конкретную аварию в задании не выбирают. Если оповещать нужно только по части аварий, разбор выполняет сам скрипт: перед шагом отправки поставьте шаг «Условие», который проверяет интересующие теги, и отправляйте сообщение только по ветке «да».

Тем же способом оповещение вешают не на аварию, а на любое другое условие — достаточно выбрать другой тип запуска задания: «Отслеживание условия» (выражение над тегами), «По времени» (регламентная рассылка), «Авторизация пользователя». Виды триггеров разобраны в разделе Расписания и задания.

Ограничения канала

Ограничения ниже заданы самим мессенджером и устройством канала — обойти их настройками проекта нельзя. Все три приводят к одному и тому же симптому: логика отрабатывает, а сообщения не приходят.

Ограничение Что это значит на практике
Бот не может написать первым Мессенджеры запрещают ботам начинать переписку. Пока получатель сам не обратился к боту, ни одно сообщение ему не уйдёт.
Получатели должны быть заведены заранее Список адресатов задаётся в поле «Получатели» шага скрипта. Человек, которого нет в списке, оповещения не получит, даже если подписан на бота.
Один экземпляр бота на сервер Одновременно работает только один экземпляр бота. Если рассылка идёт с нескольких серверов, для каждого нужен свой отдельный бот; иначе сообщения будет отправлять только тот сервер, который запущен последним.

Подписка получателя

Подписка — обязательный шаг, и выполняет его сам получатель, а не проектировщик:

  1. Найдите бота в мессенджере по имени, которое ему задали при создании.
  2. Откройте диалог с ботом.
  3. Введите команду /start (или отправьте боту любое сообщение).

Проверка: бот отвечает подтверждением подписки.

Диалог с ботом в мессенджере: после команды запуска бот отвечает подтверждением подписки и указывает команду приостановки

Подписку можно приостановить командой /stop — тогда сообщения этому получателю приходить перестанут, а сам он останется в списке «Получатели» скрипта.

Сервер должен быть запущен в момент подписки

Если при первом обращении к боту сервер ГАУС не работал, подписка не будет учтена и сообщения не пойдут. В этом случае дождитесь запуска сервера и выполните команду /start ещё раз.

Если сообщения не приходят

Проверяйте по порядку — сверху вниз, от самых частых причин:

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

Смежные разделы