Strumenti

Gli strumenti estendono ciò che Chat può fare durante una conversazione. Un webhook può recuperare dati in tempo reale da un servizio esterno, mentre uno strumento JavaScript può eseguire codice nel browser dell’acquirente ed effettuare un’azione sul tuo storefront.

Nome e Descrizione #

Vai su Chat > Tools e clicca su + Add another tool per aprire l’editor dello strumento. Dai allo strumento un nome chiaro e descrivi quando Chat dovrebbe usarlo.

La descrizione funge da istruzione per l’AI. Sii specifico riguardo alla situazione che dovrebbe attivare lo strumento. Ad esempio:

“Quando un cliente chiede informazioni su un ordine, usa i dati dell’ordine disponibili in product_data per fornire informazioni sul loro ordine.”

Una descrizione chiara aiuta Chat a utilizzare lo strumento correttamente ed evitare di chiamarlo per domande non correlate.

Crea con Ask #

Se non vuoi configurare tu stesso lo strumento, chiedi ad Ask Clerk.io di proporre un webhook o uno strumento JavaScript. Descrivi cosa dovrebbe fare Chat, quindi rivedi e conferma nome proposto, descrizione, parametri e configurazione prima di utilizzarlo.

Webhooks #

In Type, seleziona Webhook. Gli strumenti webhook chiamano la tua API HTTP. Usali quando un servizio può fornire i dati o eseguire l’azione di cui Chat ha bisogno tramite un endpoint.

Parametri #

Definisci i valori di cui Chat ha bisogno prima di poter eseguire lo strumento. Chat raccoglie questi valori dalla conversazione e chiede al visitatore qualsiasi valore obbligatorio mancante.

Per ogni parametro, definisci:

• Nome — Il nome della variabile usato dall’endpoint o dalla funzione JavaScript.
• Tipo — Il tipo di valore che Chat dovrebbe raccogliere, come testo o numero intero.
• Descrizione — Cosa rappresenta il valore e cosa Chat dovrebbe chiedere al visitatore.

Segna un parametro come Required quando lo strumento non può funzionare senza di esso.

Endpoint #

Configura la richiesta HTTP che Chat invia quando viene eseguito uno strumento webhook.

Metodo: Scegli GET, POST, PUT, o DELETE, a seconda di ciò che richiede la tua API.

URL: Inserisci l’URL completo dell’endpoint. I parametri di query possono essere statici o usare valori raccolti dalla conversazione con {{parameter_name}}. Ad esempio:

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

Request body: Per le richieste POST e PUT, inserisci il body nel formato richiesto dalla tua API. Puoi usare anche qui i parametri.

Custom headers: Aggiungi qualsiasi header richiesto dalla tua API, come token di autenticazione o override del content type.

Timeout: Scegli quanto a lungo Chat dovrebbe attendere una risposta prima di rinunciare. Le opzioni disponibili variano da 3 secondi a 10 minuti.

Salva e Testa #

Quando lo strumento è pronto, clicca su Save o Save & Close.

Utilizza la sezione Test in fondo all’editor. Inserisci i valori per i parametri e clicca su Test request per verificare la connessione.

JavaScript #

In Type, seleziona JavaScript. Gli strumenti JavaScript vengono eseguiti nel browser dell’acquirente e possono collegare Chat a funzionalità già presenti nel tuo storefront, come:

• aggiungere un prodotto al carrello
• leggere il carrello corrente
• applicare un codice sconto
• aprire il checkout
• aprire una guida alle taglie
• salvare un prodotto in una wishlist
• aprire un localizzatore di negozi o un flusso click-and-collect

Queste sono azioni personalizzate, non operazioni integrate. Devi collegare ogni strumento alla funzionalità corrispondente nel tuo storefront.

Parametri #

Definisci i valori di cui Chat ha bisogno prima di poter eseguire lo strumento. Chat raccoglie questi valori dalla conversazione e chiede al visitatore qualsiasi valore obbligatorio mancante.

Per ogni parametro, definisci:

• Nome — Il nome della variabile usata dalla funzione JavaScript.
• Tipo — Il tipo di valore che Chat dovrebbe raccogliere, come testo o numero intero.
• Descrizione — Cosa rappresenta il valore e cosa Chat dovrebbe chiedere al visitatore.

Segna un parametro come Required quando lo strumento non può funzionare senza di esso. Leggi i valori raccolti dall’oggetto args nella tua funzione.

Codice #

Scrivi una funzione asincrona che lo storefront esegue quando Chat richiama lo strumento. L’editor fornisce alla funzione gli argomenti raccolti e il contesto dello storefront.

Usa l’oggetto args per leggere i valori definiti in Parameters. Chiama quindi il codice dello storefront che esegue l’azione, come aggiungere un articolo al carrello o aprire il checkout. Restituisci un risultato chiaro così che Chat possa comunicare al visitatore cosa è successo.

Il codice JavaScript esatto dipende dal tuo storefront. Assicurati che la funzione gestisca in modo sicuro valori mancanti, non validi o non disponibili.

Salva e Testa #

Quando lo strumento è pronto, clicca su Save o Save & Close.

Testa gli strumenti JavaScript su uno storefront di test o anteprima prima di renderli disponibili ai visitatori. Verifica sia l’azione sullo storefront che il messaggio che Chat fornisce dopo il completamento dell’azione.