Плагин Slack

О плагине

Плагин предназначен для интеграции BGCRM системой сообщений Slack и предоставляет функционал:

привязка процесса к каналу Slack;
создание канала по событию;
установка параметров канала: тема, топик и т.п.;
приглашение исполнителей процесса в канал;
архивирование канала по событию;
отправка сообщений из BGCRM в Slack;
загрузка выбранных сообщений из канала Slack в BGCRM.

Настройка в Slack

Создать домен Slack domain.slack.com, завести в нём пользователя, авторизоваться.
Создать приложение Slack с ClientID и ClientSecret
В секции OAuth Settings указать любой действительный URL.
Выполнить запрос:
https://slack.com/oauth/authorize?client_id=ClientID&scope=channels:history channels:read channels:write users:read groups:read groups:write groups:history chat:write:user chat:write:bot
Будет запрошено подтверждение на доступ под текущим пользователем, после согласия выполнен редирект на адрес URL/oauth?code=CODE
Выполнить запрос:
https://slack.com/api/oauth.access?code=CODE&client_id=ClientID&client_secret=ClientSecret
Результат должен быть вида: {"ok":true,"access_token":"TOKEN","scope":"..
Сохраните полученный TOKEN, он необходим для настройки BGCRM.

Настройка BGCRM

Создать текстовый параметр пользователя для сохранения логина Slack.

Настроить в конфигурации BGCRM тип сообщения, для Slack может быть создан только один тип сообщения:

messageType.<id>.title=<title>
messageType.<id>.class=ru.bgcrm.plugin.slack.dao.MessageTypeChannel
messageType.<id>.authToken=<token>
# необязательные параметры
messageType.<id>.accountParamId=<slackLoginParamId>
messageType.<id>.stringExpressionMessageExtract=<jexl>

Параметры, отличные от прочих типов сообщений:

<token> - TOKEN авторизации, сохранённый ранее;
<slackLoginParamId> - код текстового параметра пользователя, хранящего логин Slack, позволяющий сопоставить пользователя BGCRM с пользователем Slack;
<jexl> - JEXL выражение для извлечения сообщения Slack в текст входящего сообщения, исходное сообщение передаётся в параметре message, не null результат скрипта используется как текст входящего сообщения.

Пример настройки типа сообщения. Входящие сообщения выбираются с подстрокой bg.

messageType.5.title=Slack
messageType.5.class=ru.bgcrm.plugin.slack.dao.MessageTypeChannel
messageType.5.authToken=xoxp-112244252083-112987389558-112322797394-6aa31425be1725ee6ee0265a2dff1236
messageType.5.accountParamId=88
messageType.5.stringExpressionMessageExtract=<<END
   pos = message.toLowerCase().indexOf("bg");
   if (pos >= 0)
        return message.substring(0, pos) + message.substring(pos + 2);
   return null;
END

Синхронизация с форумом производится стандартной задачей обработки сообщений. Отправка сообщений производится немедленно, задача синхронизации лишь производит импорт необходимых сообщений.

Работа с сообщениями

После настройки в системе типа сообщения к любому процессу может быть привязан канал Slack. Для выполнения этого в ручном режиме тип объекта выбирается в секции Привязать иной объект, наименование оставляется пустым. Уже привязанный канал изображён на снимке экрана выше.

После того, как канал привязан к процессу в Сообщениях процесса возможна отправка постов в привязанный канал.

Входящие сообщение импортируются из канала при наличии скрипта stringExpressionMessageExtract в типе сообщения.

Настройка типа процесса

В конфигурации типа процесса может быть настроена автоматизация работы со Slack с помощью скрипта в doExpression простого обработчика событий. Ниже приведено несколько примеров возможных действий по различным событиям в процессе.

При переходе процесса в статус 10:

привязать если нет канал Slack к процессу;
пригласить исполнителей (они сопоставляются с пользователями Slack по логину в текстовом параметре пользователя BGCRM);
установить топик канала, полученный из названия статуса процесса и привязанного к процессу контрагента.

onProcessEvent.1.events=statusChanged:10
onProcessEvent.1.doExpression=<<END
     paramDao =  new("ru.bgcrm.dao.ParamValueDAO", conSet.getConnection());
     linkDao = new("ru.bgcrm.dao.process.ProcessLinkDAO", conSet.getConnection());    
     slack.linkChannel(process);
     slack.inviteExecutors(process);
     topic = "[" + process.getStatusTitle() + "]";
     link = u.getFirst(linkDao.getObjectLinksWithType(process.getId(), "customer"));
     if (link != null )
        topic += " " + link.getLinkedObjectTitle();
   slack.setTopic(process, topic);
END

При переводе процесса в статус 8 перемещение привязанного канала в архив.

onProcessEvent.2.events=statusChanged:8
onProcessEvent.2.doExpression=<<END
   slack.archive(process, true);
END

При изменении исполнителей процесса - приглашение новых исполнителей.

onProcessEvent.3.events=executorsChanged
onProcessEvent.3.doExpression=<<END
   slack.inviteExecutors(process);
END

Объект slack класса ru.bgcrm.plugin.slack.DefaultProcessorFunctions с функциями API предоставляется плагином.

Дерево страниц