Integrazione con PrestaShop: AI Search, ricerca in tempo reale nel negozio e stato degli ordini

Collega il tuo chatbot ChatLab al tuo negozio PrestaShop in modo che i clienti possano trovare i prodotti e verificare lo stato dei loro ordini direttamente nella chat. I prodotti vengono trovati tramite AI Search, che cerca nel tuo catalogo PrestaShop indicizzato in base al significato, oppure tramite la ricerca in tempo reale nel negozio, che interroga l'API dello store.

Conversazione di esempio

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 PrestaShop: AI Search e ricerca in tempo reale nel negozio

Ci sono due modi in cui un chatbot ChatLab trova i prodotti in un negozio PrestaShop. Un chatbot usa l'uno o l'altro, mai entrambi.

AI Search (consigliato) - ChatLab mantiene un proprio indice del tuo catalogo PrestaShop e il chatbot vi effettua ricerche in base al significato.

• I clienti chiedono con linguaggio naturale, ad esempio "un vestito 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 PrestaShop al momento della risposta, così i clienti vedono dati aggiornati anche tra un aggiornamento e l'altro dell'indice.
• I risultati appaiono 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 per le integrazioni e-commerce ($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 passa la frase del cliente alla ricerca di PrestaShop 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 interna del tuo negozio troverebbe per quella frase. Non comprende le descrizioni di un'esigenza, i sinonimi o i refusi nel modo in cui lo fa AI Search.
• Piano necessario: un piano Universal con il componente aggiuntivo per le integrazioni e-commerce ($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 su entrambi i percorsi. 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 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 alla ricerca di PrestaShop. Esegue la ricerca tra i titoli e le descrizioni dei prodotti, restituendo i primi 5 prodotti corrispondenti con:

• ID prodotto, nome e descrizione
• Prezzo (opzionalmente con imposte e sconti specifici applicati)
• Link diretto alla pagina del prodotto nel tuo negozio
• Immagine del prodotto

Ricerca prodotti per riferimento (SKU) - I clienti possono cercare i prodotti utilizzando codici di riferimento esatti. Il chatbot cerca tra diversi tipi di identificatori - codice di riferimento/SKU, codice a barre EAN-13, ISBN e MPN - sia sui prodotti che sulle loro varianti (combinazioni). È utile quando i clienti hanno un codice prodotto specifico preso da un catalogo, da una fattura o da una confezione.

Dettagli dell'ordine - Per impostazione predefinita, i clienti forniscono l'ID dell'ordine e l'indirizzo email associato all'ordine. Entrambi vengono confrontati con i dati del negozio; questo non costituisce una prova di titolarità dell'email. L'impostazione facoltativa Allow order lookup without email verification (Consenti ricerca ordine senza verifica email) consente la ricerca con il solo ID dell'ordine. Mantienila disattivata a meno che la tua configurazione non disponga di adeguati controlli di accesso. Il chatbot restituisce:

• Riferimento dell'ordine, data e stato attuale (es. in lavorazione, completato, annullato)
• Totale dell'ordine
• Nome del destinatario, azienda, indirizzo di consegna completo (via, città, codice postale) e numero di telefono
• Nome del corriere e codici di tracciamento (sono supportati più codici di tracciamento)
• Articoli ordinati con nomi, quantità e prezzi singoli

Prerequisiti

Prima di iniziare l'integrazione con PrestaShop, assicurati che:

• Il tuo chatbot sia stato creato in ChatLab. Il collegamento ai dati del negozio e l'installazione del widget sono passaggi distinti; il modulo può gestire entrambi.
• Tu abbia accesso al pannello di amministrazione (back office) di PrestaShop

Consigliato: connessione tramite modulo

Per una nuova installazione, usa la configurazione guidata con il modulo PrestaShop. Connect my store (Collega il mio negozio) ti consente di accedere a ChatLab e selezionare il tuo chatbot. I passaggi manuali relativi al webservice descritti di seguito rappresentano un'alternativa; non creare una seconda connessione se il modulo ha già collegato il negozio.

Passaggio 1: abilita il webservice in PrestaShop

1. Accedi al back office di PrestaShop
2. Vai su Configure > Advanced Parameters > Webservice (Configura > Parametri avanzati > Webservice)

3. Scorri verso il basso fino alla sezione Configuration (Configurazione)
4. Imposta Enable PrestaShop's webservice (Attiva il webservice di PrestaShop) su Yes (Sì)
5. Clicca su Save (Salva)

Passaggio 2: crea una chiave webservice

1. Nella stessa pagina Webservice, clicca su Add new webservice key (Aggiungi nuova chiave webservice)

2. Clicca su Generate (Genera) per creare una nuova chiave
3. Inserisci una descrizione (es. "Integrazione ChatLab")
4. Assicurati che la chiave sia impostata su Enabled (Attivata)
5. Sotto le autorizzazioni per le risorse, concedi l'accesso View (GET) (Visualizza - GET) alle seguenti risorse:
   • addresses
   • attachments
   • carriers
   • categories
   • combinations
   • configurations
   • customers
   • languages
   • order_carriers
   • order_details
   • order_states
   • orders
   • product_customization_fields
   • product_feature_values
   • product_features
   • product_option_values
   • product_options
   • products
   • search
   • specific_price_rules
   • specific_prices
   • states
   • shops
   • stock_availables
   • tags
   • tax_rule_groups
   • tax_rules
   • taxes

6. Clicca su Save (Salva)
7. Copia la chiave webservice generata - ti servirà nel passaggio successivo

Passaggio 3: trova il formato URL dei tuoi prodotti

1. Nel back office di PrestaShop, vai su Configure > Shop Parameters > Traffic & SEO (Configura > Parametri negozio > Traffico e SEO)

2. Scorri verso il basso fino alla sezione Schema of URLs (Schema degli URL)
3. Copia il valore dal campo Route to products (Percorso per i prodotti) (es. {category:/}{id}{-:id_product_attribute}-{rewrite}{-:tags}.html)

Passaggio 4: collega PrestaShop in ChatLab

1. Accedi a ChatLab e seleziona il tuo bot
2. Vai alla scheda Connect (Collega)

3. Clicca su Connect (Collega) nel riquadro di PrestaShop
4. Inserisci la tua Webservice key (Chiave webservice, dal Passaggio 2)
5. Inserisci il tuo Shop url (URL del negozio, l'URL completo del tuo negozio, es. https://www.mystore.com)
6. Inserisci il tuo Product url format (Formato URL prodotto, dal Passaggio 3)

7. Clicca su Initialize Configuration (Inizializza configurazione) - questo recupera le lingue e i negozi disponibili dal tuo store
8. Seleziona la Default language (Lingua predefinita) corretta e, se visualizzato, il Prestashop store (Negozio PrestaShop) desiderato
9. Clicca su Connect (Collega)

ChatLab testa automaticamente la connessione verificando che la chiave webservice disponga dei permessi necessari. Se l'operazione ha esito positivo, vedrai un messaggio di conferma.

Passaggio 5: configura le azioni PrestaShop

Dopo il collegamento, puoi abilitare e personalizzare le singole azioni IA. Vai su Settings > Actions (Impostazioni > Azioni) e filtra per la piattaforma PrestaShop.

Sono disponibili le seguenti azioni:

• Prestashop - product search - consente al chatbot di cercare nel catalogo prodotti per nome
• Prestashop - search by reference - consente al chatbot di trovare prodotti tramite codice di riferimento/SKU, EAN-13, ISBN o MPN
• Prestashop - order details - consente al chatbot di consultare le informazioni sugli ordini
• Prestashop - get product variants - consente al chatbot di recuperare informazioni dettagliate sulle varianti (taglie, colori) per uno specifico prodotto

La procedura di connessione abilita le azioni standard. Verifica il loro stato e disattiva quelle che non desideri 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'IA nell'uso di ciascuna azione.

Quando l'azione "Search by reference" è abilitata, la normale ricerca prodotti passerà automaticamente alla ricerca per codice di riferimento nel caso in cui non vengano trovati risultati per nome. Ciò significa che i clienti possono inserire uno SKU o un codice a barre in una normale query di ricerca e ottenere comunque risultati accurati.

Mostra prodotti con data di riassortimento (pre-ordine)

Quando l'opzione "Products in stock only" (Solo prodotti disponibili) è abilitata nelle impostazioni dell'azione di ricerca prodotti, puoi attivare anche "Show products with restock date" (Mostra prodotti con data di riassortimento). Questo consente al chatbot di includere i prodotti esauriti che hanno una data di riassortimento prevista impostata in PrestaShop. Invece di nascondere completamente questi prodotti, il chatbot informa il cliente sulla data di riassortimento e sul fatto che il prodotto è disponibile per il pre-ordine.

Requisiti:

• PrestaShop deve avere attiva l'opzione "Allow ordering of out-of-stock products" (Consenti l'ordine di prodotti non disponibili) in Shop Parameters > Product Settings (Parametri negozio > Impostazioni prodotto)
• La chiave webservice deve avere accesso View (GET) alle risorse combinations e configurations
• I prodotti devono avere un valore available_date impostato sulle loro combinazioni in PrestaShop

Prezzi comprensivi di imposte

Attiva l'opzione "Apply tax (VAT) to prices" (Applica imposta/IVA ai prezzi) nelle impostazioni dell'azione di ricerca prodotti per mostrare i prezzi comprensivi di tasse. Se abilitata, il chatbot calcola i prezzi utilizzando le regole fiscali del tuo negozio PrestaShop in base al paese predefinito del negozio. Confronta il risultato con la tua vetrina. Eventuali regole fiscali specifiche per cliente, la posizione geografica e le rettifiche al momento del pagamento possono comunque generare totali differenti.

Requisiti:

• La chiave webservice deve avere accesso View (GET) alle risorse taxes, tax_rules, tax_rule_groups e configurations

Prezzi specifici (sconti e promozioni)

Attiva l'opzione "Apply specific prices (discounts/promotions)" (Applica prezzi specifici - sconti/promozioni) nelle impostazioni dell'azione di ricerca prodotti per mostrare i prezzi scontati definiti dalle regole prezzi specifici di PrestaShop. Quando per un prodotto è attivo uno sconto, il chatbot mostra sia il prezzo scontato sia il prezzo originale, così i clienti possono vedere il risparmio.

Questo copre le regole generali per i prezzi specifici - promozioni e saldi che si applicano a tutti i clienti con una quantità minima pari a 1. Sono supportate anche le promozioni a tempo limitato; il chatbot applica solo gli sconti attualmente attivi in base alle relative date di inizio e fine.

Requisiti:

• La chiave webservice deve avere accesso View (GET) alle risorse specific_prices e specific_price_rules

AI Search per PrestaShop: catalogo, reindicizzazione e impostazioni

Con un piano E-commerce, oppure con un piano Universal quando al chatbot è assegnato un pacchetto di prodotti AI Search, la funzione AI Search è attiva e sostituisce la ricerca live nel negozio. L'indicizzazione si avvia automaticamente al collegamento dello store.

• Controlla il catalogo - apri Training > E-commerce catalog (Catalogo e-commerce) e controlla le schede Products (Prodotti) e Categories (Categorie). In Shop > Products trovi 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 l'opzione Schedule auto-retrain (Pianifica riaddestramento automatico) in Training > E-commerce catalog. La reindicizzazione può essere eseguita anche ogni giorno ed è disponibile in qualsiasi piano E-commerce e con ogni pacchetto di prodotti. Train now (Addestra ora) o Retrain (Riaddestra) la avvia su richiesta. Gli aggiornamenti sono incrementali: i prodotti invariati vengono saltati e i prodotti eliminati vengono rimossi dall'indice.
• Controlla l'azione - in Settings > Actions (Impostazioni > Azioni), apri Prestashop - 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. Vedi Offer Cards.

Se 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 live nel negozio descritte sopra non si applicano necessariamente a AI Search.

Test dell'integrazione

Dopo aver attivato le azioni, apri Overview (Panoramica) e prova:

• "Mostrami delle scarpe da corsa" (testa la ricerca prodotti)
• "Sto cercando il prodotto ABC-12345" (testa la ricerca per codice/SKU)
• "Qual è lo stato del mio ordine 12345?" (testa i dettagli dell'ordine; inserisci l'e-mail corrispondente a un ordine a cui sei autorizzato ad accedere)

Verifica che le risposte corrispondano ai dati del tuo negozio PrestaShop, che i link ai prodotti si aprano correttamente e che i prezzi includano imposte e sconti quando queste opzioni sono attive.

Installa il chatbot sul tuo negozio PrestaShop

Per aggiungere il widget di chat alla vetrina del tuo negozio PrestaShop, consulta la guida dettagliata: Installare il chatbot su un negozio PrestaShop

Articoli correlati

• AI Search: come il tuo chatbot trova i prodotti
• Piani e limiti per l'e-commerce
• Guida alla configurazione dell'e-commerce
• Aggiungere un chatbot al tuo sito web