# Zapier + Instatus

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

Collega Instatus a oltre 8.000 app tramite Zapier per automatizzare i tuoi flussi di gestione degli incidenti.

1. Vai su [Instatus su Zapier](https://zapier.com/apps/instatus/integrations)
2. Clicca su **Connect Instatus to 8,000+ apps** per aggiungere Instatus al tuo account Zapier
3. Quando ti viene chiesta l'autenticazione, recupera la tua chiave API dalle [impostazioni per sviluppatori di Instatus](https://dashboard.instatus.com/developer) e incollala in Zapier

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

## Trigger

### Nuovo incidente o aggiornamento di un incidente

Si attiva quando viene creato un nuovo incidente o viene aggiornato un incidente esistente. Usalo per avvisare il tuo team, registrare gli incidenti in un foglio di calcolo, creare ticket in altri strumenti e altro ancora.

**Configurazione**

- **Project**: scegli quale status page di Instatus monitorare per gli incidenti

**Dati del trigger**

Il trigger fornisce i dati seguenti, che puoi usare nei passaggi successivi dello Zap:

- `id` - ID univoco dell'incidente
- `type` - `CREATE` (nuovo incidente) oppure `UPDATE` (aggiornamento dell'incidente)
- `name` - nome/titolo dell'incidente
- `status` - stato attuale dell'incidente (`INVESTIGATING`, `IDENTIFIED`, `MONITORING`, `RESOLVED`)
- `started` - quando è iniziato l'incidente
- `resolved` - quando l'incidente è stato risolto (se applicabile)
- `duration` - durata dell'incidente in secondi (se applicabile)
- `impact` - livello di impatto (`OPERATIONAL`, `UNDERMAINTENANCE`, `DEGRADEDPERFORMANCE`, `PARTIALOUTAGE`, `MAJOROUTAGE`)
- `components` - elenco dei componenti interessati (ciascuno con `id`, `name`, `status`)
- `updates` - elenco degli aggiornamenti dell'incidente (ciascuno con `id`, `status`, `started`, `message`)

## Azioni

Per configurare un'azione Instatus, inizia scegliendo il progetto Instatus (status page) su cui vuoi lavorare. Se non vedi il tuo progetto nel menu a tendina, puoi inserire manualmente il tuo Page ID: vedi la sezione [Risoluzione dei problemi](#non-trovi-il-tuo-progetto-nellelenco) per le istruzioni.

Una volta scelto il progetto, compariranno altri campi per configurare l'azione.

![Configurazione dell'azione in Zapier](https://instatus.com/help/integrations/zapier-config.png)

### Creare un incidente

Crea un nuovo incidente in Instatus a partire da trigger di altre app. Usalo per creare automaticamente incidenti sulla status page da strumenti di monitoraggio, sistemi di ticketing o qualsiasi altra app disponibile su Zapier.

**Configurazione**

- **Project** (obbligatorio) - scegli su quale status page di Instatus creare l'incidente
- **Status** (obbligatorio) - stato dell'incidente: `INVESTIGATING`, `IDENTIFIED`, `MONITORING`, `RESOLVED`
- **Title** (obbligatorio) - il titolo/nome dell'incidente
- **Description** - messaggio che descrive l'incidente
- **Affected Components** - scegli quali componenti sono interessati
- **Components Status** - stato dei componenti interessati (ad esempio `OPERATIONAL`, `DEGRADEDPERFORMANCE`, `PARTIALOUTAGE`, `MAJOROUTAGE`)
- **Started On** - quando è iniziato l'incidente (per impostazione predefinita adesso)
- **Publish incident to status page** - se rendere visibile l'incidente sulla tua status page pubblica
- **Notify subscribers about the incident** - se inviare notifiche agli iscritti alla tua status page

## Esempi di utilizzo

- **Registrare gli incidenti in Google Sheets**: conserva uno storico di tutti gli incidenti per report e analisi
- **Creare voci in un database Notion**: aggiungi automaticamente gli incidenti al workspace Notion del tuo team per tenerne traccia
- **Creare incidenti dalle issue di GitHub**: apri un incidente Instatus quando su GitHub viene segnalato un bug critico
- **Sincronizzare con Airtable**: costruisci dashboard e report personalizzati sugli incidenti in Airtable

È tutto pronto! Inizia a costruire i tuoi Zap.

## Risoluzione dei problemi

### Non trovi il tuo progetto nell'elenco

Se la tua status page non compare nel menu a tendina dei progetti, puoi trovare il tuo Page ID manualmente:

1. Vai alla tua status page nella [dashboard di Instatus](https://dashboard.instatus.com)
2. Fai clic destro sul progetto in alto a sinistra per aprire il menu
3. Clicca su **Copia ID progetto**

![Copia il Page ID](https://instatus.com/help/copy-id.png)

4. Scegli il valore **Custom** nel menu a tendina dei progetti di Zapier e incolla il tuo Page ID

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

### Il trigger non si attiva

- Verifica che il tuo Zap sia attivo su Zapier
- Controlla di aver scelto il progetto corretto nella configurazione del trigger
- Verifica che sulla status page scelta vengano davvero creati o aggiornati incidenti
- Prova a testare il trigger manualmente in Zapier per verificare la connessione (clicca sul pulsante **Test Run** e scegli un incidente dall'elenco)

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

### Errori di autenticazione

- Assicurati che la tua chiave API sia corretta. Puoi rigenerarla dalle [impostazioni per sviluppatori](https://dashboard.instatus.com/developer)
- Verifica di aver incollato la chiave API completa, senza spazi in più

### I componenti non compaiono

- Verifica che la tua status page abbia dei componenti configurati
- Clicca su **Refresh fields** in Zapier per caricare i componenti più recenti dalla tua status page

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

Ti serve altro aiuto? Scrivici a [support@instatus.com](mailto:support@instatus.com).
