# Fai in modo che un workflow concluso fa vibrare il telefono.

> Ricevi i risultati di GitHub Actions come notifiche push. Aggiungi uno step Pocket Alert al tuo workflow e controlla build fallite o deploy completati sul telefono in meno di un secondo.

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

Ultimo aggiornamento: 2026-08-11

Pocket Alert invia i risultati di GitHub Actions al tuo telefono come notifiche push. Aggiungi un passaggio curl a un workflow e, quando una build, un deploy o una release termina, il risultato arriva su iPhone o Android in meno di un secondo, senza dover controllare la scheda Actions.

## Tre passaggi per avere su telefono le notifiche di GitHub Actions

1. **Crea un'applicazione** — Aggiungi un'applicazione in Pocket Alert e salva la tua chiave API come secret del repo POCKETALERT_API_KEY.
2. **Configura il passaggio** — Aggiungi un passaggio di notifica che esegue curl sull'API dei messaggi, usando if: failure() e if: success() per scegliere gli esiti.
3. **Mappa e invia** — Inserisci repo, sha e workflow nel messaggio. La prossima run farà vibrare il tuo telefono.

## Dalla run del workflow alla schermata di blocco

Il tuo workflow sa già quando un job termina. Pocket Alert trasforma quel momento in una notifica push che non puoi perdere.

- **Un solo passaggio nel workflow** — Una singola chiamata curl all'API dei messaggi trasforma qualsiasi passaggio del workflow in una notifica push. Nessuna configurazione del runner, nessun servizio aggiuntivo.
- **Chiave come secret del repo** — Leggi la tua chiave API da ${{ secrets.POCKETALERT_API_KEY }} così resta fuori dai log e può essere ruotata dalla dashboard.
- **Avvisi solo per gli esiti che scegli** — Abbina if: failure() e if: success() per inviare build fallite e deploy riusciti come messaggi separati e chiaramente etichettati.
- **Un canale per ogni repo** — Ogni applicazione ha il proprio ID, così le run dei singoli repo e ambienti restano in canali separati.
- **Consegna in meno di un secondo** — Il passaggio parte nel momento in cui il job termina, quindi il risultato arriva sul tuo telefono in meno di un secondo.
- **Contesto completo della run** — Inserisci github.repository, github.sha e github.workflow nel messaggio per sapere esattamente quale run era.

## Invia le notifiche di GitHub Actions sul tuo telefono

### 1. Crea un'applicazione e salva la tua chiave API

Aggiungi un'applicazione in Pocket Alert e copia la tua chiave API. Salvala come secret del repository con nome `POCKETALERT_API_KEY` in Settings → Secrets and variables → Actions.

### 2. Aggiungi un passaggio di notifica che chiama l'API dei messaggi

```
- name: Notify on failure
  if: failure()
  run: |
    curl -X POST "https://api.pocketalert.app/v1/messages" \
      -H "Token: ${{ secrets.POCKETALERT_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{"title":"Build failed","message":"${{ github.workflow }} on ${{ github.ref_name }} (${{ github.sha }})","level":"high"}'

- name: Notify on success
  if: success()
  run: |
    curl -X POST "https://api.pocketalert.app/v1/messages" \
      -H "Token: ${{ secrets.POCKETALERT_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{"title":"Deploy succeeded","message":"${{ github.repository }}@${{ github.sha }}"}'
```

### 3. Indirizza a un'applicazione specifica

Aggiungi `application_id` al corpo per inviare la notifica a una sola app (trovi il TID nella dashboard):

```
-d '{"title":"Release shipped","message":"${{ github.repository }} ${{ github.ref_name }}","application_id":"qm47b9pzxzxg"}'
```

La [guida introduttiva](https://info.pocketalert.app/getting-started.html) mostra tutti i campi accettati dall'API dei messaggi.

## FAQ

### Come ricevo le notifiche di GitHub Actions sul telefono?

Aggiungi un passaggio che esegue curl su https://api.pocketalert.app/v1/messages con la tua chiave API nell'header Token. Mettilo alla fine del job, così un deploy completato o una build fallita arrivano subito sul tuo telefono come notifica push.

### Come tengo la chiave al sicuro?

Salva la tua chiave API come secret del repository e leggila con ${{ secrets.POCKETALERT_API_KEY }}, inviandola nell'header Token. La chiave non compare mai nei log e puoi ruotarla dalla dashboard di Pocket Alert.

### Posso ricevere avvisi solo in caso di errore?

Usa if: failure() e if: success() su due passaggi separati. Una build fallita genera un messaggio, un deploy riuscito ne genera un altro, così puoi collegare solo gli esiti che ti interessano.

### Posso separare gli avvisi per repo?

Assegna a ogni repo o ambiente la sua applicazione. I workflow di frontend, backend e release finiscono in canali separati che puoi silenziare indipendentemente.

### Posso includere il commit e il workflow?

Inserisci nel corpo del messaggio il contesto della run, come ${{ github.repository }}, ${{ github.sha }} e ${{ github.workflow }}, così la notifica ti dice esattamente quale run è terminata.

### Quale endpoint chiama il passaggio?

Il passaggio chiama https://api.pocketalert.app/v1/messages con un header Token e un corpo JSON con title e message. Aggiungi application_id per indirizzare la notifica a un'applicazione specifica.

### Una build fallita può essere più rumorosa di una riuscita?

Aggiungi "level":"high" al corpo del passaggio di errore e la notifica supera la modalità Full immersion su iPhone e suona con maggiore evidenza su Android; "level":"critical" va oltre e ignora completamente Non disturbare. Le notifiche di deploy riuscito possono essere inviate con "level":"silent", così finiscono nello storico senza vibrare.
