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
清单只负责您应用的某些设置并帮助加快速度。
点击 下一步 按钮。然后点击 创建 来设置您的 Slack 应用。
将您的应用到工作区安装
在您新创建的 Slack 应用的 Slack 网站上,在 设置 > 基本信息 选项卡下,在 安装您的应用 下,点击 安装到工作区。在下一个屏幕上,点击 允许 以授予 Metabase 访问您的 Slack 工作区的权限。
Bot 用户 OAuth 令牌
在您的 Slack 应用页面上,在左侧的 功能 部分中,点击 Slack 应用侧边栏中的 OAuth 和权限,然后复制 Bot 用户 OAuth 令牌。返回您的 Metabase 中的 Slack 设置页面,并将此令牌粘贴到同名的 Metabase 字段中。
在 Slack 中创建一个用于存储图像文件的频道
在您的 Slack 工作区中,创建一个您想要的公开频道名称(我们认为“metabase”就很好)——然后输入 Metabase 中的 公共频道以存储图像文件 字段中的该频道名称。我们将在发送 仪表板订阅 之前将图表和表格上传到这里。这允许您的 Metabase 在不处理不必要的权限的情况下将帖子发布到您的 Slack 工作区。请确保您创建的频道与您在此字段中输入的 Metabase 中的频道相同(省略“#”前缀)。
如果您在 Slack 中更改频道的名称,则需要更新 Metabase 中的 公共频道以存储图像文件 为新名称。此频道不必与发送仪表板订阅的频道相同。它仅用于存储图像文件。
在 Metabase 中保存您的更改
在 Metabase 中,点击 保存更改 按钮,这样就完成了!Metabase 将自动运行快速测试,以检查 API 令牌和您的专用 Slack 频道是否正常工作。如果出现问题,它会给您一个错误消息。
向私有 Slack 频道发送警报和订阅
为了将订阅和警报发送到私有 Slack 频道,您必须首先将 Metabase 应用添加到私有频道。
在 Slack 中,转到私有频道并提及 Metabase 应用。例如,如果您的 Slack 应用名为“Metabase”,只需键入 @Metabase
。Slack 将询问您是否想要邀请您的应用到您的频道,您应该这样做。
一旦您的 Metabase 应用被添加到私有频道,您就需要在订阅或警报中键入私有频道的名称。确保正确拼写频道的名称,否则 Metabase 无法发送通知。
进一步阅读
阅读有关其他 Metabase 版本的文档。