設定 Microsoft Teams 通知

這很重要

這項功能目前處於 公開預覽版。

AI/BI 儀表板支援將排程快照傳送至 Microsoft Teams 通道。 這讓 Teams 能直接在 Teams 工作區接收儀表板更新。 本頁說明如何建立 Microsoft Teams 應用程式，並設定 Teams 頻道作為通知目的地。 然後，儀表板編輯者可以將此通知目的地新增為排程儀表板的訂閱者。 關於如何將 Teams 頻道加入訂閱者的資訊，請參閱 訂閱 Slack 或 Microsoft Teams 頻道。

Teams 訂閱提供包括以下儀表板快照的功能：

  • 儀表板的PNG影像快照，可直接在頻道中顯示
  • 在 Azure Databricks 中開啟儀錶板的直接連結
  • 訊息討論串中的 PDF 快照附件

Teams 通知顯示儀表板快照的範例

需求

您必須具有下列權限：

  • 你必須是 Azure Databricks 工作空間管理員才能設定通知目的地。
  • 您必須擁有適當的權限才能在 Microsoft Entra ID 中註冊應用程式並授予管理員同意。 你也必須能在 Azure 入口網站 建立 Azure Bot 資源，並在 Microsoft Teams 中新增 Teams 應用程式並建立 Power Automate 工作流程。

在設定過程中，你會從 Microsoft 收集認證憑證，以設定 Azure Databricks 通知目的地。

設定通知目的地後，任何在儀表板上擁有編輯權限的使用者，都可以將 Teams 目的地新增為訂閱者，加入他們管理的排程。

步驟 1：建立並設定 Microsoft Teams 應用程式

註冊一個 Microsoft Entra ID 應用程式，建立與該應用程式相關的 Azure 機器人，並將該機器人的 Teams 應用程式加入你的頻道。

Note

此程序早期版本曾設定與 Microsoft Copilot Studio 代理相關聯的 Microsoft Entra ID 應用程式權限。 不再支援此功能。 截至 2026 年 3 月 18 日，Copilot Studio 會自動建立擁有管理 Entra 代理 ID 的客服人員，這些 ID 無法手動修改。 請依照以下步驟註冊您自己的 Microsoft Entra ID 應用程式。 背景請參見「用 Microsoft Entra Agent ID 重建 Copilot Studio 代理。

Register a Microsoft Entra ID app

  1. 前往 Microsoft Entra 系統管理中心。
  2. 點擊 Applications > 應用程式註冊 > 新註冊。
  3. 輸入應用程式名稱並點 選註冊。
  4. 在應用程式的 概覽 頁面，複製 應用程式（用戶端）ID。 你需要這個值來建立 Azure 機器人並設定 Azure Databricks 通知目的地。

在 Microsoft Entra ID 中設定應用程式權限

  1. 在 Microsoft Entra 系統管理中心 中，選擇應用程式註冊後，點選左側邊欄的 API 權限。
  2. 按兩下 [新增許可權]。
  3. 在 Microsoft API 中，點擊 Microsoft Graph > 應用程式權限。
  4. 新增下列權限：
    • Files.Read.All
    • Sites.ReadWrite.All
  5. 按一下新增權限。
  6. 點選 授予管理員同意 以授予您的組織權限。

建立認證祕密

  1. 在 Microsoft Entra 系統管理中心 中，選擇應用程式註冊後，點選「憑證與秘密」。
  2. 點擊 客戶端秘密 > 新客戶端秘密。
  3. 輸入描述並選擇有效期限。
  4. 按下 新增。
  5. 複製新建立秘密的 值 。 這個值只會顯示一次，你需要它來設定 Azure Databricks 的通知目的地。

取得租戶證

  1. 在 Microsoft Entra 管理中心，選擇應用程式註冊後，進入 「概覽」。
  2. 複製 目錄（租戶）ID。 你需要這個值來設定 Azure Databricks 通知目的地。

Create a Azure Bot for the app

建立一個使用 Microsoft Entra ID 應用程式的 Azure Bot 資源。

  1. 前往 Azure 入口網站，點選「建立資源」。
  2. 搜尋 Azure Bot，選擇 Azure 機器人卡片，然後點擊建立。
  3. 在 Microsoft 應用程式 ID 中，選擇「使用現有應用程式註冊」，並輸入你已註冊應用程式的應用程式（用戶端）ID。
  4. 填寫剩餘的必填欄位，然後點選檢視 + 建立>。
  5. 部署完成後，點擊 「前往資源」。

將機器人連接到 Microsoft Teams

把 Microsoft Teams 頻道加入機器人，然後為機器人建立 Teams 應用程式，並加入你的頻道。 完整流程請參見Azure Bot Service文件中的「連接機器人與Microsoft Teams」。

  1. 在 Azure 機器人資源中，打開設定>頻道並點選 Microsoft Teams。
  2. 同意服務條款。 在 訊息標籤 中，選擇你機器人的雲端環境，然後點 選套用。
  3. 為機器人建立 Teams 應用程式，打包後上傳到 Microsoft Teams。 相關說明請參見 「在 Teams 中發佈你的機器人」。
  4. 將 Teams 應用程式加入你想接收儀表板通知的頻道。

取得 Teams 頻道的網址

  1. 在 Microsoft Teams 中，導覽到目的地通道。
  2. 點擊頻道名稱旁的漢堡選單 ••• 。
  3. 點擊 複製連結。 務必複製頻道網址，而非 Teams 網址。 你需要這個網址來設定 Azure Databricks 通知目的地。

為該頻道建立一個進入的 webhook

Note

Microsoft 在 Microsoft Teams 中已退休 Office 365 連接器，包括經典的 Incoming Webhook 連接器。 改用Microsoft Power Automate的工作流程來建立 webhook。 關於背景，請參閱 Microsoft Teams 中 Office 365 連接器的退役。

  1. 請依照 Microsoft 的步驟，使用「發送 webhook 提醒」至頻道範本，選擇目標頻道，建立 Workflows for Microsoft Teams 的 webhook。
  2. 複製並儲存產生的 webhook URL。 你需要這個網址來設定 Azure Databricks 通知目的地。

步驟 2：在 Azure Databricks 中設定通知目的地

在你的 Azure Databricks 工作區建立一個通知目的地，指向你的 Microsoft Teams 頻道。

  1. 登入您的 Azure Databricks 工作區。

  2. 按一下工作區右上角的使用者名稱。

  3. 從下拉式清單中選取 設定 。

  4. 在 [工作區管理員] 區段中，按下 [通知] 索引標籤 。

  5. 在通知目的地區段中按一下管理。

  6. 按一下 新增目的地。

  7. 從目的地類型下拉選單選擇 Microsoft Teams 。

  8. 輸入下列資訊：

    • 名稱：此 Teams 頻道目的地的描述性名稱
    • Microsoft Teams Webhook URL：來自 Teams 進站 Webhook 的 URL。
    • App ID：來自你 Microsoft Entra ID 應用程式註冊時的應用程式（用戶端）ID
    • Auth Secret：來自 Microsoft Entra ID 的客戶端秘密值
    • 頻道網址：Microsoft Teams 頻道網址
    • 租戶 ID：Microsoft Entra ID 中的目錄（租戶）識別碼

  9. 點擊 建立。

建立新的團隊目的地。

使用者現在可以將此 Teams 通知目標加入訂閱儀表板排程。

關於如何將 Teams 頻道訂閱到儀表板排程的說明，請參閱 訂閱 Slack 或 Microsoft Teams 頻道。

故障排除

請使用以下工具來排解 Microsoft Teams 通知常見的錯誤。

缺少 PDF 附件

如果 Teams 通知沒有附帶 PDF 附件，請確認：

  • 應用程式（用戶端）ID 在通知目的地中已正確設定
  • 該認證秘密有效且尚未過期
  • 該應用程式已獲得 Microsoft Entra ID 所需的Files.Read.AllSites.ReadWrite.All權限
  • API 權限已獲得管理員同意

通知未出現

如果在 Teams 頻道中未收到通知：

  • 確認 Webhook URL 正確且符合目的地通道
  • 確認認證秘密使用的是 Microsoft Entra ID 的客戶端秘密值，而不是秘密 ID
  • 請確認該機器人的 Teams 應用程式已加入目的地頻道
  • 請確保頻道網址正確
  • 請確認租戶 ID 是否與您的 Microsoft 組織相符
  • 確認排程處於作用中且未暫停

後續步驟

  • 上次更新時間：