Zum Inhalt springen
Glossar

Webhook

Definition

Ein Webhook ist ein automatischer HTTP-Aufruf, den ein System auslöst, sobald ein bestimmtes Ereignis eintritt. Statt dass eine Anwendung regelmäßig nachfragt, ob es etwas Neues gibt, meldet sich die Quelle von selbst und schickt die Daten an eine vorher hinterlegte URL.

Der Unterschied zur klassischen API-Abfrage liegt in der Richtung. Beim Polling fragt dein System im Minutentakt nach, ob sich etwas geändert hat, und bekommt in den allermeisten Fällen ein Nein zurück. Beim Webhook passiert bis zum Ereignis gar nichts, dann kommt genau eine Nachricht. Das spart Aufrufe und verkürzt die Reaktionszeit von Minuten auf Sekunden.

In der Praxis hinterlegst du eine URL im Quellsystem und bekommst ab diesem Moment bei jedem passenden Ereignis einen HTTP-POST mit einem JSON-Body. Ein Formular wird abgeschickt, ein Deal wechselt die Phase, eine Zahlung geht ein: In jedem Fall startet der eingehende Aufruf einen Ablauf auf deiner Seite. In n8n ist der Webhook-Trigger der häufigste Einstiegspunkt in einen Workflow überhaupt.

Drei Dinge gehen dabei regelmäßig schief. Erstens gibt es keine Zustellgarantie: Ist der Empfänger im entscheidenden Moment nicht erreichbar, ist das Ereignis je nach Anbieter verloren. Zweitens werden Aufrufe doppelt zugestellt, weshalb die Verarbeitung idempotent sein muss, sonst legst du denselben Datensatz zweimal an. Drittens ist die Empfangs-URL öffentlich erreichbar. Ohne Signaturprüfung kann jeder, der die Adresse kennt, deinen Ablauf auslösen und mit erfundenen Daten füttern.

Für den Betrieb folgt daraus eine kurze Liste: Signatur oder Token bei jedem Aufruf prüfen, eingehende Ereignisse protokollieren, bevor sie verarbeitet werden, und einen Wiederholungspfad für fehlgeschlagene Verarbeitungen vorsehen. Webhooks sind der einfachste Integrationsmechanismus, den es gibt. Die Einfachheit endet allerdings genau bei der Zustellung.

Diese Technologie in der Praxis?

Sieh dir an, wie wir Technologien wie diese für Unternehmen einsetzen, oder sprich direkt mit uns.