Antwoord met live gegevens uit jouw eigen systemen
Met tools aanroepen kan de chatbot midden in een gesprek jouw API aanroepen, de terugkerende gegevens lezen en die in zijn antwoord gebruiken. De klant vraagt naar zijn bestelling en de bot geeft het echte antwoord in plaats van een algemeen antwoord.
Training leert de chatbot dingen die hetzelfde blijven. Tools aanroepen dekt wat per minuut verandert: een bestelstatus, een trackingnummer, een boeking. Het is een geavanceerde functie en vereist aangepaste code op jouw server, dus plan het met degene die voor jouw systemen zorgt.
Stap voor stap
Bepaal waar de opvraging thuishoort
Tools aanroepen wordt gebruikt door Q&A en door Flows. Zet het in een Q&A wanneer een enkele vraag een live antwoord nodig heeft, en in een flow wanneer de opvraging een stap is in een langer gesprekspad.
Wijs het naar jouw endpoint
Vul bij URL het adres in van het API-endpoint dat het verzoek zal beantwoorden. Voeg bij Headers eventuele key:value-paren toe die jouw endpoint nodig heeft. In Q&A zijn de headers komma-gescheiden; in flows voeg je ze één voor één toe.
Bepaal wat de klant moet geven
Properties zijn de waarden die de chatbot moet verzamelen voordat hij jou kan aanroepen, bijvoorbeeld een stad of een trackingnummer. Als de mogelijke waarden van tevoren bekend zijn, zet ze dan onder Toegestane waarden zodat de bot binnen die set blijft.
Lees het verzoek op jouw server
We sturen jouw server deze vorm: {"sb":{"user_id":"123","conversation_id":"123","user_language":"es"},"arguments":{}} — als JSON-body voor POST en als header voor GET. Elke argument-sleutel is de property-naam in kebab-case, dus "Order Number" komt binnen als order-number. Je kunt ook een waarde direct in de URL plaatsen met een merge-veld, bijvoorbeeld {order-number}.
Geef JSON terug die de chatbot kan gebruiken
Je server moet een JSON terugsturen met de waarden die de chatbot moet uitspreken, bijvoorbeeld {"order_status":"Bezorgd 2 uur en 25 minuten geleden","success":true}. Voeg "success": true alleen toe als het verzoek echt is gelukt.
Instellingenoverzicht
| Instelling | Wat het doet |
|---|---|
| URL | Het adres van je API-endpoint dat de chatbot aanroept. |
| Headers | Key:value-paren die met het verzoek worden meegestuurd, in Q&A gescheiden door komma's en in flows één voor één toegevoegd. |
| Properties | De waarden die de gebruiker moet opgeven voordat de aanroep kan worden gedaan, zoals een stad of een trackingnummer. |
| Toegestane waarden | Beperkt een property tot een bekende set opties in plaats van vrije tekst. |
Om te weten
"success": true is een belofte, geen formaliteit
Geef het alleen terug als het verzoek echt is gelukt. Als het ordernummer ongeldig is of er niets is gevonden, laat het dan weg, zodat de chatbot een mislukking niet als antwoord presenteert.
Argumentnamen veranderen van vorm
Property-namen worden in kebab-case aangeleverd, dus "Order Number" wordt order-number. Gebruik die spelling in je code en in eventuele merge-velden die je in de URL plaatst.
GET en POST ontvangen de gegevens anders
Bij POST komt de payload binnen als een JSON-body. Bij GET komt deze binnen als een header. Controleer welke methode je endpoint gebruikt voordat je het verzoek gaat lezen.
Je krijgt context bij elke aanroep
Het verzoek bevat user_id, conversation_id en user_language, zodat jouw endpoint weet wie er vraagt en in welke taal.
Deze heeft een developer nodig.
Tools calling is een geavanceerde functie. De paneelzijde is kort, maar er moet iets op jouw server zijn dat het verzoek ontvangt en de JSON terugstuurt.
Veelgestelde vragen
Waar kan ik tools calling gebruiken?
Wat stuur je precies naar mijn server?
Hoe krijg ik de waarde van de klant in mijn URL?
Wat moet mijn server terugsturen?
Wat gebeurt er als de klant een nummer geeft dat niet bestaat?
Kan ik beperken wat de klant mag invoeren?
Klaar om de chaos te stoppen?
Verenig je berichten, automatiseer de herhalende vragen en zet gesprekken om in omzet — begin vandaag nog.
Aan de slag