Integrazione con un feed di prodotti (XML, Google Merchant)

Collega qualsiasi negozio online al tuo chatbot ChatLab tramite un feed di prodotti. Se la tua piattaforma non dispone di un'integrazione nativa con ChatLab, il feed è il modo ideale per fornire il catalogo al chatbot: legge i prodotti dal feed, li indicizza con AI Search e risponde con schede prodotto che rimandano al tuo negozio.

Importante: best practice per l'e-commerce

Dopo aver completato l'integrazione descritta di seguito, leggi la guida completa sull'ottimizzazione del chatbot per l'e-commerce: How to set up ChatLab for your E-commerce store

Cosa include l'integrazione

Ricerca prodotti con AI - I clienti descrivono ciò di cui hanno bisogno con parole proprie e il chatbot trova i prodotti corrispondenti nel tuo catalogo. La risposta contiene:

• Nome e descrizione del prodotto
• Prezzo (e prezzo scontato, se presente nel feed)
• Immagine del prodotto
• Link diretto alla pagina del prodotto nel tuo negozio
• Brand, disponibilità, GTIN / SKU e altri attributi presenti nel feed

Categorie - Quando il feed include la tipologia di prodotto (ad esempio "Casa > Cucina > Bollitori"), il chatbot può limitare la ricerca a una categoria specifica.

Aggiornamento programmato - Il catalogo viene aggiornato in base alla frequenza impostata, così i nuovi prodotti, i prezzi e le disponibilità arrivano al chatbot senza alcun intervento manuale.

Cosa non include l'integrazione

Il feed è un file, non una connessione diretta al tuo negozio, pertanto il chatbot non può:

• verificare lo stato di un ordine
• aggiungere prodotti al carrello o effettuare un ordine
• leggere i livelli di scorta in tempo reale tra un aggiornamento e l'altro

Le schede prodotto rimandano sempre al tuo negozio, dove il cliente completa l'acquisto. Se hai bisogno del tracciamento degli ordini o dell'aggiunta al carrello, utilizza un'integrazione nativa.

Requisiti

• L'integrazione Feed XML inclusa nel tuo piano
• Il pacchetto prodotti AI Search assegnato al chatbot: determina quanti prodotti possono essere indicizzati
• Un feed di prodotti nel formato XML Google Merchant (Google Shopping), disponibile a un indirizzo https pubblico. Sono supportati i feed compressi (.gz) e i feed protetti da nome utente e password.

Passaggio 1: ottieni il feed di prodotti dal tuo negozio

La maggior parte delle piattaforme consente di esportare un feed Google Merchant come funzionalità predefinita o tramite un'estensione gratuita:

• Magento / Adobe Commerce - un'estensione per il feed Google Shopping (ad esempio da Magento Marketplace) genera l'XML a un indirizzo come https://yourstore.com/feeds/google.xml
• IdoSell - Marketing e integrazioni, Siti di comparazione prezzi e marketplace, Google Merchant: abilita il feed e copia il relativo indirizzo
• OpenCart - Estensioni, Feed, Google Base: abilitalo e copia l'URL del feed di dati
• BigCommerce - Channel Manager, Google Shopping, oppure un'app per feed da BigCommerce App Marketplace
• Shopware - Marketing, Confronti di prodotti, Google Shopping: crea l'esportazione e copia il relativo URL
• osCommerce e negozi personalizzati - qualsiasi modulo che generi un feed RSS 2.0 o Atom con gli attributi di prodotto g:

Il feed deve contenere almeno l'identificativo del prodotto (g:id), un nome e un link. Prezzo, immagine, descrizione, disponibilità e tipologia di prodotto migliorano notevolmente la qualità delle risposte.

Passaggio 2: collega il feed in ChatLab

1. Accedi a ChatLab e seleziona il tuo bot
2. Vai alla scheda Connect (Collega)
3. Fai clic su Connect (Collega) nel riquadro Feed XML
4. Incolla l'Feed URL (URL del feed)
5. Se il feed richiede l'autenticazione, attiva l'opzione The feed requires a username and password (Il feed richiede un nome utente e una password) e inserisci le credenziali
6. Se desideri, imposta la Product language (Lingua dei prodotti - codice di due lettere della lingua utilizzata nel feed)
7. Fai clic su Test feed (Verifica feed) - ChatLab scarica la parte iniziale del feed e mostra il formato, il numero di prodotti rilevati, l'anteprima dei primi prodotti così come verranno indicizzati ed eventuali avvisi (prezzi, link, immagini o categorie mancanti)
8. Fai clic su Connect (Collega)

Una volta stabilita la connessione, ChatLab avvia l'indicizzazione del catalogo in background. A seconda delle dimensioni del feed, l'operazione richiede da un minuto a qualche decina di minuti. Puoi monitorare l'avanzamento in Training > E-commerce catalog (Addestramento > Catalogo e-commerce).

Passaggio 3: feed non standard (mappatura dei campi)

Se il tuo feed non segue il formato Google Merchant, ChatLab può comunque leggerlo:

1. Esegui prima Test feed (Verifica feed) - i nomi degli elementi trovati nel file compariranno nei menu a discesa della mappatura
2. Apri Field mapping for non-standard feeds (Mappatura dei campi per feed non standard)
3. Se il singolo prodotto non è rappresentato da un elemento item o entry, inserisci il nome del Product element (Elemento prodotto)
4. Seleziona l'elemento corrispondente per ogni campo: Product identifier (Identificativo prodotto - obbligatorio), Product name (Nome prodotto), Description (Descrizione), Product page URL (URL della pagina prodotto), Image URL (URL dell'immagine), Price (Prezzo), Category path (Percorso categoria) e gli altri
5. Esegui di nuovo Test feed e controlla i prodotti di esempio
6. Fai clic su Connect

I campi lasciati su "Default (Google Merchant)" mantengono i nomi standard, pertanto un feed conforme allo standard non richiede alcuna mappatura.

Passaggio 4: pianificazione degli aggiornamenti

1. Vai su Training > E-commerce catalog
2. Nella scheda Feed XML, fai clic su Retrain (Riaddestra)
3. Retrain now! (Riaddestra ora!) aggiorna immediatamente il catalogo
4. Per aggiornarlo in automatico, scegli la frequenza (ogni giorno, una volta alla settimana o una volta al mese), il giorno e l'orario, quindi fai clic su Schedule retrain (Pianifica riaddestramento)

Vengono reindicizzati solo i prodotti modificati rispetto all'ultimo aggiornamento, mentre i prodotti rimossi dal feed vengono eliminati dal catalogo del chatbot. L'aggiornamento programmato dipende dal tuo piano: le pianificazioni settimanali e mensili richiedono la funzionalità di riaddestramento programmato, quelle giornaliere richiedono il riaddestramento giornaliero.

Passaggio 5: configura l'azione AI

Dopo il collegamento, l'azione Feed XML - AI product search viene abilitata automaticamente per i chatbot che dispongono del pacchetto AI Search. Per modificarla, vai su Settings > Actions (Impostazioni > Azioni) e filtra per la piattaforma Feed XML. Puoi modificare l'etichetta dell'azione, le istruzioni che guidano l'AI e attivare Include product card (Includi scheda prodotto) per fornire al chatbot la scheda prodotto completa anziché la sola descrizione breve.

Testare l'integrazione

Apri il widget del tuo chatbot e prova a chiedere:

• "Mostrami bollitori a meno di 50 dollari" (testa la ricerca con filtro di prezzo)
• "Avete t-shirt di cotone blu?" (testa la corrispondenza degli attributi)

Le risposte dovrebbero mostrare i prodotti del tuo feed completi di link al negozio.

Suggerimenti

• Inserisci nel feed la tipologia di prodotto (g:product_type) come percorso completo, ad esempio "Abbigliamento > Uomo > T-shirt": diventerà la categoria utilizzabile dal chatbot per filtrare i risultati
• Mantieni complete le descrizioni nel feed; il chatbot le utilizza per trovare le corrispondenze con le domande dei clienti
• Le varianti di uno stesso prodotto devono condividere l'attributo item_group_id: in questo modo ChatLab le mostrerà come un unico prodotto con tutti i colori e le taglie disponibili
• Se il feed è voluminoso, l'uso di un feed compresso (.gz) ridurrà i tempi di download

Installare il chatbot sul tuo negozio

Per aggiungere il widget di chat alle pagine del tuo negozio:

1. In ChatLab, vai alla scheda Deploy (Pubblica) del tuo bot
2. Copia lo snippet di codice
3. Incollalo nel template del tuo negozio, prima del tag di chiusura </body>, oppure usa l'impostazione "HTML personalizzato" o "script" della tua piattaforma