CONVIRO
Engineering

Was ist ein Webhook? Chatbot-Webhooks einfach erklärt für Nicht-Entwickler

Ein Webhook ist eine automatische Nachricht, die eine App an eine andere sendet, sobald etwas passiert. So funktionieren Chatbot-Webhooks, so unterscheiden sie sich von einer API…

Conviro
15. September 20267 Min. Lesezeit
Was ist ein Webhook? Chatbot-Webhooks einfach erklärt für Nicht-Entwickler
In diesem Artikel

Was ist ein Webhook? Ein Webhook ist eine automatische Nachricht, die eine App an eine andere sendet, sobald etwas passiert, zum Beispiel wenn Ihr Chatbot einen neuen Lead erfasst. Statt dass Ihre anderen Tools alle paar Minuten fragen „Gibt es was Neues?“, sagt der Chatbot ihnen sofort Bescheid.

Stellen Sie es sich vor wie den Unterschied zwischen einem stündlichen Gang zum Briefkasten und einer Türklingel. Die Klingel läutet nur, wenn tatsächlich jemand vor der Tür steht.

Im Folgenden: wie Chatbot-Webhooks funktionieren, wie sie sich von einer API unterscheiden, welche Events sich lohnen und wie Sie sie absichern.

Das Wichtigste in Kürze

  • Ein Webhook schickt Daten an ein anderes System, wenn ein Event eintritt; eine API rufen Sie meist selbst auf, um Daten abzuholen.
  • Nützliche Chatbot-Webhooks werden bei geschäftlichen Events ausgelöst, etwa bei einem neuen Lead, einer Übergabe an einen Mitarbeiter oder einer abgeschlossenen Konversation.
  • HMAC-Signaturen belegen, dass eine Nachricht echt ist, und Wiederholungsversuche sorgen dafür, dass ein kurzer Ausfall keine Daten kostet.

Was ist ein Webhook, einfach erklärt?

Ein Webhook besteht aus drei Teilen:

  1. Ein Event: In der Quell-App passiert etwas, etwa ein Besucher hinterlässt im Chat seine E-Mail-Adresse.
  2. Eine URL: die Adresse des empfangenden Systems, oft Endpoint genannt. Sie fügen sie in die Einstellungen der Quell-App ein.
  3. Ein Payload: ein kleines Datenpaket, meist im JSON-Format, das beschreibt, was passiert ist.

Tritt das Event ein, sendet die Quell-App den Payload an diese URL. Das empfangende System liest ihn und tut etwas Sinnvolles: einen Kontakt anlegen, eine Benachrichtigung posten, eine Zeile in einer Tabelle ergänzen. Niemand muss einen Button drücken oder ein Skript schreiben, das nach Änderungen sucht.

Auch die Empfangsseite müssen Sie nicht selbst bauen. Automatisierungsplattformen wie Zapier, Make und n8n erzeugen mit wenigen Klicks eine Webhook-URL für Sie, und genau deshalb können auch Nicht-Entwickler Webhooks nutzen.

Webhook vs. API: Was ist der Unterschied?

Beides wird oft als Konkurrenz betrachtet, funktioniert aber als Paar. Eine API (Application Programming Interface, Programmierschnittstelle) ist eine Reihe von Türen in eine App, an die Sie klopfen, um Daten zu lesen oder zu ändern. Ein Webhook ist die App, die an Ihre Tür klopft, wenn etwas passiert.

Ohne Webhooks erfahren Sie von neuen Events nur durch Polling: Sie fragen die API immer wieder, ob sich etwas geändert hat.

Webhook (Push) API-Polling (Pull)
Wer startet Die Quell-App, wenn ein Event eintritt Ihr System, nach Zeitplan
Geschwindigkeit Nahezu in Echtzeit So schnell wie Ihr Abfrageintervall
Am besten für Benachrichtigungen, Synchronisieren neuer Datensätze, Workflows starten Massenexporte, Berichte, Abfragen bei Bedarf
Einrichtung URL einfügen, Events auswählen Skript oder geplanten Job schreiben
Hauptrisiko Verpasste Nachrichten, wenn der Empfänger ausfällt (durch Wiederholungen abgefangen) Verzögerungen, unnötige Anfragen, Rate Limits

Viele Integrationen nutzen beides. Ein Webhook meldet „Konversation 123 wurde gerade übergeben“, und das empfangende System ruft dann die API auf, falls es weitere Details braucht.

Chatbot-Webhooks: Beispiel-Events, die sich lohnen

Die besten Chatbot-Webhooks bilden Momente ab, die Ihrem Team ohnehin wichtig sind. Drei gängige Beispiele:

Neuer Lead erfasst

Ein Besucher teilt seine Kontaktdaten und beantwortet ein oder zwei Qualifizierungsfragen. Typische Anwendungen: einen CRM-Kontakt anlegen oder aktualisieren, Ihren Vertriebskanal benachrichtigen oder den Lead (mit Einwilligung) in eine Nurturing-Liste aufnehmen. Weil schnelle Antworten auf neue Leads mehr Abschlüsse bringen, ist das meist der erste Webhook, den Teams einrichten.

Konversation an einen Mitarbeiter übergeben

Der Assistent hat entschieden, dass ein Mensch übernehmen sollte, oder der Kunde hat danach gefragt. Typische Anwendungen: den diensthabenden Mitarbeiter benachrichtigen, ein Helpdesk-Ticket öffnen oder einen Priority-Account markieren. Der Payload sollte den Kontext enthalten, auf den Ihr Prozess für die Übergabe vom Chatbot an einen Mitarbeiter angewiesen ist, etwa Anliegen, Tags und Kontaktdaten.

Konversation abgeschlossen

Eine Konversation ist beendet, gelöst von der KI oder von einem Mitarbeiter. Typische Anwendungen: für Berichte protokollieren, ein Dashboard aktualisieren oder eine Folgeaufgabe anlegen.

Eine einfache Regel: Abonnieren Sie nur Events, auf die Sie auch reagieren. Jeder Webhook, den Sie aktivieren, ist eine weitere Sache, die überwacht werden muss.

Webhook-Sicherheit: Signaturen, Wiederholungen und Zustellungsverfolgung

Eine Webhook-URL ist nur eine Adresse im Internet. Was hindert jemanden daran, gefälschte „Neuer Lead“-Nachrichten dorthin zu schicken? Und was passiert, wenn Ihr Server zehn Minuten ausfällt? Drei Schutzmechanismen beantworten diese Fragen.

HMAC-Signaturen. Sender und Empfänger teilen einen geheimen Schlüssel. Der Sender berechnet aus Payload und Schlüssel eine Signatur und schickt sie mit jeder Anfrage mit. Der Empfänger berechnet sie neu und lehnt alles ab, was nicht übereinstimmt, sodass gefälschte oder manipulierte Nachrichten scheitern.

Wiederholungsversuche. Bestätigt der Empfänger die Zustellung nicht, versucht es der Sender später erneut, meist mit wachsenden Abständen zwischen den Versuchen. Ein kurzer Ausfall bedeutet keinen Datenverlust.

Circuit Breaker und Zustellungsverfolgung. Schlägt ein Endpoint immer wieder fehl, pausiert ein Circuit Breaker die Zustellungen eine Weile, statt einen defekten Server weiter zu bombardieren. Zustellungsprotokolle zeigen, was gesendet wurde und ob es ankam, sodass Sie Fehler ohne Rätselraten finden.

Auf der Empfangsseite verhindern ein paar Gewohnheiten die meisten Probleme:

  • Prüfen Sie die Signatur, bevor Sie die Daten verwenden.
  • Antworten Sie schnell mit einem Erfolgscode und erledigen Sie aufwendige Arbeit im Hintergrund.
  • Rechnen Sie mit Duplikaten: Ein Wiederholungsversuch kann dasselbe Event zweimal zustellen, nutzen Sie also die Event-ID, um Wiederholungen zu überspringen.
  • Verwenden Sie ausschließlich HTTPS-Endpoints.
  • Leiten Sie nur die personenbezogenen Daten weiter, die das empfangende Tool braucht; die DSGVO-Regeln für KI-Chatbots gelten auch, wenn Daten den Chat verlassen.

So setzt Conviro Webhooks in Echtzeit um

Conviro bietet Webhooks in Echtzeit. Events erreichen Ihren Endpoint, sobald sie eintreten, mit HMAC signiert, damit Sie jede Anfrage prüfen können, bei fehlgeschlagener Zustellung automatisch wiederholt und durch einen Circuit Breaker geschützt. Die Zustellungsverfolgung zeigt, was gesendet wurde und ob es angekommen ist.

Richten Sie diese Webhooks auf Ihren eigenen Code oder auf ein No-Code-Tool: Conviro lässt sich auch mit Zapier, Make und n8n verbinden und bietet eine REST-API mit Bearer-Token-Authentifizierung und Schlüsseln mit begrenzten Berechtigungen, um Daten bei Bedarf abzurufen. All das ist ab dem Pro-Tarif verfügbar. Die Entwicklerdokumentation beschreibt Payloads und Signaturprüfungen, und die Seite zu Automatisierungsintegrationen zeigt die No-Code-Wege.

Häufig gestellte Fragen

Was ist ein Webhook, einfach erklärt?

Ein Webhook ist eine automatische Benachrichtigung, die eine App an eine andere sendet, wenn ein bestimmtes Event eintritt. Sie geben der Quell-App eine URL, wählen die Events aus, und die App sendet jedes Mal ein kleines Datenpaket an diese URL. Das funktioniert wie eine Türklingel für Software: Das empfangende System erfährt sofort von Änderungen, statt wiederholt nachzusehen.

Brauche ich einen Entwickler, um Webhooks zu nutzen?

Nicht immer. Automatisierungsplattformen wie Zapier, Make und n8n erzeugen eine Webhook-URL für Sie und lassen Sie eingehende Daten in einem visuellen Editor Aktionen zuordnen. Ein Entwickler wird nützlich, wenn Sie einen eigenen Endpoint bauen, Signaturen im Code prüfen oder ein internes System ohne fertigen Connector anbinden.

Ist ein Webhook schneller als eine API?

Um von neuen Events zu erfahren, ja. Ein Webhook kommt wenige Augenblicke nach dem Event an, während Polling über eine API nur so schnell ist, wie oft Sie nachfragen. Für historische Daten oder zusätzliche Details ist die API das richtige Werkzeug. Die meisten gut gebauten Integrationen nutzen Webhooks zum Benachrichtigen und die API zum Nachschlagen.

Was passiert, wenn mein Webhook-Endpoint nicht erreichbar ist?

Das hängt vom Sender ab. Gute Webhook-Systeme wiederholen fehlgeschlagene Zustellungen über einen gewissen Zeitraum, sodass kurze Ausfälle keine Daten kosten, und manche pausieren die Zustellung an einen Endpoint, der wiederholt fehlschlägt. Prüfen Sie, ob Ihr Anbieter Wiederholungen unterstützt, und stellen Sie sicher, dass Ihr Endpoint dasselbe Event problemlos zweimal verarbeiten kann.

Nächste Schritte

Wählen Sie ein Event, auf das Sie schon heute reagieren würden, meist neue Leads, und verbinden Sie es mit dem Tool, in dem Ihr Team bereits arbeitet. Läuft das zuverlässig, ergänzen Sie Übergaben und abgeschlossene Konversationen. Starten Sie kostenlos mit Conviro, um Ihren Assistenten einzurichten, und wechseln Sie zum Pro-Tarif, wenn Sie Webhooks anbinden möchten.

Teilen:

Veröffentlicht von

Conviro

Teilt Erkenntnisse zu KI-gestütztem Kundenservice, Chatbot-Automatisierung und SaaS-Wachstumsstrategien.

Auf Conviro aufbauen

Verbinden Sie Konversations-Workflows mit Ihrem Tech-Stack

Prüfen Sie Entwicklerressourcen und Integrationsmuster, bevor Sie die Implementierung planen.

Ähnliche Artikel

Mehr Beiträge