設定 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 網站上,在設定 > 基本資訊分頁中,在安裝您的應用程式下方,按一下安裝到工作區。在下一個畫面中,按一下允許以授予 Metabase 存取您的 Slack 工作區的權限。

Bot 使用者 OAuth 權杖

在您的 Slack 應用程式的 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 版本的文件。