【Teams 通知】舊版 Webhook 淘汰！Power Automate / Workflow 轉換教學 (完整版)

2025/11/08 更新2025/11/08 發佈閱讀 12 分鐘

🪄 前言：為什麼要改？

微軟在 2025 年底確定淘汰舊的 Microsoft Teams Incoming Webhook (O365 Connector)，並將通知機制整合進 Power Automate / Teams Workflow。

這代表以前那條

https://company.webhook.office.com/webhookb2/...

的 URL 將不再維護，你需要改成新的：

https://environment.api.powerplatform.com/powerautomate/automations/direct/workflows/...

幸好，轉換並不難。

目前通知機制的流程為: GCP Pub/Sub ⇒ Cloud Function(Python ) ⇒ Webhook(URL) ⇒ Teams

需要修改的部分為:

✔️ Cloud Function(Python ):調整腳本程式碼

✔️ Webhook(URL) : 改為從 Teams 中的 Power Automate / Workflow產生的URL

⚙️ 教學步驟：完整版 Payload 實作（含顏色、粗體與連結樣式）

這邊實作完整版的方式有兩種，因為完整版涵蓋的功能有（含顏色、粗體與連結樣式）等，因此會

Python 傳簡單資料、Flow 用 RichTextBlock 組樣式卡
Python 傳簡單資料+RichTextBlock 組樣式卡、Flow 不用特別設定

我目前示範的是第1種

Step 1. 在 Python 端修改程式碼

這裡的核心是把舊 webhook 換成 Workflow URL

Workflow URL 要先到Teams Workflow設定才能取得，詳見[Step 2. 建立 Teams Workflow]

並將原本 "text": "..." 的結構改為 "text": [ {...}, {...} ] 陣列格式。

import requests

# 🆕 新 Workflow Webhook URL
webhook_url = "https://environment.api.powerplatform.com/powerautomate/automations/direct/workflows/..."

headers = {'Content-Type': 'application/json'}

payload = {
		#原本的text格式為以下內容
		#"text": f"<b style='color:red;'>【{log_level}】</b> <b>[{project_id}]</b> - {service_name} <br><br> <b>錯誤訊息</b> : {error_msg}<br> <b>詳細資訊</b>:<a href='{url}' style='color:red;'>{url}</a>"
    
    #修改text為以下的資料結構
    "text": [
        {
            "log_level": log_level,
            "project_id": project_id,
            "service_name": service_name,
            "error_msg": error_msg,
            "url": url
        }
    ]
}

response = requests.post(webhook_url, headers=headers, json=payload)
print(response.status_code, response.text)

💡 為什麼用陣列？

因為 Workflow 可以使用「Apply to each」自動對每筆資料重複貼出一張卡片。

這對 Pub/Sub 一次推多筆事件特別實用。

Step 2. 建立 Teams Workflow

下圖是Workflow的工作流程示意圖

┌──────────────────────────────────────┐
│ When a Teams webhook request received│
│ (接收 Python 發送的 JSON)            │
└──────────────┬───────────────────────┘
               │
┌──────────────▼──────────────┐
│ Apply to each               │
│ Items = @triggerBody()?['text'] │
└──────────────┬──────────────┘
               │
┌──────────────▼──────────────┐
│ Post adaptive card in Teams │
│ (使用 Flow bot 發送)        │
└─────────────────────────────┘

1️⃣ 打開 Microsoft Teams → Workflows

2️⃣ 點選上方[建立]欄位後，點選[收到webhook要求時發布在頻道中(Post to a channel when a webhook request is received)]的範本

3️⃣填入該通知設定的流程名稱

4️⃣設定要通知的團隊(Teams)與頻道(Channel)，這是階層的關係(團隊內的某個頻道)

5️⃣儲存後複製 HTTP POST URL → 貼回 Python 的 webhook_url

Step 3. Workflow 動作設定

1️⃣回到Microsoft Teams → Workflows → 首頁，選取剛建立的工作流程並編輯

2️⃣執行以下步驟

[選取先前步驟的輸出] (標記1)中輸入：@triggerBody()?['text']
在 Adaptive Card 欄位中(標記2)貼上

{
  "type": "AdaptiveCard",
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.5",
  "body": [
    {
      "type": "RichTextBlock",
      "inlines": [
        {
          "type": "TextRun",
          "text": "【@{items('Send_each_adaptive_card')?['log_level']}】",
          "color": "Attention",
          "weight": "Bolder"
        },
        {
          "type": "TextRun",
          "text": " [@{items('Send_each_adaptive_card')?['project_id']}] - @{items('Send_each_adaptive_card')?['service_name']}",
          "weight": "Bolder"
        }
      ]
    },
    {
      "type": "TextBlock",
      "text": "",
      "spacing": "Small"
    },
    {
      "type": "RichTextBlock",
      "inlines": [
        {
          "type": "TextRun",
          "text": "錯誤訊息: ",
          "weight": "Bolder"
        },
        {
          "type": "TextRun",
          "text": "@{items('Send_each_adaptive_card')?['error_msg']}",
          "wrap": true
        }
      ]
    },
    {
      "type": "RichTextBlock",
      "inlines": [
        {
          "type": "TextRun",
          "text": "詳細資訊: ",
          "weight": "Bolder"
        },
        {
          "type": "TextRun",
          "text": "@{items('Send_each_adaptive_card')?['url']}",
          "color": "Attention",
          "selectAction": {
            "type": "Action.OpenUrl",
            "url": "@{items('Send_each_adaptive_card')?['url']}"
          }
        }
      ]
    }
  ]
}