# Zapier + Instatus

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

Verbinden Sie Instatus über Zapier mit mehr als 8.000 Apps, um Ihre Incident-Management-Workflows zu automatisieren.

1. Gehen Sie zu [Instatus bei Zapier](https://zapier.com/apps/instatus/integrations)
2. Klicken Sie auf **Connect Instatus to 8,000+ apps**, um Instatus zu Ihrem Zapier-Konto hinzuzufügen
3. Wenn Sie zur Authentifizierung aufgefordert werden, holen Sie Ihren API-Schlüssel aus den [Instatus-Entwicklereinstellungen](https://dashboard.instatus.com/developer) und fügen Sie ihn in Zapier ein

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

## Trigger

### Neuer Vorfall oder Vorfalls-Update

Wird ausgelöst, wenn ein neuer Vorfall erstellt oder ein bestehender Vorfall aktualisiert wird. Damit benachrichtigen Sie Ihr Team, protokollieren Vorfälle in Tabellen, erstellen Tickets in anderen Tools und mehr.

**Konfiguration**

- **Project**: Wählen Sie, welche Instatus-Statusseite auf Vorfälle überwacht wird

**Trigger-Daten**

Der Trigger liefert die folgenden Daten, die Sie in nachfolgenden Zap-Schritten verwenden können:

- `id` – Eindeutige Vorfalls-ID
- `type` – Entweder `CREATE` (neuer Vorfall) oder `UPDATE` (Vorfalls-Update)
- `name` – Name/Titel des Vorfalls
- `status` – Aktueller Status des Vorfalls (`INVESTIGATING`, `IDENTIFIED`, `MONITORING`, `RESOLVED`)
- `started` – Beginn des Vorfalls
- `resolved` – Zeitpunkt der Lösung des Vorfalls (sofern zutreffend)
- `duration` – Dauer des Vorfalls in Sekunden (sofern zutreffend)
- `impact` – Auswirkungsgrad (`OPERATIONAL`, `UNDERMAINTENANCE`, `DEGRADEDPERFORMANCE`, `PARTIALOUTAGE`, `MAJOROUTAGE`)
- `components` – Liste der betroffenen Komponenten (jeweils mit `id`, `name`, `status`)
- `updates` – Liste der Vorfalls-Updates (jeweils mit `id`, `status`, `started`, `message`)

## Aktionen

Wählen Sie zum Einrichten einer Instatus-Aktion zunächst das Instatus-Projekt (die Statusseite) aus, mit dem Sie arbeiten möchten. Erscheint Ihr Projekt nicht im Dropdown, können Sie Ihre Seiten-ID manuell eingeben – eine Anleitung finden Sie im Abschnitt [Fehlerbehebung](#ihr-projekt-ist-nicht-in-der-liste).

Sobald Sie ein Projekt ausgewählt haben, erscheinen weitere Felder zur Konfiguration der Aktion.

![Konfiguration der Zapier-Aktion](https://instatus.com/help/integrations/zapier-config.png)

### Vorfall erstellen

Erstellen Sie einen neuen Vorfall in Instatus aus Triggern anderer Apps. So legen Sie Vorfälle auf Ihrer Statusseite automatisch aus Monitoring-Tools, Ticketsystemen oder jeder anderen App in Zapier an.

**Konfiguration**

- **Project** (erforderlich) – Wählen Sie, auf welcher Instatus-Statusseite der Vorfall erstellt wird
- **Status** (erforderlich) – Status des Vorfalls: `INVESTIGATING`, `IDENTIFIED`, `MONITORING`, `RESOLVED`
- **Title** (erforderlich) – Titel/Name des Vorfalls
- **Description** – Nachricht, die den Vorfall beschreibt
- **Affected Components** – Wählen Sie, welche Komponenten betroffen sind
- **Components Status** – Status der betroffenen Komponenten (z. B. `OPERATIONAL`, `DEGRADEDPERFORMANCE`, `PARTIALOUTAGE`, `MAJOROUTAGE`)
- **Started On** – Beginn des Vorfalls (Standard: jetzt)
- **Publish incident to status page** – Ob der Vorfall auf Ihrer öffentlichen Statusseite sichtbar wird
- **Notify subscribers about the incident** – Ob Benachrichtigungen an die Abonnenten Ihrer Statusseite gesendet werden

## Beispiel-Anwendungsfälle

- **Vorfälle in Google Sheets protokollieren**: Führen Sie eine Historie aller Vorfälle für Berichte und Auswertungen
- **Notion-Datenbankeinträge erstellen**: Fügen Sie Vorfälle automatisch zur Nachverfolgung in den Notion-Workspace Ihres Teams ein
- **Vorfälle aus GitHub-Issues erstellen**: Lösen Sie einen Instatus-Vorfall aus, wenn auf GitHub ein kritischer Fehler gemeldet wird
- **Mit Airtable synchronisieren**: Bauen Sie eigene Vorfalls-Dashboards und Berichte in Airtable

Alles bereit! Bauen Sie jetzt Ihre Zaps.

## Fehlerbehebung

### Ihr Projekt ist nicht in der Liste

Erscheint Ihre Statusseite nicht im Projekt-Dropdown, finden Sie Ihre Seiten-ID manuell:

1. Öffnen Sie Ihre Statusseite im [Instatus-Dashboard](https://dashboard.instatus.com)
2. Klicken Sie mit der rechten Maustaste oben links auf Ihr Projekt, um das Menü zu öffnen
3. Klicken Sie auf **Projekt-ID kopieren**

![Seiten-ID kopieren](https://instatus.com/help/copy-id.png)

4. Wählen Sie im Projekt-Dropdown von Zapier den Wert **Custom** und fügen Sie Ihre Seiten-ID ein

![Eigenes Projekt in Zapier](https://instatus.com/help/integrations/zapier-custom-id.png)

### Trigger löst nicht aus

- Stellen Sie sicher, dass Ihr Zap in Zapier eingeschaltet ist
- Prüfen Sie, ob Sie in der Trigger-Konfiguration das richtige Projekt gewählt haben
- Prüfen Sie, ob auf der gewählten Statusseite Vorfälle erstellt oder aktualisiert werden
- Testen Sie den Trigger in Zapier manuell, um die Verbindung zu prüfen (klicken Sie auf **Test Run** und wählen Sie einen Vorfall aus der Liste)

![Zapier-Testlauf](https://instatus.com/help/integrations/zapier-test-run.png)

### Authentifizierungsfehler

- Stellen Sie sicher, dass Ihr API-Schlüssel korrekt ist. Sie können ihn in den [Entwicklereinstellungen](https://dashboard.instatus.com/developer) neu erzeugen
- Achten Sie darauf, den vollständigen API-Schlüssel ohne zusätzliche Leerzeichen einzufügen

### Komponenten werden nicht angezeigt

- Stellen Sie sicher, dass auf Ihrer Statusseite Komponenten eingerichtet sind
- Klicken Sie in Zapier auf **Refresh fields**, um die aktuellen Komponenten Ihrer Statusseite zu laden

![Zapier: Felder aktualisieren](https://instatus.com/help/integrations/zapier-refresh.png)

Brauchen Sie weitere Hilfe? Schreiben Sie uns an [support@instatus.com](mailto:support@instatus.com).