Zum Hauptinhalt springen
Ein HTTP-Tool ist ein HTTP-Request, den der Assistent während einer Konversation aufrufen kann. Du definierst die Anfrage – Methode, URL, Header und Parameter – und der Assistent füllt die Parameter aus und ruft sie auf, wenn die Frage eines Shoppers passt. Ein typisches Beispiel ist das Nachschlagen des Bestellstatus aus deinem Backend und das Antworten mit dem Ergebnis.
HTTP-Tools werden auf Organisations-Ebene konfiguriert und anschließend den Assistenten zugeordnet, die sie nutzen sollen. Um API-Keys und OAuth aus der Anfrage herauszuhalten, richte zuerst Geheimnisse und Auth-Verbindungen ein.

​
Tool erstellen

1

Tools öffnen

Gehe in der Plattform zu Tools und wähle Neues Tool. Wähle HTTP Request oder starte mit einer Vorlage wie Sendungsverfolgung und passe sie an.
2

Tool benennen und beschreiben

Gib dem Tool unter Konfiguration einen klaren Namen (zum Beispiel Bestellstatus abfragen) und eine Beschreibung, wann es verwendet werden soll. Die Beschreibung hilft dem Assistenten zu entscheiden, wann das Tool relevant ist – sei also präzise.
3

Parameter definieren

Füge unter Parameter die Eingaben hinzu, die die Anfrage benötigt (etwa order_number). Verwende Namen in Kleinbuchstaben im snake_case-Format. Lege für jeden Parameter einen Datentyp und einen Werttyp fest: entweder einen Konstanten Wert, der bei jedem Aufruf gleich bleibt, oder einen Wert, den der Assistent aus dem Gespräch ausfüllt. Bei vom Assistenten ausgefüllten Werten kannst du außerdem beschreiben, wie er sie ermitteln soll.
4

HTTP-Request konfigurieren

Lege unter HTTP-Request fest:
  • Methode – GET, POST, PUT, PATCH oder DELETE.
  • URL – der aufzurufende Endpunkt. Nutze {parameter_name}-Platzhalter, um Parameter einzusetzen, z. B. https://api.example.com/orders/{order_number}.
  • JSON-Body (bei POST, PUT und PATCH) – eine JSON-Vorlage, die ebenfalls {parameter_name}-Platzhalter nutzen kann.
  • Authentifizierung – hänge eine Auth-Verbindung an, statt Anmeldedaten in die Anfrage zu schreiben.
  • Header (optional) – zusätzliche Request-Header als Name/Wert-Paare.
Du kannst auch den Request-Timeout anpassen (die maximale Wartezeit auf die Antwort der externen API).
5

Antwortfelder auswählen (optional)

Lege unter Antwortfelder fest, welche Felder aus der JSON-Response an den Assistenten weitergegeben werden. Ohne Auswahl erhält der Assistent die gesamte Response.
6

Tool testen

Wähle Tool testen, gib Beispiel-Parameterwerte ein und führe es aus.
Die Anfrage liefert den erwarteten Status und die erwarteten Daten zurück. Korrigiere URL, Header oder Parameter, bis die Test-Antwort stimmt.
Ein Test sendet die echte Anfrage an deinen Endpunkt. Teste gegen einen sicheren Endpunkt und vermeide Tools, die unbeabsichtigte Schreibvorgänge ausführen.
7

Einem Assistenten zuordnen

Speichere das Tool, öffne dann den Assistenten, der es nutzen soll, und ordne das Tool unter dessen Tools zu. Der Assistent kann es nun während Chats aufrufen, wann immer die Frage des Shoppers zur Beschreibung des Tools passt.

​
Sicherheit

Füge Geheimnisse niemals direkt in die Header oder die URL eines Tools ein:
  • Speichere API-Keys und andere sensible Werte als Geheimnisse, damit sie verschlüsselt aufbewahrt und nie im Klartext offengelegt werden. Siehe Einstellungen › Geheimnisse.
  • Nutze eine Auth-Verbindung, wenn das Tool eine Authentifizierung benötigt – Bearer, Basic, einen eigenen Header oder OAuth –, um gegen einen Drittanbieter-Service zu agieren. Siehe Einstellungen › Auth-Verbindungen.
Teste ein Tool immer, bevor du es zuordnest. Ein zugeordnetes Tool kann während laufender Chats automatisch aufgerufen werden – stelle also sicher, dass sich der Endpunkt wie erwartet verhält und nie unbeabsichtigte Schreibvorgänge ausführt.

​
Verfügbarkeit

Ob Tools verfügbar sind und wie viele HTTP-Tools du anlegen kannst, hängt von deinem Plan ab. Wenn du das Limit erreichst, lösche ein nicht mehr benötigtes Tool oder upgrade deinen Plan.

​
Nächste Schritte

Geheimnisse

Speichere API-Keys, die deine Tools referenzieren, sicher.

E-Mail-Tool

Lass den Assistenten E-Mails von einem verifizierten Absender senden.