Glossar

Webhook

Ein Webhook meldet ein Ereignis aus einem Programm automatisch an ein anderes und löst dort einen Ablauf aus, etwa bei einer neuen Anfrage oder einem Auftragsstatus.

Ein Webhook ist eine automatische Benachrichtigung von Programm zu Programm. Tritt in einem System ein bestimmtes Ereignis ein, sendet es unaufgefordert eine Nachricht an eine zuvor hinterlegte Adresse, und das empfangende System startet daraufhin einen Ablauf. Der Unterschied zu einer klassischen API-Abfrage liegt in der Richtung: Statt regelmäßig nachzufragen, ob es etwas Neues gibt, wird man aktiv benachrichtigt.

Im Handwerksbetrieb sind die Auslöser typischerweise Ereignisse aus dem Tagesgeschäft. Ein Kontaktformular auf der Website wurde abgeschickt, ein Auftrag hat den Status “abgeschlossen” erreicht, ein Monteur hat einen Einsatz auf dem Tablet quittiert, eine Rechnung wurde als bezahlt markiert, ein Termin wurde verschoben. Jedes dieser Ereignisse kann eine Kette anstoßen: Anfrage einem Gewerk zuordnen und ins CRM legen, nach Abschluss eine Bitte um eine Bewertung versenden, bei quittiertem Einsatz die Rechnung vorbereiten.

Praktisch aufgebaut werden solche Ketten meist nicht mit eigener Programmierung, sondern über eine Integrationsplattform oder ein Automatisierungswerkzeug, das den Webhook empfängt und die weiteren Schritte grafisch abbildet. Das macht den Aufbau auch für Betriebe ohne IT-Abteilung erreichbar.

Wichtig ist die Reihenfolge beim Aufbau. Zuerst wird festgelegt, welches Ereignis eine Kette auslösen soll und welches Ergebnis am Ende stehen muss; erst danach wird die Technik eingerichtet. Wer umgekehrt vorgeht und ausprobiert, was sich alles verbinden lässt, endet mit einer Sammlung halbfertiger Abläufe, die niemand mehr überblickt. Ebenso gehört zu jeder Kette die Frage, wer bemerkt, wenn sie nicht mehr läuft.

Wo KI ansetzt

Webhooks sind der übliche Einstiegspunkt, wenn ein Sprachmodell in einen Ablauf eingebunden werden soll. Die eingehende Formularnachricht wird an das Modell übergeben, das daraus Anliegen, Dringlichkeit und benötigtes Gewerk ableitet und einen Antwortentwurf erzeugt. Danach läuft die Kette weiter: Vorgang anlegen, Entwurf zur Freigabe vorlegen, bei Notfällen sofort benachrichtigen. Ohne Webhook müsste jemand den Posteingang beobachten und den Anstoß von Hand geben.

Zwei Punkte sind zu beachten. Erstens sollten Webhook-Adressen als vertraulich behandelt werden, weil sie von außen aufrufbar sind und Betriebsdaten transportieren. Zweitens braucht jede Kette eine Fehlerbehandlung: Was passiert, wenn das Zielsystem nicht antwortet oder ein Feld leer ist. Ohne diese Regel verschwinden Anfragen unbemerkt.

Praktisch zu beachten ist die Fehlerbehandlung. Erreicht ein Webhook das Zielsystem nicht, etwa weil dieses gerade nicht verfügbar ist, geht die Meldung ohne Wiederholmechanismus verloren. Ein Vorgang bleibt dann stillschweigend liegen, und niemand bemerkt es, weil auch keine Fehlermeldung erscheint. Vor dem produktiven Einsatz sollte deshalb geklärt sein, ob der Absender Zustellversuche wiederholt und wo fehlgeschlagene Meldungen sichtbar werden.

Praktischer Hinweis: Jede eingerichtete Kette sollte mit einem Testvorgang und einem bewusst fehlerhaften Vorgang geprüft werden. Erst das zweite Ergebnis zeigt, ob die Automatisierung im Alltag trägt. Einen Einstieg gibt der Ratgeber n8n im Handwerk.

FAQ

Häufige Fragen zu Webhook

Welche Ereignisse eignen sich im Handwerksbetrieb?
Solche aus dem Tagesgeschäft: ein abgeschicktes Kontaktformular, ein Auftrag, der den Status abgeschlossen erreicht, ein auf dem Tablet quittierter Einsatz, eine als bezahlt markierte Rechnung, ein verschobener Termin. Jedes davon kann eine Kette anstoßen, etwa die Anfrage zuordnen, eine Bewertungsbitte versenden oder die Rechnung vorbereiten.
Brauche ich dafür Programmierkenntnisse?
In der Regel nicht. Solche Ketten werden meist über eine Integrationsplattform oder ein Automatisierungswerkzeug aufgebaut, das den Webhook empfängt und die weiteren Schritte grafisch abbildet. Das macht den Aufbau auch für Betriebe ohne IT-Abteilung erreichbar, verlagert die Abhängigkeit aber auf die gewählte Plattform.
Was ist der Unterschied zu einer API-Abfrage?
Die Richtung. Bei einer Abfrage fragt ein System regelmäßig nach, ob es etwas Neues gibt, was Verzögerung und unnötige Last erzeugt. Beim Webhook meldet sich das auslösende System selbst, sobald das Ereignis eintritt. Für zeitnahe Reaktionen wie eine Eingangsbestätigung ist das der praktikablere Weg.
Was ist beim Betrieb zu beachten?
Dass Ausfälle unbemerkt bleiben können. Kommt eine Meldung nicht an, geschieht schlicht nichts, ohne Fehlermeldung an den Betrieb. Sinnvoll sind eine Benachrichtigung bei Fehlern, eine regelmäßige Sichtprüfung und eine kurze Notiz je Ablauf mit Auslöser, beteiligten Systemen und Zuständigkeit im Störungsfall.

Bereit, KI in Ihrem Betrieb arbeiten zu lassen?

In einer kostenlosen KI-Potenzialanalyse zeigen wir konkret, wo in Ihrem Betrieb Zeit und Geld liegen – unverbindlich und ohne Technik-Kauderwelsch.

Kostenlose KI-Analyse