Webhook

Webhook

Ein Webhook übermittelt eine Nachricht an eine vereinbarte Webadresse, wenn im sendenden System ein abonniertes Ereignis auftritt. Das empfangende System kann darauf reagieren. Anders als beim Polling muss es dafür nicht wiederholt nach neuen Daten fragen; Zustellung und erfolgreiche Verarbeitung bleiben jedoch getrennte Schritte.

Webhook im Detail

Ein passt zu einem klar definierten Auslöser, etwa einer bestätigten Statusänderung. Lege fest, welche Nachricht mit welchen Angaben erwartet wird und welche Aktion daraus folgen darf. Nicht jede beobachtete Aktivität ist bereits ein qualifizierter Kontakt oder eine Berechtigung zur Ansprache.

Plane Verzögerungen und Ausfälle ein. Nachrichten können je nach Anbieter erneut zugestellt werden; Wiederholungs- und Reihenfolgeregeln unterscheiden sich. Das Zielsystem sollte doppelte Verarbeitung erkennen und mit fehlenden oder verspäteten Ereignissen umgehen können. Prüfe diese Regeln in der jeweiligen Dokumentation.

Auch Herkunft und Inhalt gehören zur Prüfung. Je nach System helfen Signaturen, Zustellungskennungen und geeignete Zugriffskontrollen. Eine Empfangsbestätigung kann vor der eigentlichen Verarbeitung erfolgen. Überwache daher das fachliche Ergebnis zusätzlich zur HTTP-Antwort.

Ein Webhook ist nicht mit einer Conversions API gleichzusetzen. Er beschreibt einen Auslöse- und Zustellungsmechanismus, während eine API allgemein Funktionen und Regeln für Softwarezugriffe festlegt. Beide können zusammenspielen. Keine dieser Bezeichnungen garantiert vollständiges Tracking oder rechtlich zulässige Datennutzung.

Beispiele

Hypothetisches Anwendungsbeispiel

Ein Buchungssystem meldet eine bestätigte Terminänderung an ein Kundenportal. Nach einer unterbrochenen Verbindung wird dieselbe Nachricht nochmals zugestellt. Das Portal erkennt die Kennung wieder und aktualisiert den Termin nur einmal. Ein eigener Test prüft, was bei einer verspäteten älteren Statusmeldung passiert.

Wichtige Punkte

Auslöser, Nachricht und erlaubte Folgeaktion festlegen.
Zustellung und Verarbeitung getrennt beobachten.
Wiederholungen und verspätete Nachrichten testen.
Anbieterspezifische Regeln statt allgemeiner Echtzeitgarantien verwenden.

Anwendung im Marketing-Alltag

Definiere benötigte Ereignisse und ihre Folgen. Teste normale, doppelte, verspätete und fehlgeschlagene Zustellungen bis zum tatsächlichen Ergebnis.

Sinnvolle Messgrößen

Verarbeitete Ereignisse

Zustellungsstatus mit dem tatsächlichen fachlichen Ergebnis vergleichen.

Verarbeitungsdauer

Zeit vom Auslöser bis zum bestätigten Ergebnis untersuchen.

Wiederholungs- und Fehlerbehandlung

Prüfen, ob doppelte, verspätete und fehlende Nachrichten kontrolliert behandelt werden.

Häufige Fehler

Empfangsbestätigung als vollständig erledigten Vorgang interpretieren.
Eine feste Zustellungsreihenfolge ohne Anbieternachweis annehmen.
Webhooks mit vollständigem, einwilligungsunabhängigem Tracking gleichsetzen.

Quellen und Einordnung

GitHub Docs: About webhooks
Erklärt ereignisgesteuerte Zustellung und den Unterschied zu wiederholten Abfragen.
GitHub Docs: Webhook best practices
Konkrete Hinweise zu Herkunftsprüfung, Zustellungskennungen und erneuter Zustellung; GitHub-spezifische Zeitgrenzen sind keine allgemeinen Regeln.

Häufige Fragen zu Webhook

Nein. Netzwerk, Anbieter und Zielsystem können die Zustellung verzögern oder verhindern. Plane den benötigten Umgang damit.

Begriffsempfehlungen werden geladen…

Alle Begriffe

Webhook im Detail