Slack¶

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

Создание Slack App¶

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

OAuth-токен для бота¶

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

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

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

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

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

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

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

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

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

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