# Deine Webhooks hören auf, eine eine Blackbox.

> Prüfe jeden eingehenden Webhook-Aufruf in Pocket Alert: Header, Payload, gerenderte Nachricht und Fehlergrund. Debugge Webhook-Integrationen mit bis zu einem Jahr Verlauf.

<!-- source: https://pocketalert.app/de/features/webhook-history -->

Zuletzt aktualisiert: 2026-08-11

Jeder eingehende Aufruf wird mit Headern, Payload, erzeugter Nachricht und Ergebnis protokolliert. Wenn eine Integration beteuert, die Anfrage gesendet zu haben, kannst du es überprüfen.

Dokumentation: https://info.pocketalert.app/api/webhooks/history.html

## Finde heraus, was tatsächlich angekommen ist

1. **Dienst darauf ausrichten** — Erstelle einen Webhook und richte deinen Dienst wie gewohnt auf dessen URL.
2. **Verlauf öffnen** — Öffne den Webhook im Dashboard und wechsle zu seinem Verlauf.
3. **Aufruf aufklappen** — Klappe einen Aufruf auf, um Header, Body, die erzeugte Nachricht und den Fehler zu sehen.

## Alles, was dir ein fehlgeschlagener Webhook nicht verrät

Wenn eine Push-Benachrichtigung nicht ankommt, stellt sich immer dieselbe Frage: Hat der Absender tatsächlich aufgerufen, und wenn ja, was ist auf unserer Seite schiefgelaufen?

- **Ein Protokoll jeder Anfrage** — Jeder Aufruf wird protokolliert, neueste zuerst, direkt in der Liste aufklappbar. Methode, Quell-IP, Größe und Content-Type auf einen Blick.
- **Header und Payload vollständig** — Alle Header und der rohe Body genau so, wie sie ankamen. So kannst du vergleichen, was ein Dienst angeblich sendet, mit dem, was er tatsächlich gesendet hat.
- **Was dein Template erzeugt hat** — Sieh die Nachricht, die dein Template aus der Payload erzeugt hat, direkt neben der Payload selbst. Fehler im Template werden nicht länger geraten.
- **Benannte Fehlergründe** — Fehlgeschlagene Aufrufe kommen mit einem konkreten Grund: ungültiges JSON, eine leere Nachricht wegen fehlendem %path% oder ein inaktiver Webhook.
- **Geschwärzt und verschlüsselt** — Authorization-, Cookie- und API-Schlüssel-Header werden vor dem Speichern geschwärzt, und Payloads sind mit deinem Schlüssel verschlüsselt gespeichert.
- **Filtern, blättern oder abrufen** — Filtere nach Ergebnis und blättere im Dashboard durch den Verlauf, oder rufe ihn über die API ab und werte ihn selbst aus.

## So funktioniert der Webhook-Verlauf

    
Jede Anfrage, die eine deiner Webhook-URLs erreicht, wird protokolliert, bevor sie verarbeitet wird, und das Ergebnis wird angehängt, sobald die Verarbeitung abgeschlossen ist. So siehst du fehlgeschlagene Aufrufe genauso deutlich wie erfolgreiche, auch Aufrufe an einen Webhook, den du deaktiviert und vergessen hast.

    
Öffne einen Webhook im Dashboard, dort findest du den Verlauf, neueste zuerst. Jede Zeile klappt auf und zeigt den Query-String, alle Header und den Body mit formatiertem JSON. Dieselben Daten sind über die REST-API verfügbar, mit Filtern für `success` und `error`.

    
## Ein Template debuggen

    
Der häufigste Fehler ist kein Netzwerkproblem, sondern ein `%path%`-Platzhalter, der auf ein Feld zeigt, das der Absender gar nicht sendet. Der Verlauf zeigt den rohen Payload und die vom Template erzeugte Nachricht nebeneinander, dadurch wird die Abweichung meist in Sekunden sichtbar.

    
## Datenschutz

    
Payloads enthalten oft Geheimnisse, deshalb werden sie mit deinem persönlichen Schlüssel verschlüsselt gespeichert, und Authorization-, Cookie- und API-Schlüssel-Header werden vor dem Speichern durch `[redacted]` ersetzt. Die Aufbewahrung reicht von 7 Tagen im kostenlosen Tarif bis zu einem vollen Jahr bei Large.

## FAQ

### Was wird für jeden Webhook-Aufruf protokolliert?

Zeitstempel, HTTP-Methode, Quell-IP, Content-Type, Query-String, alle Header, der rohe Body, die Payload-Größe, die Nachricht, die dein Template erzeugt hat, ob eine Push-Benachrichtigung erstellt wurde, ein Fehlergrund, falls nicht, und wie lange die Verarbeitung gedauert hat.

### Wie lange wird der Webhook-Verlauf gespeichert?

7 Tage im kostenlosen Tarif, 30 bei Starter, 90 bei Medium und 365 bei Large. Ältere Aufrufe werden automatisch entfernt, ebenso die ältesten Einträge, sobald ein einzelner Webhook 1.000 protokollierte Aufrufe überschreitet.

### Ist die gespeicherte Payload sicher?

Ja. Payloads werden im Ruhezustand mit deinem persönlichen Schlüssel verschlüsselt, genauso wie Nachrichteninhalte. Authorization-, Cookie- und API-Schlüssel-Header werden vor dem Speichern durch [redacted] ersetzt.

### Ein Dienst sagt, er hat den Webhook gesendet, aber es kam nichts an. Was nun?

Der Verlauf zeigt dir, welches davon zutrifft. Wenn gar nichts protokolliert ist, hat der Absender uns nie erreicht. Wenn ein Aufruf mit Fehler protokolliert ist, erfährst du den Grund: ungültiges JSON, eine leere Nachricht, weil ein %path% in der Payload nicht existiert, oder ein Webhook, der deaktiviert war.

### Wo sehe ich den Verlauf?

Öffne den Webhook in deinem Dashboard, dort findest du den Verlauf, neueste zuerst, und jeder Aufruf lässt sich aufklappen. Außerdem gibt es einen REST-Endpunkt, wenn du die Daten lieber programmatisch abrufen möchtest, mit Filtern für Erfolg und Fehler.

### Funktioniert der Webhook-Verlauf im kostenlosen Tarif?

Ja, mit 7 Tagen Aufbewahrung. Wenn du länger brauchst, verlängern das die kostenpflichtigen Tarife.
