# Nell'istante in cui un deploy termina.

> Ricevi una notifica push quando un deploy riesce o fallisce. Aggiungi un solo step a GitHub Actions, GitLab CI o Jenkins e l'esito dei deploy arriva sul tuo telefono in pochi secondi.

<!-- source: https://pocketalert.app/it/use-cases/deployment-alerts -->

Ultimo aggiornamento: 2026-08-11

Aggiungi un passaggio di notifica a GitHub Actions, GitLab CI o Jenkins, oppure collega il webhook di deploy di Vercel o Netlify a Pocket Alert. L'esito del deploy arriva sul telefono entro un secondo dalla fine del job, con commit, branch e ambiente allegati.

## Tre passaggi per gli avvisi di deploy

1. **Ottieni la chiave o l'URL del webhook** — Crea una chiave API per una chiamata CLI o curl, oppure un webhook e copia il suo URL di ricezione.
2. **Aggiungi un passaggio o un webhook** — Aggiungi un passaggio di notifica alla pipeline, oppure incolla l'URL di ricezione nelle notifiche di deploy di Vercel o Netlify.
3. **Rilascia con sicurezza** — Rilascia una nuova versione e il telefono vibra con esito, commit e ambiente.

## Ogni rilascio sul tuo telefono

Quando un rilascio fallisce in silenzio, lo scopri in pochi secondi, molto prima che un utente segnali il sito rotto.

- **Si integra in qualsiasi pipeline** — GitHub Actions, GitLab CI, Jenkins e CircleCI richiedono ciascuno un solo passaggio alla fine della pipeline.
- **Successo o errore** — Invia in caso di successo, di errore o in entrambi i casi. Esegui il passaggio di notifica con if: failure() per ricevere avvisi solo sui rilasci falliti.
- **Contesto del deploy** — Inserisci commit, branch, ambiente e URL dell'esecuzione nel messaggio, così sai esattamente cosa è stato rilasciato.
- **Canali per ambiente** — Un'applicazione separata per ogni ambiente mantiene i deploy di prod, staging e preview nei rispettivi canali.
- **Immediata al termine** — La notifica arriva quando il job termina, così puoi chiudere la scheda della pipeline.
- **Nessuna configurazione** — Una sola chiamata CLI o curl nel tuo job. Non c'è nessun bot Slack da installare.

## Ricevi un avviso per ogni deploy

### 1. Pipeline CI/CD (CLI o curl)

Aggiungi un passaggio alla fine del tuo job in GitHub Actions, GitLab CI, Jenkins o CircleCI. Con la CLI:

```
pocketalert send -t "Deploy succeeded" -m "prod @ v2.4.0"
```

Oppure invia una richiesta curl direttamente all'API dei messaggi, così non c'è nulla da installare sul runner:

```
curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Deploy succeeded","message":"prod @ v2.4.0","level":"silent"}'
```

### 2. Vercel o Netlify (webhook)

Crea un webhook così Vercel o Netlify possono inviare il proprio payload di deploy a Pocket Alert. Il campo `message` è un template GJSON che mappa i loro campi nella notifica push:

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Vercel deploy","message":"%type%: %payload.project.name% on %payload.deployment.target%","application_id":"qm47b9pzxzxg"}'
```

Ricevi un URL di ricezione come `https://p4a.me/wh/1234abcd`. Incollalo nelle impostazioni webhook di Vercel (eventi come `deployment.succeeded`). Per Netlify, aggiungilo come webhook in uscita per le notifiche di deploy e mappa i suoi campi, ad esempio `%name% is %state% on %branch%`.

La [documentazione sulle impostazioni dei webhook](https://info.pocketalert.app/api/webhooks/settings.html) illustra l'API dei messaggi e la mappatura dei campi GJSON.

## FAQ

### Come ricevo le notifiche di deploy?

Aggiungi un passaggio di notifica alla fine della tua pipeline in GitHub Actions, GitLab CI, Jenkins o CircleCI. Esegui la CLI di Pocket Alert o una chiamata curl, e l'esito del deploy arriva come notifica push appena il job termina.

### Posso ricevere avvisi solo per i deploy falliti?

Sì. Usa lo stato del job per inviare un messaggio di successo o di errore, ed esegui il passaggio di notifica solo con if: failure() così l'avviso che ricevi è quello di un rilascio fallito.

### Posso includere commit e ambiente?

Inserisci commit, branch, ambiente e URL della pipeline nel corpo del messaggio. L'avviso ti dice cosa è stato rilasciato e dove, e rimanda direttamente all'esecuzione.

### Quali strumenti CI/CD sono supportati?

Funziona con qualsiasi strumento che esegue un comando: GitHub Actions, GitLab CI, Jenkins, CircleCI, Bitbucket Pipelines o un semplice script di deploy. Per Vercel e Netlify, crea un webhook di Pocket Alert e incolla il suo URL di ricezione nelle impostazioni di notifica dei deploy.

### Posso separare gli avvisi di prod e staging?

Crea un'applicazione separata per ogni ambiente: prod, staging e preview. I deploy di produzione finiscono nel proprio canale e puoi distinguere i rilasci a colpo d'occhio.

### Un deploy di produzione fallito può superare Non disturbare?

Sì. Invia i deploy falliti con level=critical: su Android vengono pubblicati su un canale dedicato che ignora Non disturbare, mentre su iPhone compaiono come notifiche time-sensitive che passano anche la modalità Full immersion. Gli esiti positivi di routine possono usare level=silent, così restano nella cronologia senza far vibrare il telefono.
