Antworten mit Live-Daten aus Ihren eigenen Systemen
Der Tools-Aufruf ermöglicht es dem Chatbot, mitten in einem Gespräch Ihre API aufzurufen, die Rückmeldung zu lesen und in seiner Antwort zu verwenden. Der Kunde fragt nach seiner Bestellung, und der Bot gibt die echte Antwort statt einer allgemeinen.
Das Training lehrt dem Chatbot Dinge, die gleich bleiben. Der Tools-Aufruf deckt ab, was sich von Minute zu Minute ändert: ein Bestellstatus, eine Sendungsnummer, eine Buchung. Es ist eine erweiterte Funktion und erfordert benutzerdefinierten Code auf Ihrem Server – planen Sie dies daher mit der Person, die Ihre Systeme betreut.
Schritt für Schritt
Legen Sie fest, wo der Abruf erfolgen soll
Der Tools-Aufruf wird von Q&A und von Flows verwendet. Setzen Sie ihn in ein Q&A ein, wenn eine einzelne Frage eine Live-Antwort benötigt, und in einen Flow, wenn der Abruf ein Schritt in einem längeren Gesprächsverlauf ist.
Verweisen Sie auf Ihren Endpunkt
Geben Sie unter URL die Adresse des API-Endpunkts ein, der die Anfrage beantworten soll. Fügen Sie unter Header alle Schlüssel:Wert-Paare hinzu, die Ihr Endpunkt benötigt. In Q&A werden die Header durch Kommas getrennt; in Flows fügen Sie sie einzeln hinzu.
Definieren Sie, was der Kunde angeben muss
Properties sind die Werte, die der Chatbot sammeln muss, bevor er Sie aufrufen kann, zum Beispiel eine Stadt oder eine Sendungsnummer. Falls die möglichen Werte im Voraus bekannt sind, listen Sie sie unter Erlaubte Werte auf, damit der Bot innerhalb dieser Menge bleibt.
Lesen Sie die Anfrage auf Ihrem Server
Wir senden Ihrem Server diese Struktur: {"sb":{"user_id":"123","conversation_id":"123","user_language":"es"},"arguments":{}} – als JSON-Body für POST und als Header für GET. Jeder Argumentschlüssel ist der Property-Name in Kebab-Schreibweise, sodass „Order Number“ als order-number ankommt. Sie können auch einen Wert direkt in die URL mit einem Merge-Feld einfügen, z. B. {order-number}.
Geben Sie JSON zurück, das der Chatbot verwenden kann
Ihr Server muss mit JSON antworten, das die Werte enthält, die der Bot sprechen soll, zum Beispiel {"order_status":"Vor 2 Stunden und 25 Minuten zugestellt","success":true}. Fügen Sie "success": true nur hinzu, wenn die Anfrage tatsächlich erfolgreich war.
Einstellungsreferenz
| Einstellung | Funktionsweise |
|---|---|
| URL | Die Adresse Ihres API-Endpunkts, den der Chatbot aufruft. |
| Headers | Schlüssel:Wert-Paare, die mit der Anfrage gesendet werden, in Q&A durch Kommas getrennt und in Flows einzeln hinzugefügt. |
| Properties | Die Werte, die der Benutzer angeben muss, bevor der Aufruf erfolgen kann, wie z. B. eine Stadt oder eine Sendungsnummer. |
| Allowed values | Schränkt eine Eigenschaft auf eine bekannte Menge von Optionen ein, anstatt Freitext zuzulassen. |
Wissenswertes
"success": true ist ein Versprechen, keine Formalität
Geben Sie es nur zurück, wenn die Anfrage wirklich funktioniert hat. Wenn die Bestellnummer ungültig ist oder nichts gefunden wurde, lassen Sie es weg, damit der Chatbot keinen Fehlschlag als Antwort präsentiert.
Argumentnamen ändern ihre Form
Eigenschaftsnamen erscheinen in Kebab-Schreibweise, sodass aus "Order Number" order-number wird. Passen Sie diese Schreibweise in Ihrem Code und in jedem Merge-Feld an, das Sie in die URL einfügen.
GET und POST erhalten die Daten unterschiedlich
Bei POST kommt die Nutzlast als JSON-Body an. Bei GET kommt sie als Header an. Überprüfen Sie, welche Methode Ihr Endpunkt verwendet, bevor Sie mit dem Lesen der Anfrage beginnen.
Sie erhalten bei jedem Aufruf Kontext
Die Anfrage enthält user_id, conversation_id und user_language, damit Ihr Endpunkt weiß, wer fragt und in welcher Sprache.
Dieser Punkt erfordert einen Entwickler.
Tools Calling ist eine erweiterte Funktion. Die Panel-Seite ist kurz, aber auf Ihrem Server muss etwas die Anfrage empfangen und das JSON zurückgeben.
Häufige Fragen
Wo kann ich Tools Calling einsetzen?
Was genau senden Sie an meinen Server?
Wie bekomme ich den Wert des Kunden in meine URL?
Was soll mein Server zurücksenden?
Was passiert, wenn der Kunde eine Nummer angibt, die nicht existiert?
Kann ich einschränken, was der Kunde eingeben darf?
Bereit, das Chaos zu beenden?
Vereinheitlichen Sie Ihre Nachrichten, automatisieren Sie wiederkehrende Fragen und verwandeln Sie Gespräche in Umsatz – ab heute.
Jetzt starten