Værktøjer

Værktøjer udvider, hvad Chat kan gøre under en samtale. Et webhook kan hente live data fra en ekstern service, 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 omkring situationen, der skal udløse værktøjet. For eksempel:

“Når en kunde spørger om en ordre, brug ordredata tilgængelig 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å at kalde det for uvedkommende spørgsmål.

Byg med Ask #

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

Webhooks #

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

Parametre #

Definér de værdier, Chat skal have, før værktøjet kan køres. Chat indsamler disse værdier fra samtalen og spørger besøgende om evt. manglende værdier.

For hvert parameter, definér:

• Name — Variabelnavnet brugt af endpoint eller JavaScript-funktion.
• Type — Den type værdi Chat skal indsamle, fx tekst eller et helt tal.
• Description — Hvad værdien repræsenterer og hvad Chat skal bede den besøgende om.

Markér et parameter som Required når værktøjet ikke kan fungere uden det.

Endpoint #

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

Method: Vælg GET, POST, PUT eller DELETE, afhængigt af hvad dit API kræver.

URL: Indtast den fulde endpoint-URL. Forespørgselsparametre kan være statiske eller benytte værdier indsamlet fra samtalen med {{parameter_name}}. Eksempel:

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

Request body: For POST- og PUT-forespørgsler indtastes kroppen i det format, dit API forventer. Parametre kan også bruges her.

Custom headers: Tilføj nødvendige headers til dit API såsom authentication tokens eller content type overrides.

Timeout: Vælg hvor længe Chat skal vente på svar, før den opgiver. Mulighederne 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 teste forbindelsen.

JavaScript #

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

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

Dette er brugerdefinerede handlinger, ikke indbyggede operationer. Du skal forbinde hvert værktøj til den tilsvarende 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 om evt. påkrævede værdier.

For hvert parameter, definér:

• Name — Variabelnavnet brugt af JavaScript-funktionen.
• Type — Den type værdi Chat skal indsamle, fx tekst eller et helt tal.
• Description — Hvad værdien repræsenterer og hvad Chat skal bede den besøgende om.

Markér et parameter som Required når værktøjet ikke kan fungere uden det. Læs de indsamlede værdier fra args-objektet i din funktion.

Kode #

Skriv en asynkron funktion, som webshoppen kører, når Chat kalder værktøjet. Editoreren giver funktionen de indsamlede argumenter og webshop-kontexten.

Brug args-objektet til at læse værdier defineret i Parameters. Kald derefter webshop-koden, der udfører handlingen, såsom 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 på en sikker måde.

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-shop, før de gøres tilgængelige for besøgende. Verificér både handlingen på webshoppen og den besked Chat giver, når handlingen er fuldført.