# Zapier + Instatus

Source: https://instatus.com/help/zh-tw/integrations/zapier

透過 Zapier 把 Instatus 與 8,000 多個應用程式串接起來，自動化你的事件管理流程。

1. 前往 [Zapier 上的 Instatus](https://zapier.com/apps/instatus/integrations)
2. 點擊 **Connect Instatus to 8,000+ apps**，把 Instatus 加到你的 Zapier 帳號
3. 系統要求驗證時，請到 [Instatus 開發者設定](https://dashboard.instatus.com/developer)取得 API 金鑰，並貼到 Zapier 中

![Zapier 的 Instatus 整合](https://instatus.com/help/integrations/zapier-1.png)

## 觸發條件

### 新事件或事件更新

當有新事件被建立，或既有事件被更新時觸發。你可以用它來通知團隊、把事件記錄到試算表、在其他工具中建立工單等等。

**設定**

- **Project**：選擇要監看事件的 Instatus 狀態頁

**觸發資料**

這個觸發條件會提供下列資料，可在後續的 Zap 步驟中使用：

- `id` — 事件的唯一 ID
- `type` — `CREATE`（新事件）或 `UPDATE`（事件更新）
- `name` — 事件的名稱／標題
- `status` — 事件目前的狀態（`INVESTIGATING`、`IDENTIFIED`、`MONITORING`、`RESOLVED`）
- `started` — 事件開始的時間
- `resolved` — 事件解決的時間（若適用）
- `duration` — 事件持續時間，以秒為單位（若適用）
- `impact` — 影響程度（`OPERATIONAL`、`UNDERMAINTENANCE`、`DEGRADEDPERFORMANCE`、`PARTIALOUTAGE`、`MAJOROUTAGE`）
- `components` — 受影響的元件清單（每筆包含 `id`、`name`、`status`）
- `updates` — 事件更新清單（每筆包含 `id`、`status`、`started`、`message`）

## 動作

要設定 Instatus 動作，請先選擇你要操作的 Instatus 專案（狀態頁）。如果下拉選單中找不到你的專案，可以手動輸入頁面 ID — 做法請見[疑難排解](#在清單中找不到你的專案)一節。

選好專案後，你會看到更多用來設定這個動作的欄位。

![Zapier 動作設定](https://instatus.com/help/integrations/zapier-config.png)

### 建立事件

由其他應用程式的觸發條件在 Instatus 中建立新事件。你可以用它從監控工具、工單系統或 Zapier 上的任何應用程式自動建立狀態頁事件。

**設定**

- **Project**（必填）— 選擇要在哪個 Instatus 狀態頁上建立事件
- **Status**（必填）— 事件狀態：`INVESTIGATING`、`IDENTIFIED`、`MONITORING`、`RESOLVED`
- **Title**（必填）— 事件的標題／名稱
- **Description** — 描述事件的訊息
- **Affected Components** — 選擇受影響的元件
- **Components Status** — 受影響元件的狀態（例如 `OPERATIONAL`、`DEGRADEDPERFORMANCE`、`PARTIALOUTAGE`、`MAJOROUTAGE`）
- **Started On** — 事件開始的時間（預設為現在）
- **Publish incident to status page** — 是否要讓事件顯示在你的公開狀態頁上
- **Notify subscribers about the incident** — 是否要通知你的狀態頁訂閱者

## 使用情境範例

- **把事件記錄到 Google Sheets**：保留所有事件的歷史紀錄，方便報告與分析
- **建立 Notion 資料庫項目**：自動把事件加到團隊的 Notion 工作區中追蹤
- **從 GitHub Issues 建立事件**：當 GitHub 上回報重大錯誤時觸發 Instatus 事件
- **與 Airtable 同步**：在 Airtable 中建立自訂的事件儀表板與報表

都設定好了！開始打造你的 Zap 吧。

## 疑難排解

### 在清單中找不到你的專案

如果你的狀態頁沒有出現在專案下拉選單中，可以手動找出頁面 ID：

1. 在 [Instatus 儀表板](https://dashboard.instatus.com)中前往你的狀態頁
2. 在左上角的專案上按右鍵開啟選單
3. 點擊 **Copy Project ID**

![複製頁面 ID](https://instatus.com/help/copy-id.png)

4. 在 Zapier 的專案下拉選單中選擇 **Custom**，並貼上你的頁面 ID

![Zapier 自訂專案](https://instatus.com/help/integrations/zapier-custom-id.png)

### 觸發條件沒有作用

- 確認你的 Zap 在 Zapier 中已開啟
- 確認觸發條件設定中選的是正確的專案
- 確認所選的狀態頁上確實有事件被建立或更新
- 在 Zapier 中手動測試觸發條件以確認連線（點擊 **Test Run** 按鈕，再從清單中選一個事件）

![Zapier 測試執行](https://instatus.com/help/integrations/zapier-test-run.png)

### 驗證錯誤

- 確認 API 金鑰正確。你可以在[開發者設定](https://dashboard.instatus.com/developer)重新產生金鑰
- 確認貼上的是完整的 API 金鑰，且沒有多餘的空白

### 元件沒有出現

- 確認你的狀態頁上已設定元件
- 在 Zapier 中點擊 **Refresh fields**，重新載入狀態頁上最新的元件

![Zapier 重新整理欄位](https://instatus.com/help/integrations/zapier-refresh.png)

還需要協助嗎？請透過 [support@instatus.com](mailto:support@instatus.com) 與我們聯絡。