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

2025/10/30 更新2025/10/30 發佈閱讀 8 分鐘

🪄 前言：為什麼要改？

微軟在 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 實作

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": [
    {"title": "🚀 GCP Pub/Sub 通知", "content": "測試訊息"},
    {"title": "🔥 第二則訊息", "content": "Hello Power Automate!"}
  ]
}
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": "TextBlock", "text": "@{items('Send_each_adaptive_card')?['title']}", "weight": "Bolder"},
    {"type": "TextBlock", "text": "@{items('Send_each_adaptive_card')?['content']}", "wrap": true}
  ]
}