设置 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 版本的文档。