# Zapier + Instatus

Source: https://instatus.com/help/ja/integrations/zapier

Zapier を使って Instatus を 8,000 以上のアプリと接続し、インシデント管理のワークフローを自動化できます。

1. [Zapier の Instatus](https://zapier.com/apps/instatus/integrations)へ移動します
2. **Connect Instatus to 8,000+ apps** をクリックして、Zapier のアカウントに Instatus を追加します
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 スプレッドシートにインシデントを記録する**: レポートや分析のために、すべてのインシデントの履歴を残します
- **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)

### トリガーが実行されない

- Zapier で Zap が有効になっているか確認してください
- トリガーの設定で、正しいプロジェクトを選んでいるか確認してください
- 選んだステータスページでインシデントが作成または更新されているか確認してください
- Zapier でトリガーを手動でテストして接続を確認してください (**Test Run** ボタンをクリックし、一覧からインシデントを選びます)

![Zapier のテスト実行](https://instatus.com/help/integrations/zapier-test-run.png)

### 認証のエラー

- API キーが正しいことを確認してください。[開発者設定](https://dashboard.instatus.com/developer)から再生成できます
- API キー全体を、余分な空白なしで貼り付けているか確認してください

### コンポーネントが表示されない

- ステータスページにコンポーネントが設定されていることを確認してください
- Zapier で **Refresh fields** をクリックして、ステータスページの最新のコンポーネントを読み込みます

![Zapier の Refresh fields](https://instatus.com/help/integrations/zapier-refresh.png)

さらにサポートが必要ですか？ [support@instatus.com](mailto:support@instatus.com) までご連絡ください。