Come configurare ChatLab per il tuo negozio e-commerce

Configurare correttamente ChatLab è fondamentale per garantire che il tuo chatbot fornisca informazioni precise sui prodotti e aggiornamenti sugli ordini in tempo reale. Con la giusta configurazione, ChatLab può rispondere a domande dettagliate sui prodotti, recuperare lo stato degli ordini e assistere i clienti a qualsiasi ora.

Prima di iniziare

Crea e allena il tuo chatbot prima di condividerlo con i clienti. Per l'installazione, devi anche disporre dei permessi per modificare e pubblicare il sito web. Consulta Come creare il tuo primo chatbot.

Cosa è importante in un chatbot per l'e-commerce

Inizia dall'esperienza cliente che vuoi supportare. La ricerca dei prodotti, le azioni sul carrello e la verifica degli ordini sono funzionalità distinte con requisiti diversi.

Aiutare i clienti a trovare un prodotto

Consulta AI Search per l'indicizzazione del catalogo e l'aggiornamento dei dati, e Offer Cards per i risultati visivi.

Aiutare i clienti ad aggiungere un prodotto selezionato

Questo richiede un'integrazione supportata e la configurazione del negozio online, non solo una scheda prodotto. Leggi Aggiunta di prodotti al carrello e testa il carrello effettivo del negozio prima di abilitare la funzione per i clienti.

Aiutare i clienti a tracciare un ordine esistente

Leggi Verifica dello stato dell'ordine per i requisiti di ricerca, le considerazioni sulla privacy e le ricerche non riuscite. I dettagli dell'ordine non consentono di per sé rimborsi o modifiche all'ordine.

Checklist di configurazione

• Informazioni accurate sui prodotti - assicurati che i clienti ricevano dettagli corretti su specifiche e offerte
• Presentazione chiara delle offerte - metti in risalto sconti, pacchetti e promozioni in modo efficace
• Dati aggiornati - fornisci prezzi in tempo reale, disponibilità a magazzino e stato dell'ordine (con l'integrazione abilitata)
• Tracciamento dell'ordine e dati utente - consenti ai clienti di verificare i dettagli dell'ordine e lo stato della spedizione una volta integrato

Come fornire informazioni sui prodotti a ChatLab

Prima di addestrare ChatLab sul tuo negozio, decidi in che modo acquisirà i dati dei prodotti:

• Scansione del sito web: ChatLab esegue la scansione e indicizza le pagine dei tuoi prodotti (descrizioni, specifiche e immagini) in una knowledge base statica. Ideale per un contesto ricco e risposte dettagliate quando il tuo catalogo è relativamente stabile. Scopri di più: Aggiungere nuove sorgenti del sito web

• Integrazione API: collegati tramite le API di Shopify, WooCommerce, PrestaShop o di altre piattaforme per recuperare dati in tempo reale su prodotti, prezzi e disponibilità a magazzino, oltre a gestire la consultazione degli ordini in tempo reale. Alcune integrazioni supportano anche la ricerca dei prodotti tramite SKU o codice di riferimento. È la scelta migliore per inventari che cambiano spesso e per la gestione degli ordini. La ricerca per parole chiave e gli strumenti per gli ordini interrogano direttamente l'API del negozio. Le piattaforme supportate offrono anche la ricerca prodotti con AI, che indicizza un catalogo separato per la corrispondenza semantica. Il suo livello di aggiornamento dipende dagli intervalli di sincronizzazione del catalogo e dalle query in tempo reale della piattaforma.

• Combina entrambe le soluzioni: usa la scansione per una conoscenza contestuale approfondita e mantieni attiva l'integrazione per avere sempre dati aggiornati.

Integrazioni e-commerce disponibili

Vai sul tuo bot e seleziona la scheda Connect (Connetti) per visualizzare tutte le integrazioni disponibili.

ChatLab supporta le seguenti piattaforme di e-commerce:

• Shopify - ricerca prodotti (con filtro per articoli disponibili), tracciamento ordini
• WooCommerce - ricerca prodotti per nome o SKU, navigazione categorie, tracciamento ordini
• PrestaShop - ricerca prodotti per nome o codice di riferimento/SKU, supporto per varianti, tracciamento ordini
• Shoper - ricerca prodotti, tracciamento ordini
• Wix - tracciamento ordini
• CS-Cart - ricerca prodotti, tracciamento ordini
• Abicart - ricerca articoli, tracciamento ordini
• BaseLinker - ricerca ordini per una sorgente ordini configurata
• Feed di prodotti (XML) - ricerca catalogo con AI senza tracciamento ordini

ChatLab supporta anche integrazioni per hotel e strutture ricettive:

• Beds24 - disponibilità camere, dettagli della struttura, prezzi
• Mews - categorie di camere con assistenza del supporto, ricerca disponibilità, consultazione prenotazioni
• Hotres - annunci appartamenti, verifica disponibilità
• IdoBooking - prenotazione appartamenti, gestione prenotazioni
• KWHotel - informazioni sulle camere, disponibilità e consultazione opzionale delle prenotazioni

Controlla la scheda Shop e il catalogo

Dopo aver collegato un negozio supportato, apri la scheda Shop (Negozio) per verificarne la connessione, il catalogo prodotti e la configurazione di ricerca. La ricerca prodotti con AI può essere attivata e l'indicizzazione avviata automaticamente quando l'auto-indicizzazione del catalogo è abilitata e il bot dispone dell'accesso e della capacità necessari. Per i bot esistenti potrebbe essere necessario un allenamento manuale. Attendi il termine dell'allenamento e controlla eventuali errori nel catalogo prima di effettuare i test. La scheda Hotel fornisce una panoramica analoga per le integrazioni ricettive supportate.

Scansione o integrazione: qual è la soluzione migliore?

Scansione del sito web

Vantaggi:

• Ricerca con AI nel contesto completo con risposte ricche e dettagliate
• Comprensione profonda delle descrizioni dei prodotti

Svantaggi:

• Richiede un nuovo allenamento manuale o automatico per acquisire prodotti nuovi o aggiornati
• Può esaurire la quota di caratteri di allenamento durante l'indicizzazione di cataloghi estesi
• Potenziale interpretazione errata di specifiche tecniche complesse
• Possibile mancata estrazione delle informazioni da tabelle o elenchi di parametri

Integrazione API

Vantaggi:

• Prezzi e disponibilità aggiornati tramite le azioni API supportate, nel rispetto della cache e della disponibilità della piattaforma
• Consultazione degli ordini in tempo reale per verificare stato e cronologia di spedizione
• Ricerca per SKU e codice di riferimento disponibile per WooCommerce e PrestaShop
• Shopify supporta il filtro per mostrare solo i prodotti disponibili a magazzino

Svantaggi:

• La ricerca per parole chiave richiede frasi di ricerca adeguate; la ricerca prodotti con AI aggiunge la corrispondenza semantica quando abilitata e allenata
• Dipende dalla disponibilità e dai limiti di frequenza (rate limit) delle API
• Richiede credenziali e configurazione corrette
• È necessario testare il modello di AI selezionato con il tuo catalogo reale e le domande tipiche dei clienti

La formula vincente: combina scansione e integrazione

Combina sorgenti selezionate del sito web con l'integrazione più indicata. Pianifica gli aggiornamenti per i contenuti indicizzati, testa le risposte relative a prezzi e disponibilità e considera sempre il checkout come la conferma definitiva di prezzo e giacenza.

Per ottenere risposte ricche di contesto e contemporaneamente dati aggiornati in tempo reale, configura il comportamento personalizzato di ChatLab in Settings > Role & Behavior (Impostazioni > Ruolo e comportamento). Fai clic su Enable custom role and behavior instructions (Abilita istruzioni personalizzate per ruolo e comportamento) e inserisci quanto segue:

When a user asks about products or categories, first invoke API tools to retrieve current data; fallback to the scanned knowledge base only for contextual enrichment. After fetching live data, augment responses with detailed descriptions and recommendations from the knowledge base when relevant.

Scopri di più sulla personalizzazione del ruolo: Impostazioni Role & Behavior

Scegli e testa il tuo modello di AI

Usa un modello in grado di gestire in modo affidabile il tuo catalogo e le domande dei clienti. Fai dei test con descrizioni di prodotto ambigue, codici articolo esatti, varianti e verifiche di ordini. Confronta qualità e consumo di crediti messaggio prima di cambiare modello.

Modifica il modello in Settings > Model & Advanced (Impostazioni > Modello e avanzate).

Configura le istruzioni personalizzate

Questi esempi sono pensati per le azioni di ricerca per parole chiave abilitate. Se la ricerca prodotti con AI sostituisce la ricerca per parole chiave, adatta le istruzioni alle azioni effettivamente abilitate in Settings > Actions (Impostazioni > Azioni), evitando di forzare uno strumento non disponibile. Utilizza la lingua dei prodotti del tuo negozio, non impostare automaticamente l'inglese. Le impostazioni del bot si salvano in automatico; attendi la conferma di salvataggio prima di eseguire i test.

Per WooCommerce

L'integrazione di WooCommerce mette a disposizione gli strumenti searchProducts, getProductCategories e searchProductBySku. Aggiungi queste istruzioni in Settings > Role & Behavior:

First, classify the user question into one of:
- PRODUCT-BY-SKU (user provides a SKU, reference number, or product code)
- PRODUCT-SPECIFIC (variant/price/availability/recommendation)
- ASSORTMENT-OVERVIEW (brands we carry, categories, "do you sell X at all", broad offer)

If PRODUCT-BY-SKU:
- Call searchProductBySku with the provided SKU or reference code.
- Return the product details to the user.

If PRODUCT-SPECIFIC:
- Call searchProducts(text) first using a concise query in the shop's product language.
- If results are empty/weak:
  1) Call getProductCategories(normalized noun) to choose best categoryId.
  2) Call searchProductsInCategory with the chosen category ID and search phrase to show a few items as examples.
- Answer using tool results as primary truth (name/price/availability). Use Knowledge Base only to add extra details if consistent.

If ASSORTMENT-OVERVIEW:
- Build the overview primarily from tools, then enrich using Knowledge Base:
  1) Call getProductCategories(normalized noun) to find relevant categoryIds.
  2) For up to 3-5 top categories, call searchProductsInCategory with the chosen category ID and search phrase.
  3) Aggregate from tool results; always label as non-exhaustive.
  4) Enrich the overview with Knowledge Base ONLY where it adds coverage the tools may miss.
- If tool results and KB conflict: prefer tool for concrete product facts; prefer KB for store-level statements.

Per Shopify

L'integrazione di Shopify include lo strumento searchProducts con un'opzione per mostrare solo i prodotti disponibili a magazzino. Attiva l'interruttore "In-stock only" nella configurazione dell'azione di ricerca prodotti di Shopify per escludere automaticamente gli articoli non disponibili. Aggiungi queste istruzioni:

First, classify the user question into one of:
- PRODUCT-SPECIFIC (variant/price/availability/recommendation)
- ASSORTMENT-OVERVIEW (brands we carry, categories, "do you sell X at all", broad offer)

If PRODUCT-SPECIFIC:
- Call searchProducts first using a concise query in the shop's product language.
- If results are empty/weak, try up to 3 reformulations (simplify, synonym, category).
- Answer using tool results as primary truth; use Knowledge Base only for relevant extra context.

If ASSORTMENT-OVERVIEW:
- Use Knowledge Base as the primary source.
- Do not rely on searchProducts for full lists; optionally call it only to provide a few examples and label them "examples".
- Always be explicit when a list is non-exhaustive (e.g., "Examples include ...").

Per PrestaShop

L'integrazione di PrestaShop supporta gli strumenti searchProducts e searchProductByReference. La ricerca per riferimento consente ai clienti di trovare i prodotti tramite SKU, codice a barre EAN-13, ISBN o codice MPN. Aggiungi queste istruzioni:

First, classify the user question into one of:
- PRODUCT-BY-REFERENCE (user provides a SKU, EAN barcode, ISBN, MPN, or reference code)
- PRODUCT-SPECIFIC (variant/price/availability/recommendation)
- ASSORTMENT-OVERVIEW (brands we carry, categories, "do you sell X at all", broad offer)

If PRODUCT-BY-REFERENCE:
- Call searchProductByReference with the provided reference code.
- Return the product details to the user.

If PRODUCT-SPECIFIC:
- Call searchProducts first using a concise query in the shop's product language.
- If results are empty/weak, try up to 3 reformulations (simplify, synonym, category).
- Answer using tool results as primary truth; use Knowledge Base only for relevant extra context.

If ASSORTMENT-OVERVIEW:
- Use Knowledge Base as the primary source.
- Do not rely on searchProducts for full lists; optionally call it only to provide a few examples and label them "examples".
- Always be explicit when a list is non-exhaustive (e.g., "Examples include ...").

Per Abicart, CS-Cart e Shoper

Queste integrazioni supportano la ricerca prodotti, ma i nomi delle azioni possono variare. Usa l'azione di ricerca prodotti abilitata al posto di searchProducts in questo esempio. Wix e BaseLinker al momento offrono la consultazione degli ordini, non la ricerca prodotti. Aggiungi queste istruzioni:

First, classify the user question into one of:
- PRODUCT-SPECIFIC (variant/price/availability/recommendation)
- ASSORTMENT-OVERVIEW (brands we carry, categories, "do you sell X at all", broad offer)

If PRODUCT-SPECIFIC:
- Call searchProducts first using a concise query in the shop's product language.
- If results are empty/weak, try up to 3 reformulations (simplify, synonym, category).
- Answer using tool results as primary truth; use Knowledge Base only for relevant extra context.

If ASSORTMENT-OVERVIEW:
- Use Knowledge Base as the primary source.
- Do not rely on searchProducts for full lists; optionally call it only to provide a few examples and label them "examples".
- Always be explicit when a list is non-exhaustive (e.g., "Examples include ...").

Come scansionare correttamente il tuo sito di e-commerce

Pianifica la scansione del tuo sito web suddividendola in porzioni anziché elaborarlo tutto insieme, così da mantenere un controllo maggiore. La scansione prevede due livelli di filtraggio: il filtraggio degli URL (quali pagine includere nell'allenamento) e il filtraggio degli elementi (quali sezioni di ogni pagina diventano contenuti). La checklist seguente elenca i punti essenziali.

1. Definisci l'ambito corretto di scansione - usa il filtro di esclusione URL:

   • Includi solo gli URL delle pagine di prodotto e categoria (ad es. /products/ e /collections/)
   • Escludi percorsi di scarso valore informativo come /blog/, /tags/ e pagine di archivio
   • Nei negozi multilingua, limita la scansione alla lingua principale

2. Escludi gli elementi ripetitivi - usa il filtro HTML Element Exclusion per intestazione, piè di pagina e barra laterale

3. Includi solo i contenuti rilevanti - usa CSS Selector Inclusion per concentrarti su descrizioni e specifiche dei prodotti, escludendo recensioni, valutazioni e sezioni dei prodotti simili

4. Usa la Sitemap, se disponibile - aiuta a individuare tutte le pagine di prodotti e categorie in modo più efficiente rispetto all'esplorazione automatica (crawling)

Per il metodo completo - spiegazione approfondita di entrambi i livelli di filtraggio, suddivisione consigliata tra allenamenti informativi e sui prodotti, e selettori di elementi pronti all'uso per WooCommerce, Shopify, PrestaShop, Magento, Shoper, CS-Cart e altri - consulta Allenare un bot su un negozio e-commerce senza integrazione. È una guida particolarmente utile quando non puoi (o non vuoi) abilitare un'integrazione.

Scopri di più su come ottimizzare la scansione del tuo sito: Come ridurre i caratteri di allenamento durante la scansione di un sito web

Funzionalità aggiuntive utili da abilitare

Offer Cards

Abilita questa impostazione in Settings > Model & Advanced per consentire al chatbot di mostrare schede prodotto corredate di nome, immagine e prezzo. Questo accorgimento migliora la resa visiva, soprattutto con le query API in tempo reale.

Aggiungi questa riga alle tue istruzioni personalizzate per evitare link duplicati:

If knowledge base provides URLs of the source information, provide them as comma separated list in the response as a reference - only after you have answered user's question in the conversation and only if the links are not included in the product list

Scopri di più: Offer Cards

Domande suggerite

Pre-imposta i pulsanti di risposta rapida (spedizioni, resi, orari di apertura) in Settings > Chat Conversation (Impostazioni > Conversazione chat). Abilita dynamic suggested follow-ups (domande di approfondimento dinamiche suggerite) per generare suggerimenti tramite AI.

Scopri di più: Follow-up dinamici suggeriti

Passaggio a un operatore umano

Attiva il modulo Contact Human (Contatta un operatore) e fornisci il tuo indirizzo email di supporto per gestire i passaggi di consegne.

Scopri di più: Modulo di contatto per supporto umano

Riepiloghi delle conversazioni e dei clienti

Se abilitata, ChatLab genera automaticamente un riepilogo per ogni conversazione e mantiene aggiornato un profilo di sintesi per i clienti che ritornano.

Scopri di più: Riepiloghi del chatbot e memoria

Chat Frontend API

Puoi trasmettere il contesto del visitatore, come l'ID utente o l'email, tramite la frontend API. I dati forniti dal browser non costituiscono una prova d'identità e non autorizzano automaticamente l'accesso alla cronologia ordini. Non esporre mai chiavi API del negozio o token di sicurezza privati nella configurazione del widget.

Scopri di più: Chat API

Configurazione della lingua

ChatLab supporta più di 90 lingue. Scopri di più: Configurazione della lingua del chatbot

Quando utilizzi l'integrazione con Shopify, WooCommerce o altre piattaforme di e-commerce, verifica in quale lingua il tuo sistema restituisce i prodotti. Aggiungi questa istruzione alle impostazioni di Role & Behavior:

When searching for products use [shop language] product and category names in singular form.

Monitora e ottimizza ogni giorno

Per assicurarti che ChatLab rimanga preciso ed efficace:

• Esamina regolarmente la cronologia delle conversazioni. Perfeziona le risposte o aggiungi contenuti dove il bot mostra incertezze. Scopri di più: Cronologia chat
• Abilita AI Conversation Insights per individuare pattern ricorrenti e problemi. Scopri di più: AI Conversation Insights
• Sfrutta il Daily Activity Report automatico. Scopri di più: Email di riepilogo giornaliero

Ottimizzare le risposte del chatbot

Anche i chatbot configurati al meglio traggono beneficio da una rifinitura periodica. Analizza la cronologia delle conversazioni per individuare punti deboli, richieste fraintese o risposte di ripiego ripetitive. Perfeziona i prompt, aggiorna i materiali di allenamento e sperimenta con le istruzioni di sistema.

Scopri di più: Come migliorare le risposte del chatbot

Articoli correlati

• Aggiungere il chatbot al tuo sito web
• Allenare un bot su un negozio e-commerce senza integrazione
• Integrazione con un feed di prodotti