Værktøjer

Værktøjer lader Chat kalde eksterne API’er under en samtale. Når en besøgende spørger om noget, der kræver live-data — såsom ordrestatus, lagerbeholdning eller loyalitetspoint — kan Chat hente det automatisk og svare med faktuelle oplysninger fra dine systemer.

Enhver tjeneste, der har et API, kan tilsluttes som et Værktøj.

Gå til Chat > Tools og klik på + Add another tool for at åbne værktøjseditoren.

Navn & Beskrivelse #

Giv værktøjet et navn for at identificere det, og en beskrivelse, der fortæller Chat, hvornår det skal bruges.

Beskrivelsen er den vigtigste del. Den fungerer som en instruktion til AI’en — ligesom at fortælle en ny medarbejder, hvornår de skal slå noget op i et eksternt system. Vær specifik omkring den situation, der skal aktivere dette værktøj. For eksempel:

“Når en kunde spørger om en ordre, brug ordredataene tilgængelige i product_data for at give oplysninger om deres ordre.”

Jo tydeligere beskrivelsen er, jo mere pålideligt vil Chat bruge værktøjet korrekt.

Parametre #

Parametre definerer de datapunkter, der skal indgå i API-kaldet. Når et værktøj aktiveres, tjekker Chat, om den allerede har de nødvendige værdier fra samtalen. Hvis ikke, beder den den besøgende om at give dem, inden anmodningen sendes.

For hvert parameter skal du definere:

• Navn — Variabelnavnet, der refereres til i URL’en eller anmodningsbody
• Type — Fortæller Chat, hvilken datatype der skal indsamles, f.eks. en tekststreng eller et helt tal.
• Beskrivelse — Fortæller Chat, hvad dette parameter repræsenterer, og hvad der skal spørges om

En god beskrivelse gør det klart, hvad den besøgende skal give. For eksempel, et parameter med navnet order_number og beskrivelsen “ID’et på den ordre, brugeren spørger om” giver Chat alt, hvad der skal til for at stille det rigtige spørgsmål.

Markér et parameter som Påkrævet, hvis API-kaldet ikke kan fungere uden det.

Endpoint #

Her definerer du det faktiske API-kald, Chat vil foretage, når værktøjet aktiveres.

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

URL: Indtast den fulde endpoint-URL. Forespørgselsparametre kan tilføjes direkte i URL’en, hvilket normalt er tilstrækkeligt til GET-anmodninger. Forespørgselsparametre kan være statiske eller baseret på de parametre, du har bedt Chat om at indsamle, ved brug af {{parameter_name}}. For eksempel:

https://api.omate.com/orders?key=abc123&e={{email}}&id={{order_number}}

Request body: Tilgængelig for POST- og PUT-anmodninger. Definér hele kroppen i det format, dit API forventer. Parametre kan også refereres her, hvis nødvendigt, ligesom i URL’en.

Custom headers: Tilføj de headers, dit API kræver, såsom autentificeringstokener eller content-type.

Timeout: Indstil hvor længe Chat skal vente på et svar, før den giver op. Mulighederne spænder fra 3 sekunder til 10 minutter.

Test #

Når konfigurationen er på plads, brug Test-sektionen nederst i editoren til at bekræfte forbindelsen. Indtast rigtige værdier for hvert parameter og klik på Test request for at køre kaldet.

En vellykket test bekræfter, at Chat vil kunne bruge værktøjet pålideligt under live-samtaler.