Svar med sanntidsdata fra dine egne systemer
Verktøykall lar chatboten kalle API-et ditt midt i en samtale, lese svaret som kommer tilbake, og bruke det i sitt svar. Kunden spør om ordren sin, og boten gir det faktiske svaret i stedet for et generelt.
Trening lærer chatboten ting som er uforanderlige. Verktøykall dekker det som endrer seg minutt for minutt: en ordrestatus, et sporingsnummer, en booking. Dette er en avansert funksjon og krever tilpasset kode på din server, så planlegg den med den som vedlikeholder systemene dine.
Steg for steg
Bestem hvor oppslaget skal være
Verktøykall brukes av Spørsmål og svar og av Flyter. Plasser det i et Spørsmål og svar når et enkelt spørsmål trenger et levende svar, og i en flyt når oppslaget er ett trinn i en lengre samtalevei.
Pek det mot endepunktet ditt
I URL angir du adressen til API-endepunktet som skal svare på forespørselen. I Overskrifter legger du til nøkkel:verdi-par som endepunktet ditt trenger. I Spørsmål og svar er overskriftene komma-separert; i flyter legger du dem til én etter én.
Definer hva kunden må gi deg
Egenskaper er verdiene chatboten må samle inn før den kan kalle deg, for eksempel en by eller et sporingsnummer. Hvis mulige verdier er kjent på forhånd, list dem under Tillatte verdier slik at boten holder seg innenfor det settet.
Les forespørselen på din server
Vi sender serveren din denne strukturen: {"sb":{"user_id":"123","conversation_id":"123","user_language":"es"},"arguments":{}} — som JSON-body for POST, og som header for GET. Hver argumentnøkkel er egenskapsnavnet i kebab-case, så "Ordrenummer" blir order-number. Du kan også plassere en verdi direkte i URL-en med et sammenslåingsfelt, for eksempel {order-number}.
Returner JSON som chatboten kan bruke
Serveren din må svare med JSON som inneholder verdiene du ønsker at boten skal si, for eksempel {"order_status":"Levert for 2 timer og 25 minutter siden","success":true}. Inkluder "success": true kun når forespørselen faktisk lykkes.
Innstillingsreferanse
| Innstilling | Hva den gjør |
|---|---|
| URL | Adressen til API-endepunktet ditt som chatboten kaller. |
| Headers | Nøkkel:verdi-par som sendes med forespørselen, atskilt med komma i Q&A og lagt til én etter én i flyter. |
| Properties | Verdiene brukeren må oppgi før kallet kan utføres, for eksempel en by eller et sporingsnummer. |
| Tillatte verdier | Begrenser en egenskap til et kjent sett med alternativer i stedet for fritekst. |
Godt å vite
"success": true er et løfte, ikke en formalitet
Returner det bare når forespørselen faktisk fungerte. Hvis ordrenummeret er ugyldig eller ingenting ble funnet, utelat det slik at chatboten ikke presenterer en feil som et svar.
Argumentnavn endrer form
Egenskapnavn kommer i kebab-case, så "Order Number" blir order-number. Match den stavemåten i koden din og i eventuelle flettefelt du setter inn i URL-en.
GET og POST mottar data forskjellig
For POST kommer nyttelasten som en JSON-body. For GET kommer den som en header. Sjekk hvilken metode endepunktet ditt bruker før du begynner å lese forespørselen.
Du får kontekst med hvert kall
Forespørselen inneholder user_id, conversation_id og user_language, slik at endepunktet ditt vet hvem som spør og på hvilket språk.
Denne trenger en utvikler
Verktøykalling er en avansert funksjon. Panel-delen er kort, men noe på serveren din må motta forespørselen og returnere JSON.
Vanlige spørsmål
Hvor kan jeg bruke verktøykalling?
Hva sender du egentlig til serveren min?
Hvordan får jeg kundens verdi inn i URL-en min?
Hva bør serveren min sende tilbake?
Hva skjer hvis kunden oppgir et nummer som ikke finnes?
Kan jeg begrense hva kunden har lov til å skrive inn?
Klar til å få slutt på kaoset?
Samle meldingene dine, automatiser de repetitive spørsmålene, og gjør samtaler til inntekter – start i dag.
Kom i gang