文件
Microsoft Teams 警示與報表
在 Teams 頻道建立 Workflows webhook，將它加入 AutoPSEO，即可以依嚴重程度著色的 Adaptive Card 接收警示與排程報表。
AutoPSEO 透過 Workflows webhook 將訊息發送到 Microsoft Teams。Teams 會提供一個可發佈到單一頻道的 URL，您只要把這個 URL 作為 Teams 頻道加入 AutoPSEO，警示、排程報表、測試訊息和一次性的報表摘要就會以 Adaptive Card 的形式送達，標題會依嚴重程度著色，並附有一個連回報表的按鈕。您不需要 Slack 工作區，也不必在 Teams 中安裝任何 AutoPSEO 應用程式。
從 Teams 取得 webhook URL
Microsoft 的傳入 webhook 指南是透過 Workflows 應用程式來建立 URL:
- 在 Teams 中，前往要接收卡片的頻道，並選擇頻道旁的 更多選項 (...)。
- 選擇 Workflows，然後挑選一個 webhook 範本。Microsoft 目前稱之為 Send webhook alerts to a channel;AutoPSEO 設定頁面上的提示仍沿用舊名稱 Post to a channel when a webhook request is received。
- 確認範本自動填入的團隊與頻道無誤，然後按一下 儲存。
- 複製工作流程顯示的 webhook 連結。
舊版 Incoming Webhook 連接器的 URL(位於 webhook.office.com)仍可使用。不過 Microsoft 正在淘汰 Microsoft 365 連接器，並將封鎖新建連接器，因此現在新建的設定請一律使用 Workflows。
在 AutoPSEO 中新增頻道
- 在 Slack, Teams & Webhooks 的 Microsoft Teams 區段中，按一下 New Teams channel。表單開啟時，目的地已預設為 Microsoft Teams。
- 輸入一個您容易辨識的 名稱，並貼上 URL。對於 Teams 項目，AutoPSEO 接受 Workflows 與連接器位址(例如
logic.azure.com、powerautomate.com、azure-api.net和webhook.office.com等主機)，其他主機一律拒絕。 - 按一下 Add channel，然後在該列按一下 Send test。頻道中應該會出現一張以該項目名稱為標題的卡片。
- 建立排程報表或警示，並選擇這個頻道。
一條規則只會發送到一個頻道。若要讓同一則警示同時出現在 Slack 和 Teams，請分別建立兩條規則。
卡片的版面配置
每則訊息都會成為一張 Adaptive Card（1.4 版，滿版寬度），並包裝在 message 封套中，附帶 application/vnd.microsoft.card.adaptive 附件，與 Microsoft 官方範例的做法相同。
- 標題：以大號粗體顯示。警示中，嚴重與高等級使用卡片的 Attention 色，中等級使用 Warning 色，低等級使用預設色；報表和測試則使用 Accent 色。
- 摘要：與 Slack 訊息相同的一句話，並包含日期範圍。
- 事實欄位：最多 12 組附標籤的數值，例如點擊次數及其變化，或警示的目前值與基準值的對照。
- 表格：用於報表和報表摘要，最多十列，採用等寬字型。
- 頁尾：資源(property)、Search Console 資料約有一天延遲且只計入已穩定日期的提醒，以及寄件者。
- Open report：連到 AutoPSEO 中對應報表的按鈕。
卡片沒有送達的原因
Send test 會立即回報失敗；對於排程訊息，Delivery history 會保留 Teams 給出的回應。
| 您看到的情況 | 可能原因 | 解決方式 |
|---|---|---|
| 儲存時出現「That does not look like a Teams Workflows or Incoming Webhook URL」 | URL 不屬於 Workflows 或連接器的主機 | 從工作流程重新複製連結 |
| Send test 出現 HTTP 400 | 其實不是 Teams webhook：可能是 Slack URL、Zapier hook，或被改成預期其他內容格式的工作流程 | 用範本建立全新的工作流程，並加入它的 URL |
| 10 秒後逾時 | Teams 未能及時回應 | 稍後再試 |
| 不會跟隨重新導向 | 該 URL 會轉址到其他位置 | 改為加入最終的 URL |
| 同事離職後卡片就停止送達 | Microsoft 會將每個工作流程綁定到其擁有者，沒有擁有者的工作流程可能停止運作 | 為工作流程新增共同擁有者，或重新建立 |
失敗的排程報表不會在同一期間內重新發送：請排除原因後使用 Send now。
何時改用 webhook
Teams 與外送 webhook可以承載相同的規則，但服務的對象不同。Teams 頻道是給人看的：格式化的卡片，不需要自行開發。webhook 則是給軟體用的：以簽章 JSON 傳送原始事件，供 Zapier、Make、n8n 或您自己的服務使用。Teams 預期收到的是卡片，而不是 AutoPSEO 的事件 JSON，因此 Teams 的 URL 一律應放在 Microsoft Teams 之下。
關於 Teams 使用者能獲得哪些功能，請參閱 Microsoft Teams 頁面。