Das Tool steht für alle Kanäle zur Verfügung: Chat, Telefon und E-Mail.
Nicht verwechseln mit der HTTP-Anfrage in Automationen. In Automationen ist die HTTP-Anfrage ein Schritt im Ablauf, der zu einem festen Zeitpunkt läuft. Das Tool hier gehört zum KI-Agenten selbst: Er entscheidet während der Unterhaltung, ob und wann er die Anfrage stellt, und arbeitet mit der Antwort weiter.
Voraussetzungen: ein KI-Agent in Superchat und eine API, die du aufrufen möchtest (URL, Methode, ggf. Zugangsdaten).
Tool hinzufügen
Öffne deinen KI-Agenten und wechsle links in den Bereich Tools & Aktionen.
Klicke oben rechts auf Tool hinzufügen.
Wähle die Karte HTTP-Anfragen und klicke auf Hinzufügen.
Es öffnet sich der Editor für das Tool mit sechs Reitern: Allgemein, Parameter, Anfrage, Body, Zugangsdaten und Test.
Allgemein: Name und Einsatzregel
Tool-Name: Ein kurzer Name, der beschreibt, was das Tool macht, z. B. „Bestellstatus abfragen“ oder „Termin anlegen“. Der Name erscheint in der Liste unter Tools & Aktionen.
Wann soll der Agent das Tool nutzen? Diese Beschreibung ist die wichtigste Stelle im Tool. Der KI-Agent entscheidet anhand dieses Textes, ob er die Anfrage stellt. Beschreibe konkret, in welcher Situation er das Tool nutzen soll, was er in der Antwort findet und wie er sie verwenden soll. Nenne auch, wann er es nicht nutzen soll.
Beispiel: „Nutze dieses Tool, wenn der Kunde nach dem Status seiner Bestellung fragt. In der Antwort findest du den aktuellen Status und das voraussichtliche Lieferdatum, die du dem Kunden nennst. Nutze das Tool nicht, wenn der Kunde keine Bestellnummer genannt hat.“
Parameter: Welche Werte der Agent liefert
Parameter sind die Werte, die sich von Anfrage zu Anfrage ändern, etwa eine Bestellnummer oder die Telefonnummer des Kontakts. Du legst sie hier fest und setzt sie anschließend über den { }-Button in URL, Query-Parameter, Header oder Body ein.
Klicke auf Hinzufügen und fülle pro Parameter aus:
Name: Der Name, unter dem du den Wert später einsetzt.
Quelle: Woher der Wert kommt.
KI-Agent: Der Agent entnimmt den Wert der Unterhaltung, z. B. eine Bestellnummer, die der Kunde nennt.
Kontaktattribut: Der Wert kommt aus den bestehenden Daten des Kontakts in Superchat, z. B. die Kundennummer.
Typ: Datentyp des Werts, z. B. Text.
Beschreibung: Was der Wert ist und woher er kommt. Bei Quelle „KI-Agent“ hilft die Beschreibung dem Agenten, den richtigen Wert aus dem Gespräch zu ziehen.
Pflicht: Ob die Anfrage den Wert zwingend braucht.
Die Spalte Verwendung zeigt, ob der Parameter bereits an beliebiger Stelle in der Anfrage eingesetzt ist. Steht dort „Nicht verknüpft“, wird der Wert noch nirgends mitgeschickt.
Tipp zu „Pflicht“: Deaktiviere „Pflicht“ bei allem, was aus der Unterhaltung kommt. Ist der Wert nicht verfügbar, lässt der Agent das Feld einfach weg, statt die Anfrage zu blockieren oder den Kunden unnötig zu fragen.
Anfrage: Methode, URL, Query-Parameter und Header
Methode & URL: Wähle links die HTTP-Methode (z. B. POST) und trage rechts die URL deiner API oder deines Webhooks ein.
Query-Parameter: Name-Wert-Paare, die an die URL angehängt werden. Über Hinzufügen legst du weitere an.
Header: Name-Wert-Paare für HTTP-Header, z. B.
Content-Type. Zugangsdaten gehören nicht hierhin, sondern in den Reiter Zugangsdaten.Zeitlimit: Sekunden, nach denen die Anfrage abgebrochen wird (Standard: 30). Am Telefon wartet der Anrufer währenddessen; halte den Wert so niedrig, wie deine API es zulässt.
In allen Feldern kannst du über den { }-Button einen Parameter einsetzen.
Body: Inhalt der Anfrage
Wähle, was die Anfrage mitschickt:
Kein Body: Die Anfrage schickt keinen Inhalt. Passend für einfache Abfragen.
JSON: Strukturierte Daten, der Standard für die meisten APIs und Webhooks.
Formulardaten: Klassische Formularfelder.
Reiner Text: Ein freier Textinhalt.
Auch hier setzt du Parameter über { } ein, z. B. {"bestellnummer": {{bestellnummer}}}.
Zugangsdaten: API sicher authentifizieren
Benötigt deine API einen API-Key oder ein Token, hinterlegst du ihn hier. Wähle im Dropdown vorhandene Zugangsdaten aus oder klicke auf Neue Zugangsdaten erstellen. Einmal angelegte Zugangsdaten stehen dir für weitere Tools wieder zur Verfügung.
Die Zugangsdaten werden sicher gespeichert. Der KI-Agent sieht oder setzt diese Werte nie, er kann sie also auch nicht versehentlich im Gespräch preisgeben.
Test: Anfrage einmal echt ausführen
Bevor du speicherst, prüfe die Anfrage im Reiter Test. Trage für jeden Parameter einen Beispielwert ein und klicke auf „Testanfrage senden“. Die Anfrage geht dabei wirklich an deine API, nutze also Testdaten.
Der Hinweis „Es werden nirgends Parameter verwendet: dieses Tool ruft immer dieselbe Anfrage auf“ bedeutet, dass du Parameter angelegt, aber nirgends über { } eingesetzt hast, oder dass das Tool ganz ohne Parameter arbeitet. Für eine feste Abfrage ist das in Ordnung; sobald der Agent Werte aus dem Gespräch mitschicken soll, setze sie in URL, Header oder Body ein.
Klicke danach auf Speichern. Das Tool erscheint in der Liste unter Tools & Aktionen als HTTP-Anfragen: <Name>.
Im Gespräch testen
Öffne rechts die Testumgebung, wähle den Kanal (Chat, Telefon oder E-Mail) und stelle deinem KI-Agenten die Frage, die das Tool auslösen soll. So siehst du, ob er das Tool zum richtigen Zeitpunkt nutzt und die Antwort sinnvoll verwendet.
Nutzt der Agent das Tool nicht, schärfe zuerst den Text unter Wann soll der Agent das Tool nutzen? und erwähne das Tool zusätzlich in Aufgabe & Regeln unter „Was soll dein Agent tun?“, z. B.: „Wenn ein Kunde nach seiner Bestellung fragt, frage den Bestellstatus über das Tool ab und nenne ihm Status und Lieferdatum.“
Wichtig: In der Testumgebung werden keine Kontaktattribute geteilt. Es ist in der Testumgebung nur möglich, mit Parametern zu arbeiten, die der Agent aus der aktuellen Konversation zieht. Nutze eine echte Konversation, von dir selbst ausgelöst, um mit Kontaktattributen zu testen.
Best Practices
Einsatzregel positiv und negativ formulieren. Wann ja, wann nein.
Antworten schlank halten. Der Agent liest die Antwort deiner API. Je klarer und kürzer sie ist, desto präziser wird seine Aussage gegenüber dem Kunden.
Zeitlimit möglichst niedrig halten. Jede Sekunde Wartezeit bekommt der Kontakt mit. Am Telefon empfehlen wir bestenfalls 10 Sekunden und im Chat 30 Sekunden.
Mit Testdaten testen. Die Testanfrage und Tests in der Testumgebung rufen deine API wirklich auf.