Zum Inhalt springen

Integration und Betrieb

Webhook

Ein Webhook ist eine Benachrichtigung, die ein System von sich aus an eine vorher hinterlegte Internetadresse schickt, sobald ein bestimmtes Ereignis eintritt, etwa ein neues Ticket, eine bezahlte Rechnung oder ein geänderter Kundendatensatz.

Auch: Web-Hook, HTTP-Callback, Push-Benachrichtigung, Event-Benachrichtigung

Die meisten Schnittstellen funktionieren wie ein Schalter, an dem man fragen muss. Wer wissen will, ob im Webshop eine neue Bestellung eingegangen ist, schickt eine Anfrage an dessen API und bekommt eine Antwort, gegebenenfalls „nichts Neues“. Ein Webhook dreht die Richtung um. Man hinterlegt im Webshop eine Internetadresse und sagt: „Wenn eine Bestellung eingeht, schick sie dorthin.“ Ab dann meldet sich der Shop von selbst, in dem Moment, in dem es passiert.

Technisch ist ein Webhook unspektakulär: eine gewöhnliche HTTP-Anfrage, meist mit der Methode POST, deren Inhalt das Ereignis beschreibt, in der Regel als JSON. Das empfangende System nimmt sie an, bestätigt den Eingang mit einem Statuscode aus dem 200er-Bereich und verarbeitet sie. Der Name ist eine Anspielung auf den „Haken“, an den man eigene Logik hängt.

Warum man sie dem ständigen Nachfragen vorzieht

Die Alternative zum Webhook heißt Polling: in festen Abständen nachfragen. Das hat zwei Nachteile, die sich gegenseitig verstärken. Fragt man selten, kommen Ereignisse verspätet an. Ein Kundenticket, das erst beim nächsten Abfragezyklus in einer halben Stunde bemerkt wird, wartet eine halbe Stunde, ohne dass jemand etwas dafür kann. Fragt man oft, erzeugt man viele Anfragen, die fast alle leer zurückkommen, und stößt schneller an die Abfragegrenzen, die Anbieter für ihre APIs setzen.

Webhooks lösen beides, solange das sendende System sie anbietet. In vielen gängigen CRM-, Shop-, Zahlungs- und Ticketsystemen ist das inzwischen der Fall; bei älterer ERP-Software und Branchenlösungen fehlt es oft. Integrationsplattformen wie n8n, Make, Zapier oder Microsoft Power Automate stellen für eingehende Webhooks eigene Auslöser bereit, die eine Adresse erzeugen und jeden Aufruf als Start eines Ablaufs behandeln.

Ein typischer Ablauf

Ein konstruiertes Beispiel: Im Ticketsystem geht eine Kundenanfrage ein. Das Ticketsystem schickt einen Webhook mit Ticketnummer, Absender und Betreff an eine Automatisierung. Diese holt sich über die API den vollständigen Text, lässt ein Sprachmodell Anliegen und Dringlichkeit bestimmen, sucht den Kunden im CRM und schreibt Kategorie und zuständiges Team zurück ins Ticket. Für den Kunden wirkt es, als hätte jemand sofort sortiert. Das ist im Kern Ticket-Routing.

An diesem Beispiel sieht man auch, wie Webhook und API sich die Arbeit teilen. Der Webhook trägt oft nur das Nötigste, häufig nur die Nachricht „Ticket 4711 hat sich geändert“. Die Daten selbst holt man danach aktiv. Das hat einen guten Grund: Was man über die API abruft, ist garantiert der aktuelle Stand, während eine Benachrichtigung schon wieder veraltet sein kann, wenn sie verzögert ankommt.

Was im Betrieb schiefgeht

Webhooks sind leicht eingerichtet und schwer zuverlässig zu betreiben. Fast alle Probleme gehen auf eine Tatsache zurück: Der Absender schickt und hofft.

Der Empfänger ist nicht erreichbar. Ist die Automatisierung gerade gestört oder wird sie aktualisiert, läuft die Benachrichtigung ins Leere. Seriöse Absender wiederholen die Zustellung mehrfach mit wachsenden Abständen. Die Spezifikation von Standard Webhooks, einer herstellerübergreifenden Initiative für einheitliche Webhooks, beschreibt einen solchen Zeitplan mit exponentiell steigenden Pausen über mehrere Tage. Darauf verlassen kann man sich nicht: Manche Anbieter versuchen es nur wenige Male, andere gar nicht. Was dann verloren ist, fällt niemandem auf. Deshalb gehört zu jedem wichtigen Webhook ein Abgleich, der in Abständen prüft, ob etwas fehlt.

Die Antwort dauert zu lange. Absender warten nur kurz auf die Bestätigung. GitHub etwa verlangt eine Antwort mit 200er-Code innerhalb von zehn Sekunden und bricht die Verbindung sonst ab. Wer im selben Aufruf noch ein Sprachmodell befragt und drei Systeme aktualisiert, überschreitet das leicht, und der Absender wertet die Zustellung als gescheitert, obwohl sie ankam. Die übliche Bauweise: den Eingang sofort bestätigen, das Ereignis in eine Warteschlange legen und danach in Ruhe verarbeiten.

Dieselbe Nachricht kommt zweimal. Weil Absender bei Zweifeln wiederholen, muss der Empfänger mit Doppelungen rechnen. Ohne Vorkehrung legt eine Automatisierung dann zwei Aufträge an oder verschickt zwei Mails. Die Gegenmaßnahme heißt im Fachjargon idempotenter Empfänger: Jede Nachricht trägt eine eindeutige Kennung, der Empfänger merkt sich, welche er schon verarbeitet hat, und ignoriert Wiederholungen. Standard Webhooks sieht dafür den Header webhook-id ausdrücklich als solchen Schlüssel vor.

Die Reihenfolge stimmt nicht. Zwei schnell aufeinanderfolgende Änderungen können vertauscht ankommen. Wer blind die zuletzt eingetroffene übernimmt, überschreibt unter Umständen den neueren Stand mit dem älteren. Auch hier hilft es, bei Eingang den aktuellen Stand über die API nachzuladen.

Wer darf eigentlich anrufen

Die Adresse eines Webhooks ist öffentlich erreichbar, sonst könnte der Absender sie nicht aufrufen. Damit kann sie im Prinzip jeder aufrufen, der sie kennt, und gefälschte Ereignisse einschleusen: eine angebliche Zahlung, eine angebliche Stornierung.

Die übliche Absicherung ist eine Signatur. Absender und Empfänger teilen ein Geheimnis. Der Absender berechnet aus Nachricht und Geheimnis eine Prüfsumme nach dem HMAC-Verfahren (RFC 2104) und schickt sie mit; der Empfänger rechnet nach und verwirft alles, was nicht passt. Standard Webhooks bezieht dabei auch Kennung und Zeitstempel der Nachricht in die Signatur ein, damit eine abgefangene Nachricht nicht später erneut eingespielt werden kann. Zusätzlich empfiehlt sich, nur verschlüsselte Verbindungen (HTTPS) zu akzeptieren und Ereignisse auf das zu beschränken, was der Ablauf wirklich braucht. GitHub rät ausdrücklich, nur die benötigten Ereignistypen zu abonnieren.

Was man vor dem Einsatz klären sollte

Bei der Auswahl oder Prüfung eines Systems lohnt es sich, nicht nur zu fragen, ob es Webhooks gibt, sondern wie sie sich verhalten:

  • Für welche Ereignisse gibt es Webhooks, und fehlt eines, das der Ablauf braucht?
  • Werden Nachrichten signiert, und wie wird das Geheimnis verwaltet?
  • Wie oft und über welchen Zeitraum wird eine gescheiterte Zustellung wiederholt?
  • Gibt es ein Protokoll der Zustellungen und die Möglichkeit, verpasste Nachrichten erneut auszulösen?
  • Was steht im Inhalt: das ganze Objekt oder nur ein Verweis darauf?

Auf der eigenen Seite gehört zu jedem Webhook eine klare Regel, was bei einer unverarbeitbaren Nachricht geschieht. Sie einfach zu verwerfen ist die schlechteste Wahl. Besser ist, sie aufzubewahren, jemanden zu benachrichtigen und sie nach der Korrektur erneut einzuspielen. Das ist der Gegenstand der Ausnahmebehandlung.

Quellen

  1. Standard Webhooks Specification, Standard Webhooks
  2. Best practices for using webhooks, GitHub Docs
  3. RFC 2104: HMAC: Keyed-Hashing for Message Authentication, Internet Engineering Task Force (IETF), 1997
  4. Idempotent Receiver, Gregor Hohpe, Bobby Woolf: Enterprise Integration Patterns

Inhaltlich geprüft im Oktober 2026. Der Eintrag erklärt einen Begriff und ersetzt keine Rechts- oder Steuerberatung.

Welcher Prozess kostet Ihr Team jeden Tag unnötig Zeit?

Bringen Sie einen konkreten Ablauf mit. In 45 Minuten klären wir, ob sich seine Automatisierung rechnet und was der nächste Schritt wäre.

Direkt mit einem Gründer · unverbindlich · ohne Verkaufsshow

Erst ein Prozess.
Dann der nächste.