Collega il tuo chatbot ChatLab al tuo negozio WooCommerce per consentire ai clienti di trovare prodotti e controllare i propri ordini direttamente nella chat. I prodotti vengono trovati tramite AI Search, che cerca nel tuo catalogo WooCommerce indicizzato in base al significato, oppure tramite la ricerca in tempo reale nel negozio, che interroga l'API del negozio.
Esempio di conversazione
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 del cliente. Le azioni disponibili e le informazioni restituite dipendono da questa integrazione e dalla tua configurazione.
Importante: best practice per l'e-commerce
Dopo aver completato l'integrazione descritta di seguito, leggi la guida completa sull'ottimizzazione del tuo chatbot per l'e-commerce: Come configurare ChatLab per il tuo negozio e-commerce
Come il chatbot trova i prodotti su WooCommerce: AI Search e ricerca live nel negozio
Ci sono due modi in cui un chatbot ChatLab trova i prodotti in un negozio WooCommerce. Un chatbot usa l'uno o l'altro, mai entrambi.
AI Search (consigliato) - ChatLab mantiene un proprio indice del tuo catalogo WooCommerce e il chatbot vi cerca all'interno in base al significato.
- I clienti chiedono in linguaggio naturale, ad esempio "un abito rosso sotto i 300". Una fascia di prezzo viene applicata come filtro rigoroso e vengono associati anche i codici prodotto esatti (SKU, EAN).
- Prezzo, disponibilità e varianti vengono letti in tempo reale da WooCommerce al momento della risposta, quindi i clienti vedono dati aggiornati anche tra un aggiornamento e l'altro dell'indice.
- I risultati compaiono come schede prodotto nella chat, fino a 5 per risposta.
- L'indicizzazione si avvia da sola quando il negozio viene collegato. Il catalogo non consuma caratteri di addestramento.
- Piano necessario: ogni piano E-commerce la include (Free 100 prodotti, Start 2.000, Grow 5.000, Scale 20.000). Su un piano Universal, aggiungi il componente aggiuntivo Integrazioni e-commerce ($30 al mese) più un pacchetto di prodotti AI Search ($29 al mese, 5.000 prodotti) assegnato al chatbot.
Ricerca live nel negozio - il chatbot trasmette la frase del cliente alla ricerca di WooCommerce tramite l'API del negozio e risponde con ciò che il negozio restituisce.
- Nulla viene indicizzato e nulla deve essere sincronizzato. I dati sono sempre in tempo reale.
- Si tratta di una ricerca per parole chiave: trova ciò che la ricerca stessa del tuo negozio troverebbe per quella frase. Non comprende descrizioni di esigenze, sinonimi o refusi come fa AI Search.
- Piano necessario: un piano Universal con il componente aggiuntivo Integrazioni e-commerce ($30 al mese). Non è necessario alcun pacchetto di prodotti.
Quando AI Search è attiva, sostituisce la ricerca live nel negozio. Lo stato dell'ordine funziona allo stesso modo su entrambi i percorsi. Una terza opzione, l'addestramento su pagine scansionate del negozio, è disponibile su qualsiasi piano ed è pensata per contenuti informativi come consegne e resi, non per i prodotti. Per un confronto completo vedi AI Search: how your chatbot finds products e per i limiti sui prodotti vedi E-commerce plans and limits.
Cosa offre l'integrazione
Ricerca in tempo reale nel negozio (ricerca prodotti per frase) - Il chatbot invia la frase del cliente alla ricerca di WooCommerce. Cerca tra i titoli e le descrizioni dei prodotti, restituendo i primi 5 prodotti pubblicati corrispondenti con:
- ID prodotto, nome e descrizione
- Prezzo e SKU
- Immagine del prodotto e link diretto alla pagina del prodotto
Ricerca prodotti per SKU - I clienti possono cercare i prodotti utilizzando uno SKU specifico, un numero di riferimento o un codice prodotto. Questo è utile quando i clienti conoscono già l'identificatore esatto del prodotto - ad esempio da un catalogo cartaceo, da un ordine precedente o da una raccomandazione. Restituisce gli stessi campi prodotto della ricerca standard.
Ricerca prodotti per categoria - Una ricerca più mirata che combina una parola chiave con una specifica categoria di prodotti. Il chatbot identifica prima la categoria corretta, quindi cerca al suo interno i prodotti corrispondenti. Restituisce gli stessi campi prodotto della ricerca standard.
Recupero categorie - Il chatbot può recuperare un elenco delle categorie di prodotti disponibili nel tuo negozio, aiutando i clienti a navigare nel catalogo o a restringere le ricerche dei prodotti. Ciascuna categoria include:
- ID categoria, nome e slug
- Descrizione della categoria
Dettagli dell'ordine - Come impostazione predefinita, i clienti forniscono un ID ordine e l'indirizzo e-mail corrispondente. Questo verifica i dati forniti confrontandoli con i record del negozio, ma non costituisce una prova che il visitatore sia il proprietario dell'e-mail. Un'impostazione opzionale dell'azione consente la ricerca tramite il solo ID ordine. Il chatbot restituisce:
- Numero d'ordine, totale e stato (es. in lavorazione, completato, annullato)
- Indirizzo di spedizione con nome e cognome del destinatario, azienda, indirizzo completo (via, città, provincia/stato, codice postale, paese)
- Articoli ordinati con nomi, quantità, prezzi singoli e totali di riga
Prerequisiti
Prima di iniziare l'integrazione con WooCommerce, assicurati che:
- Il tuo chatbot sia stato creato in ChatLab. L'installazione del widget nel negozio è un passaggio separato rispetto al collegamento dei dati del negozio.
- Tu abbia accesso al pannello di amministrazione WordPress del tuo negozio WooCommerce
Scelta consigliata: connessione con il plugin WordPress
In Connect > WooCommerce (Collega > WooCommerce), scegli Get the WooCommerce plugin (Ottieni il plugin WooCommerce) per la configurazione guidata. Installa il plugin ChatLab, apri il relativo menu in WordPress, mantieni selezionata l'opzione Connect WooCommerce integration (Collega l'integrazione WooCommerce) e fai clic su Continue (Continua). Accedi a ChatLab e seleziona il tuo chatbot. In questo modo collegherai il tuo negozio e installerai il widget. Consulta la guida all'installazione su WordPress.
Scegli Continue with manual setup (Continua con la configurazione manuale) se devi utilizzare le tue chiavi API. I passaggi seguenti descrivono questa alternativa.
Passaggio 1: genera le chiavi API in WooCommerce
- Accedi al pannello di amministrazione di WordPress
- Vai su WooCommerce > Settings (WooCommerce > Impostazioni)
- Fai clic sulla scheda Advanced (Avanzate)
- Seleziona REST API
- Fai clic su Add Key (Aggiungi chiave)
- Inserisci una descrizione (ad es. "Integrazione ChatLab")
- Seleziona l'utente a cui assegnare la chiave - deve essere un utente con ruolo Administrator (Amministratore) o Shop Manager (Gestore negozio); gli altri ruoli come Customer o Subscriber non dispongono dei permessi necessari per accedere ai dati di WooCommerce
- Imposta i permessi su Read (Lettura)
- Fai clic su Generate API Key (Genera chiave API)
- Copia la Consumer Key e il Consumer Secret - conservali in modo sicuro, poiché il Consumer Secret non potrà più essere visualizzato
Passaggio 2: collega WooCommerce in ChatLab
- Accedi a ChatLab e seleziona il tuo bot
- Vai alla scheda Connect (Collega)
- Fai clic su Connect (Collega) nel riquadro di WooCommerce
- Inserisci l'URL of WooCommerce store (URL del negozio WooCommerce, ovvero l'URL completo del tuo negozio, ad es.
https://www.mystore.com) - Inserisci la Customer Key (la Consumer Key ottenuta al Passaggio 1)
- Inserisci il Customer Secret (il Consumer Secret ottenuto al Passaggio 1)
- Fai clic su Connect (Collega)
ChatLab testa automaticamente la connessione verificando che le tue credenziali API dispongano dei permessi necessari. Se l'operazione va a buon fine, visualizzerai un messaggio di conferma.
Opzioni di connessione
Il modulo di connessione di WooCommerce include impostazioni aggiuntive:
- Use order search instead of retrieve - Attiva questa opzione se il tuo negozio utilizza plugin per la numerazione personalizzata degli ordini. Utilizza una ricerca basata su query anziché il recupero diretto, risultando compatibile con i numeri d'ordine modificati.
- Use product short description - Se abilitata, i risultati della ricerca prodotti restituiscono la descrizione breve di WooCommerce anziché la descrizione completa. Utile per i negozi con descrizioni di prodotto molto lunghe.
- Include in-stock products only - Se abilitata, i risultati della ricerca includono solo gli articoli attualmente disponibili a magazzino.
- Store language - Scegli la lingua dei dati dei tuoi prodotti.
- Custom metadata fields - Includi solo i campi di prodotto utili per i clienti; non esporre metadati privati.
- Maximum variants - Limita il numero di varianti restituite per ciascun prodotto.
Passaggio 3: configura le azioni di WooCommerce
Dopo il collegamento, puoi abilitare e personalizzare le singole azioni AI. Vai su Settings > Actions (Impostazioni > Azioni) e filtra per la piattaforma WooCommerce.
Le azioni per parole chiave e ordini includono:
- WooCommerce - Product Search - consente al chatbot di cercare nel catalogo prodotti tramite parola chiave
- WooCommerce - Product Search by SKU - consente al chatbot di trovare i prodotti tramite SKU, codice di riferimento o codice prodotto
- WooCommerce - Product Search in Category - consente al chatbot di cercare all'interno di una specifica categoria di prodotti
- WooCommerce - Get Categories - consente al chatbot di elencare le categorie di prodotti del tuo negozio
- WooCommerce - get product variants - recupera le varianti disponibili di un prodotto selezionato
- WooCommerce - Get Order - consente al chatbot di cercare le informazioni sull'ordine tramite ID ordine ed email
La configurazione iniziale della connessione abilita la ricerca ordini, le categorie, la ricerca per parole chiave, la ricerca per categoria e le varianti. L'azione Product Search by SKU deve essere verificata e abilitata separatamente se desideri utilizzarla. Disattiva le azioni 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) e le istruzioni che guidano l'AI nell'uso di ciascuna azione.
Opzioni per la ricerca ordini e la ricerca prodotti
Nella configurazione dell'azione per gli ordini, l'opzione Allow order lookup without email verification è disattivata per impostazione predefinita. La sua attivazione espone i dettagli dell'ordine a chiunque sia in grado di fornire un ID ordine valido. Lasciala disattivata a meno che la tua installazione non disponga di adeguati controlli di accesso.
Il plugin WooCommerce di ChatLab supporta anche campi di prodotto ricercabili estesi e la corrispondenza approssimativa (fuzzy) degli SKU. Queste opzioni richiedono l'estensione del plugin rilevata; in sua assenza, la ricerca per parole chiave utilizza la ricerca nativa di WooCommerce e la ricerca per SKU utilizza la corrispondenza esatta. Verifica la relativa azione di ricerca prodotti prima di redigere istruzioni che dipendono da queste opzioni.
AI Search per WooCommerce: catalogo, reindicizzazione e impostazioni
Su un piano E-commerce, oppure su un piano Universal quando al chatbot è assegnato un pacchetto di prodotti AI Search, AI Search è attivo e sostituisce la ricerca in tempo reale nel negozio. L'indicizzazione si avvia automaticamente al collegamento del negozio.
- Controlla il catalogo - apri Training > E-commerce catalog (Catalogo e-commerce) e controlla le schede Products (Prodotti) e Categories (Categorie). Shop > Products mostra il pannello Product catalog (Catalogo prodotti) e la scheda AI Search packs on this chatbot (Pacchetti AI Search su questo chatbot).
- Pianifica la reindicizzazione - usa Schedule auto-retrain (Pianifica riaddestramento automatico) in Training > E-commerce catalog. La reindicizzazione può essere eseguita anche ogni giorno ed è disponibile su ogni piano E-commerce e con ogni pacchetto di prodotti. Train now (Addestra ora) o Retrain (Riaddestra) la esegue su richiesta. Gli aggiornamenti sono incrementali: i prodotti non modificati vengono saltati e i prodotti rimossi vengono eliminati dall'indice.
- Controlla l'azione - in Settings > Actions (Impostazioni > Azioni), apri WooCommerce - 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 Enable Offer Cards (Abilita Offer Cards) in Settings > Model & Advanced (Impostazioni > Modello e avanzate). Vedi Offer Cards.
Quando il catalogo supera il limite di prodotti, l'indicizzazione si interrompe al raggiungimento del limite e il proprietario del chatbot riceve un'e-mail. 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 Overview (Panoramica) e prova a scrivere:
- "Mostrami le scarpe da corsa" (testa la ricerca prodotti)
- "Sto cercando il prodotto con SKU WH-1234" (testa la ricerca prodotti per SKU)
- "Quali categorie avete?" (testa il recupero delle categorie)
- "Mostrami le scarpe nella categoria Abbigliamento sportivo" (testa la ricerca prodotti per categoria)
- "Qual è lo stato del mio ordine #1001?" (testa i dettagli dell'ordine; inserisci l'email corrispondente per un ordine a cui sei autorizzato ad accedere)
Verifica che le risposte corrispondano ai dati del tuo negozio WooCommerce e che i link ai prodotti si aprano correttamente.
Installare il chatbot sul tuo negozio WooCommerce
Per aggiungere il widget di chat al tuo sito WordPress/WooCommerce, consulta la guida dettagliata: Installare il chatbot su un negozio WooCommerce
Guarda la demo
Puoi vedere una dimostrazione pratica dell'integrazione con WooCommerce: https://yourwear.chatlab.com/shop