Slack¶

Если вы хотите, чтобы ваши подписки на отчеты или оповещения были отправлены в каналы Slack (или пользователям в Slack), то администратор должен сначала интегрировать ваш GlarusBI с Slack.

Создание Slack App¶

Для того, чтобы GlarusBI мог отправлять сообщения на ваши каналы Slack, вам нужно создать Slack App и дать GlarusBI доступ к нему.

С любой страницы GlarusBI перейдите в Настройки администратора > Настройки > Slack.

Нажмите на Открыть Slack Apps. GlarusBI откроет новую вкладку браузера и перебросит вас на сайт Slack для создания Slack App.

На сайте Slack нажмите на Создать App.

Выбор рабочей области для разработки приложения¶

Выберите рабочую область, в которой вы хотите создать свое приложение.

Манифест приложения¶

При нажатии на Открыть Slack App, GlarusBI передаст манифест приложения, который Slack использует для установки вашего приложения.

Может появится следующее предупреждение:

Это приложение создано из манифеста третьей стороны. Всегда перепроверяйте правильность URLs и выданных разрешений.

Это предупреждение ожидаемо (в данном случае GlarusBI является третьей стороной). Вы можете нажать на Настроить, чтобы просмотреть манифест приложения, который GlarusBI передал в URL. Вот его YAML формат:

_metadata:
  major_version: 1
  minor_version: 1
display_information:
  name: GlarusBI
  description: Bringing the power of GlarusBI to your Slack #channels!
  background_color: "#509EE3"
features:
  bot_user:
    display_name: GlarusBI
oauth_config:
  scopes:
    bot:
      - users:read
      - channels:read
      - channels:join
      - files:write
      - chat:write
      - chat:write.customize
      - chat:write.public

Манифест просто заботится о некоторых настройках для вашего приложения и помогает ускорить все процессы.

Нажмите кнопку Далее. Затем нажмите Создать, чтобы настроить ваше приложение Slack.

Инсталляция приложения в вашу рабочую область¶

На странице приложения в Slack в разделе Настройки > Основная информация, в разделе Установите приложение, нажмите на Установите в рабочее пространство. На следующем экране, нажмите Разрешить, чтобы дать GlarusBI доступ к вашему рабочему пространству Slack.

OAuth токен для bot пользователя¶

На странице Slack для вашего приложения Slack в разделе Функции нажмите на OAuth и разрешения в боковой панели приложений Slack и затем скопируйте Bot User OAuth Token. Вернитесь на страницу настроек Slack в GlarusBI и вставьте этот токен в поле GlarusBI с тем же именем.

Создание выделенного канала GlarusBI в вашем Slack¶

В вашем рабочем пространстве Slack создайте общедоступный канал с любым именем, затем введите имя этого канала в поле Slack Channel Name в GlarusBI. Этот канал позволяет вашему GlarusBI отправлять сообщения в ваше Slack-рабочее пространство, не имея дела с лишними разрешениями. Убедитесь, что канал, который вы создаете, совпадает с каналом, который вы вводите в этом поле в GlarusBI (без префикса “#”).

Если вы переименовали канал в Slack - вам нужно обновить значение поля Slack Channel Name в GlarusBI, указав там новое имя канала.

Сохранение изменений в GlarusBI¶

Нажмите на кнопку Сохранить изменения. После этого GlarusBI автоматически проведет быстрое тестирование, чтобы проверить, что токен API и ваш отдельный канал Slack работают корректно. Если что-то пойдет не так, вы получите сообщение об ошибке.

Отправка оповещений и подписок в частные каналы Slack¶

Чтобы отправлять подписки и оповещения в частные каналы Slack, вам необходимо сначала добавить в частный канал приложение GlarusBI.

В Slack перейдите в частный канал и упомяните (тегните) приложение GlarusBI. Например, если вы назвали свое приложение Slack “GlarusBI”, вам просто нужно ввести @GlarusBI. Slack спросит вас, хотите ли вы пригласить свое приложение на свой канал, и вам нужно подтвердить это.

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