设置 Slack

如果您希望将仪表板订阅警报发送到 Slack 频道(或 Slack 上的个人),管理员必须首先将 Metabase 与 Slack 集成。

创建您的 Slack 应用

为了让 Metabase 发布到您的 Slack 频道,您需要创建一个 Slack 应用并使其可用于 Metabase。

在任何 Metabase 页面上,转到 管理设置 > 设置 > 通知渠道 > Slack

点击 打开 Slack 应用。Metabase 将打开一个新的浏览器标签页,并引导您前往 Slack 网站创建 Slack 应用。

在 Slack 网站上,点击 创建应用

选择一个工作区来开发您的应用

选择您要创建应用的工作区。

应用清单

当您点击 打开 Slack 应用时,Metabase 将传递应用清单,Slack 将使用它来设置您的应用。

您可能会收到一个警告,内容如下:

此应用是通过第三方清单创建的 请务必验证以下 URL 和权限。

此警告是预期行为(Metabase 是此处的第三方)。您可以点击 配置 查看 Metabase 在 URL 中发送的应用清单。以下是 YAML 格式的清单:

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

清单只负责应用程序的一些设置,有助于加快进度。

点击 下一步 按钮。然后点击 创建 设置您的 Slack 应用。

将您的应用安装到工作区

在 Slack 网站上您新创建的应用页面中,在 设置 > 基本信息 选项卡下,在 安装您的应用 部分,点击 安装到工作区。在下一个屏幕上,点击 允许 授予 Metabase 访问您的 Slack 工作区的权限。

Bot 用户 OAuth 令牌

在 Slack 应用的 Slack 网站页面上,在左侧的 功能 部分,点击 Slack 应用侧边栏中的 OAuth 和权限,然后复制 Bot 用户 OAuth 令牌。返回 Metabase 中的 Slack 设置页面,将此令牌粘贴到 Metabase 中同名字段。

在 Metabase 中保存您的更改

在 Metabase 中,点击 保存更改 按钮即可!Metabase 将自动运行快速测试以检查 API 令牌是否正常工作。如果出现问题,它会显示错误消息。

向私人 Slack 频道发送警报和订阅

为了向私人 Slack 频道发送订阅和警报,您必须首先将 Metabase 应用添加到该私人频道。

在 Slack 中,前往私人频道并提及 Metabase 应用。例如,如果您的 Slack 应用名为“Metabase”,您只需输入 @Metabase。Slack 会询问您是否要邀请您的应用加入您的频道,您应该选择是。

Metabase 未列出您的私人频道?

Metabase 可能需要一些时间才能看到应用已受邀加入的所有频道。新频道在邀请应用加入频道后最多可能需要 10 分钟才能出现在列表中。

为了让 Metabase 看到私人频道,该应用必须拥有 groups:read OAuth 范围。尽管此范围在通过 Metabase 设置应用时应已授予,但较旧的安装可能没有此范围。如果您认为可能是这种情况,请访问 Slack 中的应用设置

  • 在应用列表中点击 Metabase 应用。
  • 点击侧边栏中的 OAuth & 权限
  • 范围 下添加 groups:read 范围。
  • 然后需要通过点击 OAuth 令牌 下的 重新安装 按钮将应用重新安装到工作区。

延伸阅读

阅读其他Metabase 版本的文档。

© . All rights reserved.