О плагине

Плагин предназначен для отправки уведомлений через мессенджер MAX.

Настройка

MAX

Получить через https://business.max.ru/ токен для бота <BOT_TOKEN>

Параметры

Для отправки уведомлений пользователям создайте text параметр пользователя c ID <USER_PARAM_ID>.

Альтернативно, для отправки уведомлений в фиксированный для каждого процесса чат, создайте text параметр процесса c ID <PROCESS_PARAM_ID>.

Плагин

Добавить конфигурацию с активированным плагином:

max:botStart=1

max:token=<BOT_TOKEN>

max:userParamId=<USER_PARAM_ID>

# опционально
# отправка в чат из параметра процесса
#max:processParamId=<PROCESS_PARAM_ID>
# нестандартный URL MAX API
#max:baseUrl=https://platform-api.max.ru

Тип процесса

В конфигурации типа процесса настраивается автоматизация отправки уведомлений с помощью JEXL скрипта простого обработчика событий, вызывающего объект max класса org.bgerp.plugin.msg.max.ExpressionObject с функциями API плагина.

Примеры конфигурации

Уведомление исполнителей об изменении в процессе

onProcessEvent.{@inc:cnt}.events=statusChanged
onProcessEvent.{@cnt}.doExpression=<<END
    max.sendMessage(process, "Статус процесса #" + process.getId() + " изменён");
END

Отправка в группу

<GROUP_CHAT_ID> получить, открыв группу в браузере, URL будет вида https://web.max.ru/-<GROUP_CHAT_ID>;

MAX_GROUP_CHAT_ID=<GROUP_CHAT_ID>

onProcessEvent.{@inc:cnt}.events=statusChanged
onProcessEvent.{@cnt}.doExpression=<<END
    max.sendMessage("{@MAX_GROUP_CHAT_ID}", "Процесс #" + process.getId() + " — статус изменён");
END

Использование

Свой Chat ID каждый пользователь запрашивает у бота. Полученное значение указывается в параметре профиля пользователя.