---
title: "警示"
description: "為你的通話指標設定門檻規則——一旦出現異常，立即傳送至電子郵件、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>
