工作區通知

Notifications 是工作區的通知控制中心，用來決定哪些營運事件需要通知團隊，以及通知要送到哪裡。

從工作區側邊欄打開 Notifications。頁面分成兩個分頁：

工作區規則：設定各個支援事件的通知路由。
目的地：建立與管理可重複使用的通知接收端。

沒有更新工作區資源權限的人仍可查看此頁，但所有控制項都是唯讀。

了解兩層設定

先從 通知事件 選擇事件。每個事件都分成：

工作區規則：此事件共用的通知路由。
個別設定：依事件提供的覆寫設定。

目前事件使用這兩層的方式如下：

事件	工作區規則	個別設定
`Agent 真人接手`	套用所有沒有個別設定之 Agent 的預設目的地	自訂目的地或不發送通知的例外設定
`已送出表單`	套用所有沒有個別設定之表單的預設目的地	自訂目的地或不發送通知的例外設定

新增目的地

打開 目的地，選擇 新增目的地。可用類型包括：

Slack Incoming Webhook：可用於接手與表單送出事件。
Slack Workflow Webhook：可用於表單送出事件。
Email：可用於接手與表單送出事件。

為目的地取一個容易辨識的名稱，再輸入 webhook URL 或 Email 地址。儲存後，接收端會在介面中遮罩顯示。

Email 目的地在地址完成驗證前會顯示 需要處理。選擇 傳送驗證信，打開信中的驗證連結，再回到此頁。對可使用的 webhook 或已驗證 Email，可以先用 傳送測試通知 驗證，再加入正式規則。

Webhook URL 請保密

Slack webhook URL 是 secret。不要貼到公開文件、issue comment、截圖或 source code 裡。

設定事件路由

打開 工作區規則，選擇事件，再建立或編輯其工作區規則。

規則編輯器只會列出已存在，而且支援所選事件的目的地。選取一個或多個目的地後儲存規則。取消勾選不會刪除目的地；只有在儲存規則後，才會移除這條路由關聯。

已啟用的規則至少要選取一個目的地，而且已選目的地中至少一個目前可使用。已停用或未驗證的目的地會暫時略過，恢復可用後會自動繼續通知。

設定表單送出通知

在 已送出表單 事件中，沒有個別設定的表單會使用工作區規則。如果工作區規則不存在、已停用或沒有可用目的地，這些表單不會發送通知。

如果特定表單需要下列其中一種例外行為，請新增個別設定：

自訂目的地：此表單只使用已選取的既有目的地，並完全取代工作區規則。
不發送通知：送出此表單時不發送通知。

將既有設定改成 不發送通知 時，系統會移除原本選取的自訂目的地。之後若要恢復自訂通知，請編輯個別設定並重新選取目的地。

每張表單只能有一筆個別設定；已有設定的表單不會出現在表單選單中。如果所有自訂目的地都不可用，Codeer 不會改用工作區規則。

刪除個別設定後，該表單會重新使用工作區規則。如果刪除的是 不發送通知 設定，工作區規則可用時會恢復發送通知。

表單回覆 頁面會依目前篩選條件顯示唯讀摘要。選擇 所有表單 時，摘要會顯示工作區規則的狀態與目的地，以及有個別設定的表單數量；選擇特定表單時，則顯示該表單目前使用工作區預設、自訂目的地或不發送通知，以及真正會收到通知的目的地。選擇 管理工作區通知 會直接打開 Workspace Notifications 的表單事件；表單回覆頁面不提供目的地建立或管理功能。

依 Agent 設定接手通知

在 Agent 真人接手 事件中，沒有個別設定的 Agent 會自動使用工作區規則。只有需要下列例外行為時，才在 個別設定 新增 Agent：

自訂目的地：讓此 Agent 使用已選取的既有目的地。
不發送通知：此 Agent 成功自動交接時不送出通知。

將既有設定改成 不發送通知 時，系統會移除原本選取的自訂目的地。之後若要恢復自訂通知，請編輯個別設定並重新選取目的地。

選擇 新增 Agent 個別設定，並在同一個設定表單選擇 Agent、通知行為與目的地。Agent 選單只會列出尚未新增個別設定的 Agent。

刪除個別設定後，例外會被移除，該 Agent 會改用工作區規則。如果刪除的是 不發送通知 設定，工作區規則可用時會恢復發送通知。如果工作區規則不存在、已停用，或沒有可用目的地，沒有個別設定的 Agent 不會發送通知；規則恢復可用後會自動恢復傳送。

Agent Editor 只會顯示目前模式與生效目的地的唯讀摘要。選擇 管理工作區通知，即可在此頁直接定位到接手事件與對應 Agent。

變更或移除共用目的地

一個目的地可以由多條規則與 Agent 設定重複使用。使用情況 欄位會顯示使用此目的地的設定數量；選擇數量即可查看所有使用位置。

編輯接收端，或啟用、停用目的地，會影響所有列出的使用位置。
變更目的地類型時必須輸入新的接收端，而且可能讓它不再與既有規則相容。
若只要停止一條規則使用它，請在該規則取消勾選並儲存。
若要刪除，請先從所有規則與 Agent 設定移除，再到 目的地 刪除。

新增、編輯、啟用、停用、測試、驗證與刪除目的地，都只能在 目的地 分頁操作。