GitHub Actions

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

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.

Push in <1sChiave come secretUn solo passaggio curlAggiornato il
Funzionalità

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.

Per iniziare

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.

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 mostra tutti i campi accettati dall'API dei messaggi.

FAQ

Le risposte alle tue domande

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.

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.

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.

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

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.

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.

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.

Sai che il deploy è andato a buon fine senza guardare la run.

Crea un'applicazione, copia la tua chiave API e aggiungi il passaggio di Pocket Alert al tuo workflow.