# Im Moment, in dem ein Deployment fertig ist.

> Erhalte eine Push-Benachrichtigung, wenn ein Deployment erfolgreich war oder fehlschlägt. Füge einen Schritt zu GitHub Actions, GitLab CI oder Jenkins hinzu, und das Deployment-Ergebnis landet in Sekunden auf deinem Smartphone.

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

Zuletzt aktualisiert: 2026-08-11

Füg einen Benachrichtigungsschritt zu GitHub Actions, GitLab CI oder Jenkins hinzu, oder richte einen Deployment-Webhook von Vercel oder Netlify auf Pocket Alert aus. Das Ergebnis des Deployments erreicht dein Handy innerhalb einer Sekunde nach Ende des Jobs, mit Commit, Branch und Umgebung.

## Drei Schritte zu Deployment-Benachrichtigungen

1. **API-Schlüssel oder Webhook-URL holen** — Erstell einen API-Schlüssel für einen CLI- oder curl-Aufruf oder einen Webhook und kopier dessen Empfangs-URL.
2. **Schritt oder Webhook hinzufügen** — Füg deiner Pipeline einen Benachrichtigungsschritt hinzu oder füg die Empfangs-URL in die Deployment-Benachrichtigungen von Vercel oder Netlify ein.
3. **Mit Vertrauen ausliefern** — Liefer ein Release aus, und dein Handy vibriert mit Ergebnis, Commit und Umgebung.

## Jedes Release auf deinem Handy

Wenn ein Release still fehlschlägt, erfährst du es in Sekunden, lange bevor ein Nutzer die kaputte Seite meldet.

- **Passt in jede Pipeline** — GitHub Actions, GitLab CI, Jenkins und CircleCI brauchen jeweils einen einzigen Schritt am Ende der Pipeline.
- **Erfolg oder Fehler** — Sende bei Erfolg, bei Fehler oder bei beidem. Führ den Benachrichtigungsschritt mit if: failure() aus, um nur von kaputten Releases zu hören.
- **Deployment-Kontext** — Schreib Commit, Branch, Umgebung und Lauf-URL in die Nachricht, damit du genau weißt, was ausgeliefert wurde.
- **Kanäle pro Umgebung** — Eine eigene Anwendung pro Umgebung hält Prod-, Staging- und Preview-Deployments in getrennten Kanälen.
- **Sofort nach Abschluss** — Die Push-Benachrichtigung kommt, sobald der Job endet, du kannst den Pipeline-Tab also schließen.
- **Keine Einrichtung nötig** — Ein CLI-Aufruf oder curl in deinem Job genügt. Es muss kein Slack-Bot installiert werden.

## Bei jedem Deployment benachrichtigen

### 1. CI/CD-Pipeline (CLI oder curl)

Füg einen Schritt am Ende deines GitHub-Actions-, GitLab-CI-, Jenkins- oder CircleCI-Jobs hinzu. Mit der CLI:

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

Oder ruf die Messages-API direkt per curl auf, damit auf dem Runner nichts installiert werden muss:

```
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 oder Netlify (Webhook)

Erstell einen Webhook, damit Vercel oder Netlify ihre eigene Deployment-Payload an Pocket Alert senden können. Das Feld `message` ist eine GJSON-Vorlage, die ihre Felder in die Push-Benachrichtigung übernimmt:

```
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"}'
```

Du bekommst eine Empfangs-URL wie `https://p4a.me/wh/1234abcd`. Füg sie in die Webhook-Einstellungen von Vercel ein (Ereignisse wie `deployment.succeeded`). Für Netlify fügst du sie als ausgehenden Webhook für Deployment-Benachrichtigungen hinzu und ordnest die Felder zu, zum Beispiel `%name% is %state% on %branch%`.

Die [Dokumentation zu den Webhook-Einstellungen](https://info.pocketalert.app/api/webhooks/settings.html) beschreibt die Messages-API und die GJSON-Feldzuordnung.

## FAQ

### Wie bekomme ich Deployment-Benachrichtigungen?

Füg am Ende deiner Pipeline in GitHub Actions, GitLab CI, Jenkins oder CircleCI einen Benachrichtigungsschritt hinzu. Führ die Pocket Alert CLI oder einen curl-Aufruf aus, dann kommt das Deployment-Ergebnis als Push-Benachrichtigung, sobald der Job endet.

### Kann ich nur bei fehlgeschlagenen Deployments benachrichtigt werden?

Ja. Nutze den Job-Status, um eine Erfolgs- oder Fehlermeldung zu senden, und führ den Benachrichtigungsschritt nur mit if: failure() aus, damit du nur bei einem kaputten Release benachrichtigt wirst.

### Kann ich Commit und Umgebung mit angeben?

Schreib Commit, Branch, Umgebung und Pipeline-URL in den Nachrichtentext. Die Benachrichtigung sagt dir dann, was ausgeliefert wurde und wo, und verlinkt direkt auf den Lauf.

### Welche CI/CD-Tools werden unterstützt?

Alles, was einen Befehl ausführt, funktioniert: GitHub Actions, GitLab CI, Jenkins, CircleCI, Bitbucket Pipelines oder ein einfaches Deploy-Skript. Für Vercel und Netlify erstellst du einen Pocket Alert Webhook und fügst dessen Empfangs-URL in die Einstellungen für Deployment-Benachrichtigungen ein.

### Kann ich Benachrichtigungen für Prod und Staging trennen?

Leg für Prod, Staging und Preview jeweils eine eigene Anwendung an. Produktions-Deployments landen dann in einem eigenen Kanal, und du erkennst Releases auf einen Blick.

### Kann ein fehlgeschlagenes Produktions-Deployment Nicht stören durchbrechen?

Ja. Sende fehlgeschlagene Deployments mit level=critical: Android zeigt sie in einem eigenen Kanal, der Nicht stören umgeht, und das iPhone zeigt sie als zeitkritische Benachrichtigungen, die sich durch den Fokus-Modus durchsetzen. Routinemäßige Erfolgsmeldungen kannst du mit level=silent senden, dann landen sie im Verlauf, ohne zu vibrieren.
