# Zapier + Instatus

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

Koppel Instatus via Zapier aan meer dan 8.000 apps en automatiseer zo je workflows voor incidentbeheer.

1. Ga naar [Instatus op Zapier](https://zapier.com/apps/instatus/integrations)
2. Klik op **Connect Instatus to 8,000+ apps** om Instatus aan je Zapier-account toe te voegen
3. Wordt er om authenticatie gevraagd, haal dan je API-sleutel op uit de [ontwikkelaarsinstellingen van Instatus](https://dashboard.instatus.com/developer) en plak die in Zapier

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

## Triggers

### Nieuw incident of incidentupdate

Gaat af wanneer er een nieuw incident wordt aangemaakt of een bestaand incident wordt bijgewerkt. Gebruik dit om je team te waarschuwen, incidenten in spreadsheets vast te leggen, tickets in andere tools aan te maken en meer.

**Configuratie**

- **Project**: kies welke Instatus-statuspagina op incidenten wordt gecontroleerd

**Triggerdata**

De trigger levert de volgende data, die je in de volgende stappen van je Zap kunt gebruiken:

- `id` - uniek incident-ID
- `type` - `CREATE` (nieuw incident) of `UPDATE` (incidentupdate)
- `name` - naam/titel van het incident
- `status` - huidige status van het incident (`INVESTIGATING`, `IDENTIFIED`, `MONITORING`, `RESOLVED`)
- `started` - wanneer het incident is begonnen
- `resolved` - wanneer het incident is opgelost (indien van toepassing)
- `duration` - duur van het incident in seconden (indien van toepassing)
- `impact` - mate van invloed (`OPERATIONAL`, `UNDERMAINTENANCE`, `DEGRADEDPERFORMANCE`, `PARTIALOUTAGE`, `MAJOROUTAGE`)
- `components` - lijst met getroffen componenten (elk met `id`, `name`, `status`)
- `updates` - lijst met incidentupdates (elk met `id`, `status`, `started`, `message`)

## Acties

Begin bij het instellen van een Instatus-actie met het kiezen van het Instatus-project (de statuspagina) waarmee je wilt werken. Staat je project niet in de keuzelijst, dan kun je je Page ID handmatig invullen — zie het onderdeel [Problemen oplossen](#je-project-staat-niet-in-de-lijst) voor instructies.

Zodra je een project hebt gekozen, verschijnen er extra velden om de actie in te stellen.

![Configuratie van een Zapier-actie](https://instatus.com/help/integrations/zapier-config.png)

### Incident aanmaken

Maak vanuit triggers in andere apps een nieuw incident in Instatus aan. Gebruik dit om automatisch incidenten op je statuspagina te laten ontstaan vanuit monitoringtools, ticketsystemen of elke andere app in Zapier.

**Configuratie**

- **Project** (verplicht) - kies op welke Instatus-statuspagina het incident wordt aangemaakt
- **Status** (verplicht) - status van het incident: `INVESTIGATING`, `IDENTIFIED`, `MONITORING`, `RESOLVED`
- **Title** (verplicht) - de titel/naam van het incident
- **Description** - bericht waarin je het incident beschrijft
- **Affected Components** - kies welke componenten getroffen zijn
- **Components Status** - status voor de getroffen componenten (bijvoorbeeld `OPERATIONAL`, `DEGRADEDPERFORMANCE`, `PARTIALOUTAGE`, `MAJOROUTAGE`)
- **Started On** - wanneer het incident is begonnen (standaard nu)
- **Publish incident to status page** - of het incident zichtbaar is op je openbare statuspagina
- **Notify subscribers about the incident** - of er notificaties naar de abonnees van je statuspagina gaan

## Voorbeelden van toepassingen

- **Incidenten vastleggen in Google Sheets**: houd een historisch overzicht van alle incidenten bij voor rapportage en analyse
- **Items in een Notion-database aanmaken**: voeg incidenten automatisch toe aan de Notion-workspace van je team om ze te volgen
- **Incidenten aanmaken vanuit GitHub Issues**: activeer een Instatus-incident wanneer er een kritieke bug op GitHub wordt gemeld
- **Synchroniseren met Airtable**: bouw eigen incidentdashboards en -rapportages in Airtable

Je bent helemaal klaar! Ga aan de slag met je Zaps.

## Problemen oplossen

### Je project staat niet in de lijst

Verschijnt je statuspagina niet in de keuzelijst met projecten, dan kun je je Page ID handmatig opzoeken:

1. Ga naar je statuspagina in het [Instatus-dashboard](https://dashboard.instatus.com)
2. Klik met rechts op je project linksboven om het menu te openen
3. Klik op **Copy Project ID**

![Page ID kopiëren](https://instatus.com/help/copy-id.png)

4. Kies de waarde **Custom** in de projectkeuzelijst van Zapier en plak je Page ID

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

### De trigger gaat niet af

- Controleer of je Zap aan staat in Zapier
- Controleer of je het juiste project in de triggerconfiguratie hebt gekozen
- Controleer of er daadwerkelijk incidenten worden aangemaakt of bijgewerkt op de gekozen statuspagina
- Test de trigger handmatig in Zapier om de verbinding te controleren (klik op de knop **Test Run** en kies een incident uit de lijst)

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

### Authenticatiefouten

- Controleer of je API-sleutel klopt. Je kunt hem opnieuw genereren via de [ontwikkelaarsinstellingen](https://dashboard.instatus.com/developer)
- Zorg dat je de volledige API-sleutel plakt, zonder extra spaties

### Componenten verschijnen niet

- Controleer of er componenten op je statuspagina zijn ingesteld
- Klik op **Refresh fields** in Zapier om de nieuwste componenten van je statuspagina te laden

![Velden vernieuwen in Zapier](https://instatus.com/help/integrations/zapier-refresh.png)

Meer hulp nodig? Neem contact met ons op via [support@instatus.com](mailto:support@instatus.com).
