Glossar

Webhook

Ein Webhook ist eine automatische Nachricht, die ein System an eine festgelegte Internetadresse sendet, sobald ein bestimmtes Ereignis eintritt.

  • Auch: HTTP-Callback, Ereignisbenachrichtigung
Auf dieser Seite
  1. In der Praxis
  2. Ein Beispiel
  3. Häufiges Missverständnis
  4. Bei Call0

Anders als bei einer API-Abfrage muss das empfangende System nicht regelmäßig nachfragen. Es wird benachrichtigt, wenn etwas passiert. In der KI-Telefonie sind typische Ereignisse: Anruf beendet, Termin gebucht, Rückruf gewünscht. Die Nachricht enthält die Daten des Ereignisses, meist im Format JSON, zum Beispiel Rufnummer, Zusammenfassung und erkanntes Anliegen.

Mit Webhooks lassen sich Abläufe anstoßen, ohne dass es eine fertige Integration braucht: einen Eintrag im CRM anlegen, eine Nachricht im Team-Chat senden oder einen Ablauf in einem Automatisierungswerkzeug starten. Für den sicheren Betrieb sollte der Empfänger prüfen, ob die Nachricht wirklich vom erwarteten Absender stammt, etwa über eine Signatur, und mit Wiederholungen umgehen können, falls eine Nachricht doppelt ankommt.

In der Praxis

Du trägst beim sendenden System eine Adresse ein, an die Ereignisse geschickt werden, und wählst aus, welche Ereignisse dich interessieren. Auf der Empfängerseite steht entweder ein eigenes kleines Programm oder ein Automatisierungswerkzeug, das die Nachricht entgegennimmt und weiterverarbeitet. Zum Testen löst du ein Ereignis aus, zum Beispiel mit einem Probeanruf, und siehst dir die ankommenden Daten an. Bestätige den Empfang schnell und erledige längere Arbeit erst danach. Viele Absender werten eine langsame Antwort als Fehler und senden dieselbe Nachricht erneut.

Ein Beispiel

Ein Sanitätshaus möchte, dass jeder Rückrufwunsch sofort im Team-Chat erscheint. Es richtet einen Webhook für das Ereignis „Anruf beendet“ ein. Nach jedem Gespräch geht eine Nachricht mit Rufnummer, Zusammenfassung und Anliegen an ein Automatisierungswerkzeug. Dieses prüft, ob ein Rückruf gewünscht ist, und schreibt in den Kanal der Kundenberatung, wer angerufen hat, worum es geht und bis wann der Rückruf zugesagt wurde. Niemand muss dafür eine Anrufliste öffnen.

Häufiges Missverständnis

Webhook und API werden häufig verwechselt. Mit einer API fragst du etwas ab oder löst etwas aus, wann du willst. Ein Webhook meldet sich von selbst, wenn etwas passiert ist. Unterschätzt wird, dass die Adresse eines Webhooks öffentlich erreichbar ist. Ohne Prüfung der Signatur könnte jeder, der sie kennt, erfundene Ereignisse schicken. Und weil Nachrichten verloren gehen oder doppelt ankommen können, darf ein Ablauf nicht davon abhängen, dass jede genau einmal eintrifft.

Bei Call0

Call0 bietet Webhooks und eine API. Beides ist in der Dokumentation beschrieben.

API-Dokumentation