Collega il tuo chatbot ChatLab al tuo negozio CS-Cart in modo che i clienti possano trovare i prodotti e controllare i loro ordini direttamente nella chat. I prodotti vengono trovati tramite AI Search, che cerca nel tuo catalogo CS-Cart indicizzato in base al significato, oppure tramite la ricerca in tempo reale nel negozio, che interroga l'API dello store. Il modo più rapido per eseguire il collegamento è l'add-on ChatLab per CS-Cart, che aggiunge anche il widget di chat alla tua vetrina. Il collegamento manuale con una chiave API rimane comunque disponibile come alternativa.
Conversazione di esempio
Controlla un ordine
Richiede un negozio collegato e l'azione sugli ordini abilitata. I campi disponibili dipendono dall'integrazione. La corrispondenza di un indirizzo email non costituisce prova di identità.
Visitatore: Dov'è il mio ordine?
Riproduci l'esempio o leggilo qui sotto. Non viene utilizzato alcun dato reale dei clienti.Il cliente chiede informazioni su un ordine esistente.
La riproduzione va in pausa quando questo esempio esce dallo schermo. Questa è una simulazione, non una chat dal vivo. I comandi del widget all'interno della riproduzione non sono interattivi.Leggi l'esempio completo
- Il cliente chiede informazioni su un ordine esistente.
Visitatore: Dov'è il mio ordine?
- La ricerca predefinita richiede entrambi gli identificativi.
Assistente: Per favore forniscimi il numero dell'ordine e l'indirizzo email utilizzato al checkout.
- Usa dati fittizi in questo esempio.
Visitatore: 41982, anna@example.com
- L'azione interroga il negozio collegato.
Controllo l'ordine 41982...
- Riporta solo le informazioni restituite dal negozio.
Assistente: L'ordine 41982 risulta contrassegnato come spedito. Il corriere è DPD. Controlla la pagina di tracciamento per gli aggiornamenti sulla consegna.
L'esempio illustra l'esperienza per il cliente. Le azioni disponibili e le informazioni restituite dipendono da questa integrazione e dalla tua configurazione.
Prima di iniziare
Per prima cosa crea o seleziona un chatbot. Devi avere i permessi per gestire le sue integrazioni e l'accesso alle impostazioni di connessione dell'account esterno. Se il riquadro Connect (Collega) mostra un invito all'upgrade o a contattare l'assistenza, verifica che il tuo abbonamento includa questa integrazione. Mantieni private le credenziali API; non incollarle mai nel codice di incorporamento del sito web.
Per l'add-on hai bisogno di CS-Cart 4.18.1 o versione successiva e di un account amministratore CS-Cart abilitato a installare add-on e a gestire amministratori e gruppi di utenti. L'add-on è progettato per l'edizione standard di CS-Cart, non per Multi-Vendor.
Importante: best practice per l'e-commerce
Dopo aver completato l'integrazione descritta di seguito, leggi la guida completa su come ottimizzare il tuo chatbot per l'e-commerce: Come configurare ChatLab per il tuo negozio di e-commerce
Come il chatbot trova i prodotti su CS-Cart: AI Search e ricerca in tempo reale nel negozio
Esistono due modi in cui un chatbot ChatLab trova i prodotti in un negozio CS-Cart. Il chatbot usa l'uno o l'altro, mai entrambi contemporaneamente.
AI Search (consigliato) - ChatLab mantiene un proprio indice del tuo catalogo CS-Cart e il chatbot vi effettua ricerche in base al significato.
- I clienti pongono domande in linguaggio naturale, ad esempio "un vestito rosso sotto i 300". Un intervallo di prezzo viene applicato come filtro rigoroso e vengono associati anche i codici prodotto esatti (SKU, EAN).
- Prezzo, disponibilità e varianti vengono letti in tempo reale da CS-Cart al momento della risposta, così i clienti vedono dati aggiornati anche tra un aggiornamento dell'indice e l'altro.
- I risultati appaiono come schede prodotto nella chat, fino a un massimo di 5 per risposta.
- L'indicizzazione si avvia automaticamente non appena il negozio viene collegato. Il catalogo non consuma caratteri di addestramento.
- Piano necessario: è incluso in ogni piano E-commerce (Free 100 prodotti, Start 2.000, Grow 5.000, Scale 20.000). Su un piano Universal, aggiungi l'add-on E-commerce integrations ($30 al mese) più un pacchetto prodotti AI Search ($29 al mese, 5.000 prodotti) assegnato al chatbot.
Ricerca in tempo reale nel negozio - il chatbot trasmette la frase del cliente alla ricerca di CS-Cart tramite l'API del negozio e risponde con ciò che il negozio restituisce.
- Nulla viene indicizzato e non occorre mantenere nulla sincronizzato. I dati sono sempre aggiornati in tempo reale.
- Si tratta di una ricerca per parole chiave: trova ciò che troverebbe la ricerca integrata del tuo negozio per quella frase. Non comprende le descrizioni di un'esigenza, i sinonimi o i refusi come fa invece AI Search.
- Piano necessario: un piano Universal con l'add-on E-commerce integrations ($30 al mese). Non è necessario alcun pacchetto prodotti.
Quando AI Search è attiva, sostituisce la ricerca in tempo reale nel negozio. Lo stato dell'ordine funziona allo stesso modo con entrambi i metodi. Una terza opzione, l'addestramento sulle pagine scansionate del negozio, è disponibile su qualsiasi piano ed è pensata per contenuti informativi come spedizioni e resi, non per i prodotti. Per un confronto completo vedi AI Search: come il chatbot trova i prodotti, e per i limiti di prodotti consulta Piani e limiti e-commerce.
Cosa offre l'integrazione
Ricerca in tempo reale nel negozio (ricerca di prodotti per frase) - Il chatbot invia la frase del cliente alla ricerca di CS-Cart e restituisce i prodotti corrispondenti completi di:
- Nome e descrizione del prodotto
- Prezzo
- SKU (codice prodotto)
- Link diretto al prodotto nel tuo negozio
- Immagine del prodotto
- Varianti disponibili (taglie, colori, ecc.)
Puoi configurare quali campi del prodotto includere nella ricerca (nome, descrizione breve, descrizione completa, parole chiave) e quanti risultati restituire.
Dettagli dell'ordine - I clienti possono verificare lo stato dell'ordine fornendo l'ID ordine e il proprio indirizzo email. Il chatbot restituisce:
- Stato dell'ordine
- Articoli ordinati con nomi, prezzi, quantità, immagini del prodotto e varianti scelte
- Totale dell'ordine e spese di spedizione
- Corriere di spedizione, codice di tracciamento e stato della spedizione
- Nome del destinatario e indirizzo di consegna completo
- Telefono del cliente
Consigliato: collegamento con l'add-on ChatLab
L'add-on ChatLab per CS-Cart è il modo più semplice per effettuare la connessione. Un add-on è un'estensione da installare nel pannello di amministrazione di CS-Cart. Questo componente collega il tuo negozio al chatbot (ricerca prodotti e stato dell'ordine) e aggiunge il widget di chat alla tua vetrina in un unico passaggio, senza dover copiare chiavi. Lo scarichi da ChatLab come file .tgz e lo carichi nel tuo negozio.
Scarica l'add-on
Seleziona il tuo chatbot e vai su Test & Deploy (Testa e pubblica). Nella sezione Deploy (Pubblica), espandi Online store platforms (Piattaforme di e-commerce) e fai clic su CS-Cart. La scheda Plugin Installation (Installazione plugin) è selezionata per impostazione predefinita. Fai clic su Download the ChatLab add-on (.tgz) (Scarica l'add-on ChatLab (.tgz)).
Il browser salverà l'add-on con il nome chatlab.tgz. Non decomprimerlo: CS-Cart ha bisogno dell'archivio così com'è. Il pulsante scarica sempre la versione attuale dell'add-on (1.0.2 al momento della stesura).
Lo stesso pulsante di download è disponibile in altri due punti:
- Scheda Connect (Collega) - fai clic su Connect (Collega) nel riquadro CS-Cart. Si aprirà la finestra di dialogo CS-Cart Integration (Integrazione CS-Cart) con le istruzioni dell'add-on e il pulsante Download the ChatLab add-on (.tgz). Su un piano E-commerce, lo stesso riquadro si trova anche nella scheda Shop (Negozio) sotto Connect your store (Collega il tuo negozio).
- Procedura guidata di configurazione - quando crei un chatbot e scegli CS-Cart come piattaforma, il passaggio Connect CS-Cart (Collega CS-Cart) mostra il metodo Plugin or app (Plugin o app) con lo stesso link Download the ChatLab add-on (.tgz).
Installa l'add-on in CS-Cart
- Accedi al pannello di amministrazione di CS-Cart.
- Vai su Add-ons > Downloaded add-ons (Add-on > Add-on scaricati).
- Apri il menu a ingranaggio e scegli Manual installation (Installazione manuale).
- Carica il file
chatlab.tgzscaricato. CS-Cart installerà l'add-on.
Collega il tuo negozio
- Nel pannello di amministrazione di CS-Cart, vai su Marketing > ChatLab AI Chatbot.
- Fai clic su Continue (Continua). Si aprirà una nuova scheda del browser con ChatLab.
- Accedi con il tuo account ChatLab, oppure creane uno, e quando richiesto scegli il chatbot da assegnare a questo negozio.
- Verrai reindirizzato automaticamente a CS-Cart. La pagina mostrerà ChatLab is connected (ChatLab è collegato), il tuo account ChatLab, il nome del chatbot e una Live preview (Anteprima in tempo reale) del chatbot.
- Apri la tua vetrina e invia un messaggio di prova. Per verificare i dati del negozio, chiedi informazioni anche su un prodotto e su un ordine che puoi controllare nel pannello di amministrazione.
Se hai iniziato dalla procedura guidata di configurazione di ChatLab, torna a quella scheda del browser. Mostrerà la dicitura Waiting for the connection... (In attesa della connessione...) e proseguirà da sola una volta collegato il negozio.
Se CS-Cart segnala che la richiesta di connessione non è valida o è scaduta, la tua sessione su CS-Cart è terminata mentre accedevi a ChatLab. Apri di nuovo Marketing > ChatLab AI Chatbot e fai clic ancora una volta su Continue.
Cosa configura l'add-on
- Connessione al negozio - l'add-on crea nel tuo negozio un utente API dedicato di sola lettura. L'utente appartiene a un gruppo di utenti denominato ChatLab API e può visualizzare solo catalogo, ordini, lingue e stati degli ordini. La tua chiave API di amministratore non viene modificata. La ricerca dei prodotti e i dettagli dell'ordine vengono abilitati automaticamente per il chatbot.
- Widget di chat - il widget viene aggiunto a ogni pagina della vetrina, senza dover incollare alcun codice. Se il tuo negozio utilizza la gestione del consenso dei cookie dell'add-on GDPR di CS-Cart, il widget viene elencato come servizio funzionale e rispetta la scelta di ciascun visitatore.
- Lingua del catalogo - a partire dalla versione 1.0.2, l'add-on invia la lingua predefinita della tua vetrina, in modo che il chatbot legga i nomi dei prodotti, le descrizioni e le categorie nella lingua che vedono i tuoi clienti. ChatLab la mostra come Shop Language (Lingua del negozio) nella finestra di dialogo CS-Cart Integration. Se avevi già scelto manualmente una lingua per questo negozio, tale scelta verrà mantenuta.
- Valuta del negozio - a partire dalla versione 1.0.2, l'add-on invia anche la valuta principale del tuo negozio, così i prezzi nella chat conterranno la valuta corretta. ChatLab la mostra come Shop currency (Valuta del negozio) nella stessa finestra, contrassegnata da Sent by the ChatLab add-on (Inviata dall'add-on ChatLab). Se hai impostato una valuta a mano, questa verrà mantenuta.
Per controllare queste impostazioni in ChatLab, seleziona il tuo chatbot, apri la scheda Connect e fai clic su Modify (Modifica) nel riquadro CS-Cart. Quando AI Search è attiva per il chatbot, l'indicizzazione del catalogo si avvia automaticamente dopo la connessione del negozio.
La connessione al negozio CS-Cart è disponibile come funzionalità a pagamento. Se il tuo piano non la include, l'add-on aggiungerà comunque il widget di chat alla tua vetrina, ma la ricerca prodotti e lo stato dell'ordine rimarranno disattivati fino al passaggio a un piano superiore.
Se in precedenza avevi incollato il codice del widget ChatLab nel tuo tema, gli acquirenti vedranno due widget di chat. La pagina dell'add-on ti avviserà con il messaggio A ChatLab widget is already on your storefront (Un widget ChatLab è già presente sulla tua vetrina). Rimuovi il codice dal tuo tema, oppure deseleziona l'opzione Show the chat widget on the storefront (Mostra il widget di chat sulla vetrina) nella sezione Storefront widget (Widget della vetrina) e fai clic su Save (Salva).
Aggiornamento da una versione precedente
Le versioni precedenti alla 1.0.2 non inviano la lingua del catalogo e la valuta del negozio. Per aggiornare:
- Scarica l'add-on aggiornato da ChatLab come descritto sopra.
- Nel pannello di amministrazione di CS-Cart, vai su Add-ons > Downloaded add-ons, scegli Manual installation dal menu a ingranaggio, carica il nuovo file
chatlab.tgze fai clic su Upload & install (Carica e installa). - CS-Cart rileverà che l'add-on è già installato e ti chiederà come procedere per sostituirlo. Fai clic su Use the safe way (Usa la procedura sicura): CS-Cart disinstallerà la vecchia versione e installerà quella nuova. Le impostazioni dell'add-on in CS-Cart verranno rimosse, quindi il negozio non risulterà più collegato.
- Apri Marketing > ChatLab AI Chatbot, fai clic su Continue, accedi a ChatLab e seleziona di nuovo lo stesso chatbot. In questo momento l'add-on invierà la lingua del catalogo e la valuta del negozio.
Il tuo account ChatLab, il chatbot e le conversazioni rimarranno invariati durante la disconnessione e la successiva riconnessione. In alternativa alla riconnessione, puoi anche impostare Shop Language e la valuta manualmente nella finestra di dialogo CS-Cart Integration su ChatLab.
Disattivare il widget, disconnettere o disinstallare
- Nascondere solo il widget - in Marketing > ChatLab AI Chatbot, deseleziona Show the chat widget on the storefront e fai clic su Save. Il negozio rimane collegato.
- Disconnettere il negozio - nella stessa pagina, fai clic su Disconnect (Disconnetti) e conferma. Il chatbot smetterà di essere visibile sulla vetrina, la connessione al negozio verrà disattivata per il chatbot e la chiave API dell'utente di sola lettura sarà revocata. Il tuo account ChatLab e i dati del chatbot rimarranno disponibili in ChatLab.
- Disinstallare l'add-on - disinstalla ChatLab in Add-ons > Downloaded add-ons. Questa operazione rimuoverà dal tuo negozio anche l'utente API di sola lettura e il relativo gruppo di utenti.
- Disconnettere in ChatLab - apri la scheda Connect, fai clic su Modify nel riquadro CS-Cart e fai clic su Disconnect. Questo disattiva la ricerca prodotti e lo stato dell'ordine solo sul lato ChatLab. Per rimuovere anche il widget dalla tua vetrina, effettua la disconnessione in CS-Cart.
Alternativa: collegamento con una chiave API
Se non puoi o non vuoi installare l'add-on, puoi collegare il negozio manualmente con una chiave API di CS-Cart seguendo i passaggi da 1 a 3 riportati di seguito. Non creare una seconda connessione se l'add-on ha già collegato il negozio. Con questo metodo il widget di chat non viene aggiunto automaticamente alla tua vetrina: aggiungilo a mano come descritto in Installa il chatbot sul tuo negozio CS-Cart alla fine di questo articolo.
Passaggio 1: abilita l'accesso API in CS-Cart
- Accedi al pannello di amministrazione di CS-Cart
- Vai su Customers > Administrators (Clienti > Amministratori)
- Fai clic sull'account amministratore che verrà utilizzato per la connessione API
- Passa alla scheda API access (Accesso API)
- Seleziona "Yes, allow this user to use the API" ("Sì, consenti a questo utente di utilizzare l'API")
- Fai clic su Save
- Copia la chiave API mostrata dopo il salvataggio e conservala in un luogo sicuro
- Prendi nota dell'indirizzo email associato a questo account amministratore
Passaggio 2: collega CS-Cart in ChatLab
- Accedi a ChatLab e seleziona il tuo chatbot
- Vai alla scheda Connect e fai clic su Connect nel riquadro CS-Cart
- La finestra di dialogo CS-Cart Integration suggerisce prima l'add-on. Fai clic su Continue manual setup (Continua con la configurazione manuale) per aprire il modulo di connessione
- Inserisci la tua API Key (Chiave API ottenuta al Passaggio 1)
- Inserisci la tua CS-Cart Account Email (l'email dell'amministratore con accesso API)
- Inserisci il tuo CS-Cart Shop URL (URL del negozio CS-Cart, ad es.
https://yourstore.com) - Sotto Shop Language, fai clic su Load languages (Carica lingue) e scegli la lingua del tuo catalogo prodotti. Questa operazione è obbligatoria se il negozio è multilingua. I nomi dei prodotti, le descrizioni e le categorie vengono letti dal negozio in questa lingua; modificarla in seguito comporterà la reindicizzazione dell'intero catalogo prodotti
Puoi anche configurare le opzioni di ricerca:
- Searchable fields (Campi ricercabili) - attiva o disattiva i campi del prodotto in cui il chatbot deve cercare (CS-Cart Product name, CS-Cart Short description, CS-Cart Full description, CS-Cart Keywords)
- Number of search results (Numero di risultati di ricerca) - quanti prodotti restituire per query (predefinito: 5)
- Fai clic su Connect
Una volta completata la connessione, visualizzerai un messaggio di conferma con l'opzione per configurare le azioni IA. Riaprendo la finestra di dialogo in un secondo momento tramite Modify, vedrai anche Shop currency, la valuta letta dal tuo negozio. Se è assente o errata, fai clic su Set the currency manually (Imposta la valuta manualmente) e inserisci il codice valuta a tre lettere, ad esempio EUR.
Passaggio 3: configura le azioni CS-Cart
Dopo la connessione, abilita e personalizza le singole azioni IA. Vai su Settings > Actions (Impostazioni > Azioni) e filtra per la piattaforma CsCart.
Le azioni standard includono:
- CsCart - product search - consente al chatbot di cercare nel tuo catalogo prodotti
- CsCart - order details - consente al chatbot di recuperare le informazioni sugli ordini
La procedura di connessione abilita le azioni standard. Controlla il loro stato e disattiva quelle che non vuoi mettere a disposizione dei clienti. Apri un'azione per modificarla, quindi usa Enable (Abilita) o Update (Aggiorna) nella relativa finestra di dialogo. Puoi anche personalizzare l'etichetta dell'azione (il messaggio mostrato agli utenti durante l'esecuzione dell'azione) e le istruzioni che guidano il modo in cui l'IA utilizza ciascuna azione.
AI Search per CS-Cart: catalogo, reindicizzazione e impostazioni
Su un piano E-commerce, o su un piano Universal quando al chatbot è assegnato un pacchetto prodotti AI Search, AI Search è attiva e sostituisce la ricerca in tempo reale nel negozio. L'indicizzazione si avvia automaticamente non appena il negozio viene collegato.
- Verifica il catalogo - apri Training > E-commerce catalog (Addestramento > Catalogo e-commerce) e controlla le schede Products (Prodotti) e Categories (Categorie). Shop > Products mostra il riquadro Product catalog e la scheda AI Search packs on this chatbot (Pacchetti AI Search su questo chatbot).
- Pianifica la reindicizzazione - usa l'opzione Schedule auto-retrain (Pianifica riaddestramento automatico) in Training > E-commerce catalog. La reindicizzazione può essere eseguita anche giornalmente ed è disponibile in ogni piano E-commerce e con ogni pacchetto prodotti. Train now (Addestra ora) o Retrain (Riaddestra) la avvia su richiesta. Gli aggiornamenti sono incrementali: i prodotti rimasti invariati vengono saltati e i prodotti rimossi vengono eliminati dall'indice.
- Controlla l'azione - in Settings > Actions, apri CsCart - AI product search. Le sue opzioni sono Include product card (Includi scheda prodotto), Products in stock only (Solo prodotti disponibili) e Number of products to return (Numero di prodotti da restituire).
- Mostra le schede prodotto - attiva l'opzione Enable Offer Cards in Settings > Model & Advanced (Impostazioni > Modello e avanzate). Vedi Offer Cards.
Se le dimensioni del catalogo superano il limite di prodotti previsto, l'indicizzazione si arresta al raggiungimento del limite e il proprietario del chatbot riceve un'email. Le opzioni dell'azione di ricerca in tempo reale nel negozio descritte sopra non si applicano necessariamente ad AI Search.
Testare l'integrazione
Dopo aver attivato le azioni, apri Test & Deploy e prova a digitare:
- "Mostrami i guanti da allenamento" (testa la ricerca prodotti)
- "Qual è lo stato del mio ordine 12345?" (testa i dettagli dell'ordine; inserisci l'email corrispondente a un ordine a cui sei autorizzato ad accedere)
Verifica che le risposte corrispondano ai dati presenti nel tuo negozio CS-Cart.
Consigli per la configurazione della ricerca
- Abilita Product name e Short description per ottenere il miglior equilibrio tra velocità e precisione
- Aggiungi Keywords se i tuoi prodotti includono metadati ricchi di parole chiave
- Abilita Full description solo se i campi più brevi non restituiscono buoni risultati - potrebbe rallentare le ricerche
- Inizia con 5 risultati per query e regolati in base alle dimensioni del tuo catalogo
Installa il chatbot sul tuo negozio CS-Cart
Se hai effettuato il collegamento con l'add-on, salta questa sezione - il widget si trova già sulla tua vetrina. Se hai effettuato il collegamento con una chiave API, aggiungi autonomamente il widget di chat alla tua vetrina CS-Cart:
- In ChatLab, vai alla scheda Test & Deploy (Testa e pubblica) del tuo chatbot
- Espandi Online store platforms (Piattaforme e-commerce), fai clic su CS-Cart e apri la scheda Manual Installation (Installazione manuale)
- Fai clic su Copy to clipboard (Copia negli appunti) per copiare lo snippet di codice
- Nel pannello di amministrazione di CS-Cart, vai su Design > Layouts (Design > Layout)
- Aggiungi un HTML block (blocco HTML) nel layout predefinito e incolla lo snippet del widget nella sua scheda Content (Contenuto)
- Salva le modifiche al blocco e al layout. Controlla le pagine con layout separati, come il checkout, e tutte le lingue della vetrina
Se utilizzi un blocco HTML con supporto Smarty, racchiudi lo snippet tra {literal} e {/literal}. Consulta le istruzioni di CS-Cart per il codice personalizzato. Apri la vetrina pubblicata e verifica il widget su desktop e mobile.
Il codice mostra solo il widget di chat. La ricerca prodotti e lo stato degli ordini provengono dalla connessione al negozio: l'add-on oppure la connessione tramite chiave API nella scheda Connect (Connetti).