Værktøjer

Værktøjer udvider, hvad Chat kan gøre under en samtale. Et webhook kan hente live data fra en ekstern tjeneste, mens et JavaScript-værktøj kan køre kode i shopperens browser og udføre en handling på din webshop.

Navn & Beskrivelse #

Gå til Chat > Tools og klik på + Add another tool for at åbne værktøjseditoren. Giv værktøjet et klart navn og beskriv, hvornår Chat skal bruge det.

Beskrivelsen fungerer som en instruktion til AI’en. Vær specifik om den situation, der skal udløse værktøjet. For eksempel:

“Når en kunde spørger til en ordre, brug ordredata tilgængelige i product_data til at give information om deres ordre.”

En klar beskrivelse hjælper Chat med at bruge værktøjet korrekt og undgår at kalde det ved uvedkommende spørgsmål.

Byg med Ask #

Hvis du ikke selv ønsker at opsætte værktøjet, så bed Ask Clerk.io om at foreslå et webhook eller JavaScript-værktøj. Beskriv, hvad Chat skal gøre, og gennemgå samt godkend det foreslåede navn, beskrivelse, parametre og opsætning før brug.

Webhooks #

I Type vælges Webhook. Webhook-værktøjer kalder din HTTP API. Brug dem, når en tjeneste kan levere data eller udføre den handling, Chat har brug for, via et endpoint.

Parametre #

Definér de værdier, Chat skal bruge, før værktøjet kan køres. Chat indsamler disse værdier fra samtalen og spørger besøgende, hvis en nødvendig værdi mangler.

For hver parameter defineres:

• Navn — Variabelnavnet brugt af endpointet eller JavaScript-funktionen.
• Type — Den type værdi Chat skal indsamle, fx tekst eller heltal.
• Beskrivelse — Hvad værdien repræsenterer, og hvad Chat skal spørge den besøgende om.

Markér en parameter som Required, hvis værktøjet ikke kan fungere uden den.

Endpoint #

Konfigurér HTTP-anmodningen, som Chat sender, når et webhook-værktøj køres.

Metode: Vælg GET, POST, PUT eller DELETE, alt efter hvad din API kræver.

URL: Indtast den fulde endpoint-URL. Query-parametre kan være statiske eller bruge værdier, der indsamles fra samtalen med {{parameter_name}}. For eksempel:

https://api.example.com/orders?email={{email}}&id={{order_number}}

Request body: For POST- og PUT-anmodninger indtastes body i det format, din API forventer. Du kan også bruge parametre her.

Custom headers: Tilføj de headers, som din API kræver, fx autentificeringstokens eller content type overrides.

Timeout: Vælg hvor længe Chat skal vente på et svar, før den opgiver. Valgmulighederne spænder fra 3 sekunder til 10 minutter.

Gem og test #

Når værktøjet er klar, klik på Save eller Save & Close.

Brug sektionen Test nederst i editoren. Indtast værdier for parametrene og klik Test request for at tjekke forbindelsen.

JavaScript #

I Type vælges JavaScript. JavaScript-værktøjer kører i shopperens browser og kan forbinde Chat til funktioner, der allerede findes på din webshop, såsom:

• tilføje et produkt til kurven
• læse den aktuelle kurv
• anvende en rabatkode
• åbne checkout
• åbne en størrelsesguide
• gemme et produkt på en ønskeliste
• åbne en store locator eller click-and-collect flow

Dette er brugerdefinerede handlinger, ikke indbyggede funktioner. Du skal selv tilknytte hvert værktøj til den tilhørende funktionalitet på din webshop.

Parametre #

Definér de værdier, Chat skal bruge, før værktøjet kan køres. Chat indsamler disse værdier fra samtalen og spørger besøgende, hvis en nødvendig værdi mangler.

For hver parameter defineres:

• Navn — Variabelnavnet brugt af JavaScript-funktionen.
• Type — Den type værdi Chat skal indsamle, fx tekst eller heltal.
• Beskrivelse — Hvad værdien repræsenterer, og hvad Chat skal spørge den besøgende om.

Markér en parameter som Required, hvis værktøjet ikke kan fungere uden den. Læs de indsamlede værdier fra objektet args i din funktion.

Kode #

Skriv en asynkron funktion, som webshoppens frontend kører, når Chat kalder værktøjet. Editoreren leverer de indsamlede argumenter og konteksten for webshoppen til funktionen.

Brug objektet args til at læse værdierne defineret i Parameters. Kald derefter koden på webshoppen, der udfører handlingen, fx at tilføje et produkt til kurven eller åbne checkout. Returnér et klart resultat, så Chat kan fortælle den besøgende, hvad der skete.

Den præcise JavaScript afhænger af din webshop. Sørg for, at funktionen håndterer manglende, ugyldige eller utilgængelige værdier sikkert.

Gem og test #

Når værktøjet er klar, klik på Save eller Save & Close.

Test JavaScript-værktøjer på en test- eller preview-webshop, før du gør dem tilgængelige for besøgende. Verificér både webshop-handlingen og den besked, Chat giver efter handlingen er gennemført.