Webhook-Aktionen: Ihre Support-KI erledigt Dinge für Kunden
Von Termi3 Min. Lesezeit
Bei vielen Support-Fragen muss etwas passieren: eine Bestellung prüfen, ein Backup starten, einen Key erneut senden. Eine KI, die nur antworten kann, gibt so etwas an einen Menschen weiter. Mit Aktionen ruft FiveBot dafür Ihren eigenen HTTPS-Endpunkt auf, im Hollo-Websitechat und in Discord-Tickets, und antwortet mit dem, was Ihr Server zurückgeschickt hat.
Ein Beispiel von FiveDock
FiveDock, ein Backup- und Hosting-Tool für FiveM-Server, nutzt FiveBot als Chat auf seiner Website. Ein angemeldeter Nutzer schreibt „Mach ein Backup von meinem Server“. Die KI weiß schon, welche Server dieser Nutzer hat, weil FiveDock sie beim Öffnen des Chats mitgibt, und fragt nach, welcher gemeint ist, wenn es mehrere gibt. Dann zeigt sie eine Karte mit dem Servernamen und dem Button „Ausführen“. Ein Klick, der Endpunkt von FiveDock startet das Backup, und der Chat meldet, dass es läuft.
Genauso funktioniert „Ist mein Server online?“ oder „Stell Kowalskis Inventar von gestern wieder her“.
Eine Aktion anlegen
Unter Einstellungen, KI, Aktionen können Sie bis zu 10 anlegen. Jede hat:
- einen Namen und einen Satz, wann sie gebraucht wird;
- die HTTPS-Adresse, die FiveBot aufruft;
- bis zu fünf typisierte Felder, etwa einen Servernamen oder eine Anzahl Stunden, die die KI aus dem Gespräch ausfüllt;
- „Ohne Nachfrage ausführen“ für harmlose Lesezugriffe wie eine Statusabfrage;
- einen Schalter zum Ein- und Ausschalten.
„Test senden“ schickt einen Beispielaufruf und zeigt den Statuscode und die Dauer. Die Seite zeigt außerdem die letzten 10 Aufrufe.
Wer eine Aktion auslösen kann
Aktionen laufen nur für Personen, die FiveBot identifizieren kann: einen Websitebesucher, den Ihre Website beim Öffnen des Chats signiert hat, oder die Person, die ein Discord-Ticket geöffnet hat. Anonyme Besucher und E-Mails bekommen Antworten aus Ihrer Wissensdatenbank und sonst nichts.
Die KI prüft die Felder gegen die Typen, die Sie festgelegt haben. Fehlt ein Wert, stellt sie eine kurze Frage und nennt die Auswahl. Läuft die Aktion nicht ohne Nachfrage, bekommt der Kunde eine Karte im Chat oder Buttons in Discord, mit „Ausführen“ und „Abbrechen“.
Was Ihr Endpunkt bekommt
Einen POST mit der Aktion, ihren Feldern, dem Nutzer und dem Ticket, signiert mit dem Signatur-Secret Ihres Workspace:
FiveBot-Signature: t=<unix time>,v1=<HMAC-SHA256 of t.body>
Die Einstellungsseite enthält ein Node-Snippet, das die Signatur prüft. FiveBot löst die Adresse zuerst auf und lehnt private und lokale Netze ab, folgt keinen Weiterleitungen, wartet höchstens 10 Sekunden und liest bis zu 16 KB der Antwort. Die Antwort gilt als Daten, Text darin kann der KI also keine neuen Anweisungen geben.
Kosten
Jeder Aufruf kostet zusätzlich zur Antwort einen KI-Credit und erscheint im Credit-Log als Aktionen. Jeder Aufruf wird mit seinem Ergebnis protokolliert.
Häufige Fragen
Welchen Plan brauche ich?
Pro oder Network. Die Preise stehen auf fivebot.ai/pricing.
Kann ein Kunde die KI dazu bringen, für jemand anderen zu handeln?
FiveBot nimmt den Nutzer aus der Signatur, die Ihre Website erstellt hat, oder aus dem Discord-Konto, das das Ticket geöffnet hat, und Ihr Endpunkt bekommt diese Identität bei jedem Aufruf mit. Angaben, die nach einem Versuch aussehen, der KI Anweisungen zu geben, werden verworfen.
Wie signiert meine Website einen Besucher?
Ihr Backend signiert den Besucher mit dem Hollo-Identitäts-Secret und gibt das Ergebnis an FiveBot.identify weiter. Mehr über Hollo.
Was ist der Unterschied zu Assistent-Aktionen?
Assistent-Aktionen sind für Sie und Ihr Team und lösen Events oder Befehle auf Ihrem FiveM-Server aus. Webhook-Aktionen sind für Ihre Kunden und rufen jeden HTTPS-Endpunkt auf, den Sie betreiben. Assistent-Aktionen.