Collega il tuo chatbot ChatLab al tuo negozio Shoper 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 Shoper indicizzato in base al significato, oppure tramite la ricerca in tempo reale nel negozio, che interroga l'API dello store.
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 qui sotto, 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 Shoper: AI Search e ricerca live nel negozio
Ci sono due modi in cui un chatbot ChatLab trova i prodotti in un negozio Shoper. Il chatbot usa uno oppure l'altro, mai entrambi.
AI Search (consigliato) - ChatLab mantiene un proprio indice del tuo catalogo Shoper e il chatbot lo cerca per significato.
- I clienti chiedono usando un linguaggio naturale, ad esempio "un vestito rosso sotto i 300". La fascia di prezzo viene applicata come filtro rigoroso e vengono abbinati anche i codici prodotto esatti (SKU, EAN).
- Prezzo, giacenza e varianti vengono letti in tempo reale da Shoper al momento della risposta, così 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 automaticamente quando colleghi il negozio. 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 passa la frase del cliente alla ricerca di Shoper tramite l'API del negozio e risponde con ciò che il negozio restituisce.
- Non viene indicizzato nulla e non occorre mantenere nulla sincronizzato. I dati sono sempre in tempo reale.
- Si tratta di una ricerca per parole chiave: trova quello che troverebbe la ricerca interna del tuo negozio per quella frase. Non comprende descrizioni di un'esigenza, sinonimi o refusi come fa invece AI Search.
- Piano necessario: un piano Universal con il componente aggiuntivo Integrazioni e-commerce ($30 al mese). Non serve alcun pacchetto di prodotti.
Quando AI Search è attiva, sostituisce la ricerca live nel negozio. Lo stato dell'ordine funziona allo stesso modo con entrambi i metodi. Una terza opzione, l'addestramento su 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 tuo chatbot trova i prodotti, e per i limiti sui prodotti vedi Piani e limiti E-commerce.
Cosa offre l'integrazione
Ricerca in tempo reale nel negozio (ricerca prodotti per frase) - Il chatbot invia la frase del cliente al motore di ricerca di Shoper. Cerca tra i nomi dei prodotti utilizzando la corrispondenza fuzzy, restituendo fino a 10 prodotti corrispondenti con:
- Nome e descrizione del prodotto
- Prezzo e SKU
- Link diretto alla pagina del prodotto nel tuo negozio
- Immagine del prodotto
- Stato della disponibilità
- Opzionale: allegati del prodotto (PDF, documenti)
Puoi anche attivare il filtro dei prodotti disponibili per mostrare solo gli articoli attualmente disponibili a magazzino.
Dettagli dell'ordine - I clienti possono verificare lo stato del proprio ordine fornendo l'ID ordine e l'indirizzo e-mail associato all'ordine. Entrambi i valori vengono convalidati rispetto ai dati del tuo negozio Shoper. Il chatbot restituisce:
- ID ordine, data e stato attuale
- Totale dell'ordine e valuta
- Articoli ordinati con nomi, quantità e prezzi
- Indirizzo di spedizione (via, città, codice postale, paese, telefono)
- Indirizzo di fatturazione
- Note dell'ordine
Due modi per collegare il tuo negozio
Ci sono due modi per collegare Shoper a ChatLab:
- Metodo 1: App ChatLab dallo Shoper App Store (consigliato) - installazione con un clic. L'app crea la connessione, abilita la ricerca dei prodotti e i dettagli dell'ordine e aggiunge il widget di chat alla tua vetrina. Nessuna chiave API da copiare.
- Metodo 2: Configurazione manuale - crei un amministratore WebAPI in Shoper e inserisci le sue credenziali in ChatLab. Usalo solo quando non puoi installare l'app o quando vuoi collegare il negozio a un chatbot che gestisci in modo specifico.
Scegli un metodo. Non creare una seconda connessione con il Metodo 2 se l'app ha già collegato il negozio.
Metodo 1: installa l'app ChatLab dallo Shoper App Store
L'app gratuita ChatLab nello Shoper App Store è il modo più rapido per iniziare. Non hai bisogno di un account ChatLab esistente o di un chatbot - entrambi vengono creati per te durante l'installazione.
- Nel pannello di amministrazione di Shoper, vai su Add-ons and integrations > Applications (Componenti aggiuntivi e integrazioni > Applicazioni), trova ChatLab - AI Chatbot for Customer Support and Sales e installala
- Apri l'app ChatLab nel pannello di amministrazione di Shoper - il pannello di ChatLab si aprirà in una nuova finestra
- Imposta la tua password (per un nuovo account) oppure accedi con il tuo account ChatLab esistente
- Se hai iniziato dalla procedura guidata di configurazione del chatbot, conferma il collegamento del negozio a quel chatbot; in caso contrario, verrà creato un chatbot per il negozio all'interno del tuo account
- Scegli un piano oppure rimani sul piano gratuito - potrai effettuare l'upgrade in seguito in Account > Subscription (Account > Abbonamento)
Questo è tutto. Il negozio è collegato, le azioni di ricerca prodotti e dettagli dell'ordine sono attive, e il chatbot compare sulla tua vetrina non appena il collegamento è completato. Continua con Configura le azioni Shoper qui sotto per verificare le azioni, oppure apri Test & Deploy > Shoper in ChatLab per rivedere gli stessi passaggi di installazione.
Metodo 2: Configurazione manuale
Usa questo metodo quando non puoi installare l'app. Prima di iniziare, assicurati che:
- Il tuo abbonamento ChatLab includa l'integrazione con Shoper
- Tu abbia accesso al tuo pannello di amministrazione Shoper
- Il tuo chatbot sia già stato creato in ChatLab
La configurazione manuale collega solo i dati del negozio. Il widget di chat deve essere aggiunto separatamente al tuo storefront; vedi Installa il chatbot sul tuo negozio Shoper alla fine di questo articolo.
Passaggio 1: Crea un gruppo di amministratori
- Nel pannello di amministrazione di Shoper, vai su Settings > Store administrators (Impostazioni > Amministratori del negozio)
- Fai clic su MORE (Altro) > Add administrators group (Aggiungi gruppo amministratori)
- Inserisci un nome per il gruppo (ad es. "Integrazione ChatLab"), seleziona Tipo di accesso: 'access to webapi' e salva
Passaggio 2: Configura i permessi del gruppo
- Apri il gruppo appena creato e vai alle impostazioni dei permessi
- Concedi l'accesso in sola lettura (Read) alle seguenti risorse:
- Sales (Vendite) - lettura
- Catalog (Catalogo) - lettura
- Configuration (Configurazione) - lettura
Passaggio 3: Aggiungi un amministratore API
- Vai su Administrators (Amministratori) e fai clic su Add administrator (Aggiungi amministratore)
- Inserisci login e password, e assegna l'amministratore al gruppo creato nel Passaggio 1
- Salva l'amministratore. Annota login e password - ti serviranno nel passaggio successivo.
Passaggio 4: Collega Shoper in ChatLab
- Accedi a ChatLab e seleziona il tuo bot
- Vai alla scheda Connect
- Fai clic su Connect nel riquadro di Shoper
- Inserisci il tuo Shop URL (il tuo dominio Shoper, ad es.
myshop.shoper.pl) - Inserisci il tuo WebAPI Login (dal Passaggio 3)
- Inserisci la tua WebAPI Password (dal Passaggio 3)
- Fai clic su Initialize Configuration - questo recupera le lingue disponibili dal tuo negozio
- Seleziona la corretta Shop Language dal menu a discesa (determina quale versione linguistica dei dati di prodotto viene restituita)
- Fai clic su Connect
ChatLab verifica automaticamente la connessione eseguendo una ricerca di prova dei prodotti. Se l'operazione riesce, vedrai un messaggio di conferma e sia la ricerca prodotti sia le azioni relative ai dettagli dell'ordine saranno abilitate per impostazione predefinita.
Configura le azioni di Shoper
Dopo aver effettuato il collegamento con uno dei due metodi, puoi abilitare e personalizzare le singole azioni IA. Vai su Settings > Actions (Impostazioni > Azioni) e filtra per la piattaforma Shoper.
Le azioni standard includono:
- Shoper - product search - consente al chatbot di cercare nel catalogo dei tuoi prodotti
- Shoper - order details - consente al chatbot di verificare le informazioni sugli ordini
La configurazione del collegamento abilita le azioni standard. Controlla il loro stato e disabilita 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 l'uso di ciascuna azione da parte dell'IA.
Per la ricerca prodotti, fai clic sul pulsante Edit (Modifica) e vai alla scheda Product Search Settings (Impostazioni ricerca prodotti). Sono disponibili due opzioni aggiuntive:
- Include product attachments - se abilitata, il chatbot include i file allegati ai prodotti (PDF, documenti) nei risultati di ricerca
- Products in stock only - se abilitata, il chatbot mostra solo i prodotti attualmente disponibili in magazzino
AI Search per Shoper: catalogo, reindicizzazione e impostazioni
Con un piano E-commerce, o con un piano Universal quando al chatbot è assegnato un pacchetto di prodotti AI Search, la funzione AI Search è attiva e sostituisce la ricerca in tempo reale nel negozio. L'indicizzazione si avvia automaticamente quando il negozio viene collegato.
- Controlla il catalogo - apri Training > E-commerce catalog (Addestramento > Catalogo e-commerce) e controlla le schede Products (Prodotti) e Categories (Categorie). Shop > Products mostra il pannello Product catalog e la scheda AI Search packs on this chatbot.
- Pianifica la reindicizzazione - usa l'opzione 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. L'opzione Train now (Addestra ora) o Retrain (Riaddestra) la avvia su richiesta. Gli aggiornamenti sono incrementali: i prodotti non modificati vengono saltati e quelli rimossi vengono eliminati dall'indice.
- Verifica l'azione - in Settings > Actions (Impostazioni > Azioni), apri Shoper - AI product search. Le sue opzioni sono Include product card, Products in stock only e Number of products to return.
- Mostra le schede prodotto - attiva l'opzione Enable Offer Cards in Settings > Model & Advanced (Impostazioni > Modello e avanzate). Consulta Offer Cards.
Quando il catalogo supera il limite di prodotti consentito, 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 Test & Deploy (Testa e pubblica) e prova:
- "Mostrami le scarpe da corsa" (testa la ricerca dei prodotti)
- "Qual è lo stato del mio ordine 12345?" (testa i dettagli dell'ordine; fornisci l'e-mail corrispondente per un ordine a cui sei autorizzato ad accedere)
Verifica che le risposte corrispondano ai dati del tuo negozio Shoper e che i link ai prodotti si aprano correttamente.
Installa il chatbot sul tuo negozio Shoper
Se hai utilizzato il Metodo 1 (l'applicazione), il widget di chat è già presente sulla tua vetrina e non c'è nient'altro da aggiungere. Se hai utilizzato il Metodo 2 (configurazione manuale), apri Test & Deploy > Shoper in ChatLab, passa a Manual Installation (Installazione manuale), copia il codice e incollalo nel pannello di amministrazione di Shoper in Add-ons and integrations > Custom integrations (Componenti aggiuntivi e integrazioni > Integrazioni personalizzate) all'interno del campo Page header (Intestazione pagina). Vedi Aggiungere il chatbot al tuo sito web per maggiori dettagli.