> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 警示

> 為你的通話指標設定門檻規則——一旦出現異常，立即傳送至電子郵件、Slack 或你的 Webhook。

警示規則會監看你組織的通話指標，並在跨越門檻時通知你——例如過去一天的成功率低於 80%、一小時內超過 500 通通話，或測試套件發生退化。請在 **設定 → 組織 → 警示**
(`/dashboard/organization?tab=alerts`) 下方管理。管理警示規則需要 **admin** 或 **owner** 角色。

## 建立規則

按一下 **建立規則**，然後填寫：

| 欄位                       | 選項                                       |
| ------------------------ | ---------------------------------------- |
| **指標**                   | 成功率 · 失敗率 · 平均分數 · 通話量 · 測試套件退化          |
| **條件**                   | 小於 · 至多 · 大於 · 至少                        |
| **門檻**                   | 要比較的數值                                   |
| **視窗（小時）**               | 計算指標時回溯的時間範圍——1 至 720 小時                 |
| **電子郵件收件者**              | 以逗號分隔，最多 10 個地址                          |
| **Slack 傳入 Webhook URL** | 選填——將警示訊息發佈至頻道                           |
| **冷卻時間（分鐘）**             | 兩次觸發之間的最短靜默時間（預設為 60）                    |
| **傳送至開發人員 Webhook**      | 同時將 `alert.triggered` 事件傳送至你的 Webhook 端點 |
| **啟用警示規則**               | 規則可以先儲存為停用，之後再開啟                         |

範例：*「過去 24 小時的成功率**小於** 80」*
會在最近 24 小時視窗內已評分通話的成功率降至 80% 以下時觸發。

<Note>
  **失敗率計入的範圍不只「未成功」通話。** 警示指標會將每一通未達成成功結果的通話——包括完全沒有對話的通話（立即掛斷、連線失敗）——視為失敗。控制台中的 **未成功** 圖塊只計算被評分為
  `unsuccessful` 的通話。因此，即使控制台圖塊顯示較低的數字，失敗率警示仍可能觸發；這是預期行為，不是差異。
</Note>

## 觸發方式

規則會依據你設定的回溯視窗進行評估。符合條件時，規則只會觸發 **一次**，接著在冷卻期間保持靜默，即使指標仍持續違反門檻也是如此——因此一個狀況不佳的小時只會產生一則通知，而不是每次評估都產生通知。每次觸發都會記錄指標值、門檻與時間。

## 傳送管道

單一規則可以同時透過三種管道通知：

* **電子郵件**——傳送訊息給每位列出的收件者，內容包含規則名稱、
  指標、數值、門檻與視窗。
* **Slack**——透過你的 Slack 傳入 Webhook URL 發佈相同訊息。
* **開發人員 Webhook**——將 `alert.triggered` 事件傳送至你組織的
  [Webhook 端點](/zh-Hant/webhooks/overview)，以便將警示串接至 PagerDuty、值班工具或你自己的系統。

任何一個管道傳送失敗，都不會阻礙其他管道。

## 管理規則

「警示」分頁會列出每個規則的啟用／停用狀態，以及最後一次觸發的時間。你可以直接切換規則的開啟與關閉狀態，按一下 **編輯** 來變更任何欄位，或刪除不再需要的規則。旁邊也會顯示最近的警示活動，讓你確認規則確實依照預期方式觸發。

## 後續步驟

<CardGroup cols={2}>
  <Card title="可觀測性" icon="chart-line" href="/zh-Hant/guides/observability">
    支援相同指標的控制台。
  </Card>

  <Card title="Webhook" icon="webhook" href="/zh-Hant/webhooks/overview">
    在你自己的系統中接收 alert.triggered（以及所有其他事件）。
  </Card>
</CardGroup>
