# Lass einen fertigen Workflow dein Handy zum Vibrieren bringen.

> Erhalte GitHub Actions-Ergebnisse als Push-Benachrichtigungen. Füge einen Pocket Alert-Step in deinen Workflow ein und sieh fehlgeschlagene Builds oder abgeschlossene Deployments in unter einer Sekunde auf deinem Handy.

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

Zuletzt aktualisiert: 2026-08-11

Pocket Alert schickt GitHub-Actions-Ergebnisse als Push-Benachrichtigungen auf dein Handy. Füg einen curl-Schritt zu einem Workflow hinzu, und wenn ein Build, Deployment oder Release fertig ist, kommt das Ergebnis in unter einer Sekunde auf dem iPhone oder Android an – ohne dass du den Actions-Tab im Blick behalten musst.

## Drei Schritte zu GitHub-Actions-Benachrichtigungen auf deinem Handy

1. **Anwendung anlegen** — Lege in Pocket Alert eine Anwendung an und speichere deinen API-Schlüssel als Repo-Secret POCKETALERT_API_KEY.
2. **Schritt einrichten** — Füg einen Benachrichtigungs-Schritt hinzu, der per curl die Messages-API aufruft und mit if: failure() und if: success() die Ergebnisse auswählt.
3. **Zuordnen und loslegen** — Übernimm Repo, SHA und Workflow in die Nachricht. Der nächste Lauf lässt dein Handy vibrieren.

## Vom Workflow-Lauf auf den Sperrbildschirm

Dein Workflow weiß bereits, wann ein Job fertig ist. Pocket Alert macht diesen Moment zu einer Push-Benachrichtigung, die du nicht übersehen kannst.

- **Ein Schritt in deinem Workflow** — Ein einziger curl-Aufruf gegen die Messages-API macht aus jedem Workflow-Schritt eine Push-Benachrichtigung. Kein Runner-Setup, kein zusätzlicher Dienst.
- **Schlüssel als Repo-Secret** — Lies deinen API-Schlüssel aus ${{ secrets.POCKETALERT_API_KEY }}, damit er nicht in Logs auftaucht und du ihn im Dashboard rotieren kannst.
- **Benachrichtigungen nach den Ergebnissen, die du wählst** — Kombiniere if: failure() und if: success(), um fehlgeschlagene Builds und grüne Deployments als getrennte, klar beschriftete Nachrichten zu senden.
- **Ein Kanal pro Repo** — Jede Anwendung hat eine eigene ID, daher bleiben Läufe pro Repo und pro Umgebung in getrennten Kanälen.
- **Zustellung in unter einer Sekunde** — Der Schritt feuert in dem Moment, in dem der Job endet, sodass das Ergebnis in weniger als einer Sekunde auf deinem Handy ankommt.
- **Vollständiger Lauf-Kontext** — Übernimm github.repository, github.sha und github.workflow in die Nachricht, damit du genau weißt, um welchen Lauf es ging.

## GitHub-Actions-Benachrichtigungen aufs Handy schicken

### 1. Anwendung anlegen und API-Schlüssel speichern

Lege in Pocket Alert eine Anwendung an und kopiere deinen API-Schlüssel. Speichere ihn als Repository-Secret mit dem Namen `POCKETALERT_API_KEY` unter Einstellungen → Geheimnisse und Variablen → Actions.

### 2. Benachrichtigungs-Schritt hinzufügen, der die Messages-API aufruft

```
- 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. An eine bestimmte Anwendung senden

Füg `application_id` zum Body hinzu, um die Push-Benachrichtigung an eine App zu senden (die TID findest du im Dashboard):

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

In der [Dokumentation zum Einstieg](https://info.pocketalert.app/getting-started.html) findest du alle Felder, die die Messages-API akzeptiert.

## FAQ

### Wie bekomme ich GitHub-Actions-Benachrichtigungen auf mein Handy?

Füg einen Schritt hinzu, der curl gegen https://api.pocketalert.app/v1/messages ausführt, und übergib deinen API-Schlüssel im Token-Header. Setz ihn ans Ende des Jobs, damit ein abgeschlossenes Deployment oder ein fehlgeschlagener Build direkt eine Push-Benachrichtigung auf dein Handy schickt.

### Wie halte ich den Schlüssel geheim?

Speichere deinen API-Schlüssel als Repository-Secret und lies ihn mit ${{ secrets.POCKETALERT_API_KEY }} aus, der im Token-Header gesendet wird. Der Schlüssel taucht nie in Logs auf, und du rotierst ihn im Pocket-Alert-Dashboard.

### Kann ich nur bei Fehlern benachrichtigt werden?

Verwende if: failure() und if: success() in zwei getrennten Schritten. Ein fehlgeschlagener Build löst eine Nachricht aus, ein grünes Deployment eine andere, sodass du nur die Ergebnisse verdrahtest, die dich interessieren.

### Kann ich Benachrichtigungen pro Repo aufteilen?

Gib jedem Repo oder jeder Umgebung eine eigene Anwendung. Frontend-, Backend- und Release-Workflows landen in getrennten Kanälen, die du unabhängig stummschalten kannst.

### Kann ich Commit und Workflow mit angeben?

Verwende Run-Kontext wie ${{ github.repository }}, ${{ github.sha }} und ${{ github.workflow }} im Nachrichtentext, damit die Push-Benachrichtigung genau sagt, welcher Lauf abgeschlossen wurde.

### Welchen Endpunkt ruft der Schritt auf?

Der Schritt ruft https://api.pocketalert.app/v1/messages mit einem Token-Header und einem JSON-Body aus title und message auf. Füg application_id hinzu, um die Push-Benachrichtigung an eine bestimmte App zu leiten.

### Kann ein fehlgeschlagener Build lauter sein als ein erfolgreicher?

Füg "level":"high" zum Body des Fehler-Schritts hinzu, dann durchbricht die Push-Benachrichtigung auf dem iPhone den Fokus und klingelt auf Android deutlich hörbar; "level":"critical" geht noch weiter und umgeht „Nicht stören“ komplett. Meldungen über grüne Deployments kannst du als "level":"silent" senden, dann landen sie im Verlauf, ohne zu vibrieren.
