# Zapier + Instatus

Source: https://instatus.com/help/zh/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 Issue 创建事件**：当 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) 联系我们。