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.

Esempio di conversazione

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 chatbot per l'e-commerce: Come configurare ChatLab per il tuo negozio e-commerce

Cosa offre 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 quando presente nel feed)
• Immagine del prodotto
• Link diretto alla pagina del prodotto nel tuo negozio
• Brand, disponibilità, GTIN / SKU e altri attributi provenienti dal feed

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

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

Cosa non offre 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 completare un ordine
• leggere i livelli di stock in tempo reale tra un aggiornamento e l'altro

Le schede prodotto provviste di un URL valido rimandano al tuo negozio, dove il cliente conclude l'acquisto. Per il tracciamento degli ordini, scegli un'integrazione nativa che supporti questa funzione. Anche il supporto per l'aggiunta al carrello dipende dalla piattaforma e dalla configurazione del negozio; non è disponibile tramite tutte le integrazioni native.

Requisiti

• L'integrazione Feed XML inclusa nel tuo piano
• Accesso ad AI Search e capacità di catalogo assegnata al chatbot: controlla Shop > Products (Negozio > Prodotti) per verificare la capacità disponibile
• Nessun'altra integrazione e-commerce collegata allo stesso bot. Valuta le conseguenze prima di disconnettere un negozio esistente.
• Un feed di prodotti nel formato XML Google Merchant (Google Shopping), disponibile a un indirizzo https pubblico. Sono supportati anche i feed compressi (.gz) e i feed protetti da nome utente e password.

Passaggio 1: ottieni il feed di prodotti dal tuo negozio

Chiedi all'amministratore del tuo negozio un feed di prodotti XML con i campi di Google Merchant. La generazione del feed e gli eventuali costi delle estensioni dipendono dalla tua piattaforma:

• Magento / Adobe Commerce - un'estensione per feed Google Shopping (ad esempio dal Magento Marketplace) genera l'XML a un indirizzo come https://yourstore.com/feeds/google.xml
• IdoSell - apri MARKETING > Produkty i reklamy w Google > Feed produktowy dla Google Shopping do samodzielnego zarządzania reklamami e ottieni l'URL del feed. Verifica che ChatLab possa scaricarlo, poiché alcuni feed limitano l'accesso al servizio designato. Consulta la guida di IdoSell a Google Shopping e le restrizioni di accesso al feed.
• OpenCart - se la tua versione include l'estensione feed Google Base, attivala tra le estensioni feed e copia l'URL del feed di dati; altrimenti usa un'estensione di esportazione XML compatibile
• BigCommerce - ottieni un URL XML scaricabile dalla tua app di esportazione feed. La sola connessione al canale Google non corrisponde all'URL del feed di cui ChatLab ha bisogno
• Shopware 6 - aggiungi un canale di vendita Product comparison, scegli Google Shopping (XML) come modello, configura l'esportazione e copia il relativo URL. Consulta la guida all'esportazione di Shopware.
• osCommerce e negozi personalizzati - qualsiasi modulo che generi un feed RSS 2.0 o Atom con gli attributi di prodotto g:

Ogni prodotto indicizzato deve avere un identificatore univoco (di default g:id). Nome e link al prodotto sono caldamente consigliati: in assenza del nome viene usato come ripiego l'identificatore, mentre senza link non è possibile generare un collegamento funzionante al negozio. 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. Clicca su Connect (Collega) nel riquadro Feed XML
4. Incolla il 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 nome utente e password) e inserisci le credenziali
6. Se desideri, imposta il parametro Product language (Lingua del prodotto - codice di due lettere della lingua utilizzata nel feed)
7. Clicca su Test feed (Testa feed) - ChatLab scarica l'inizio del feed e mostra il formato, un conteggio di anteprima (fino a 2.000 elementi, non necessariamente il totale complessivo del feed), fino a cinque prodotti di esempio e gli eventuali avvisi (prezzi, link, immagini o categorie mancanti)
8. Clicca su Connect (Collega)

Se l'indicizzazione automatica del catalogo è attiva e sono disponibili l'accesso ad AI Search e la capacità necessaria, la procedura di connessione avvia l'indicizzazione in background. Altrimenti, addestra il catalogo manualmente. Segui l'avanzamento e gli errori in Shop > Products (Negozio > Prodotti) o in Training > E-commerce catalog (Addestramento > Catalogo e-commerce); il completamento della connessione da solo non significa che i prodotti siano già disponibili per la ricerca.

Passaggio 3: feed non standard (mappatura dei campi)

Se il tuo feed non segue il formato Google Merchant, ChatLab è comunque in grado di leggerlo:

1. Esegui prima Test feed (Testa feed): i nomi degli elementi trovati nel tuo file compariranno nei menu a tendina di mappatura
2. Apri Field mapping for non-standard feeds (Mappatura dei campi per feed non standard)
3. Se il singolo prodotto non corrisponde a un elemento item o entry, inserisci il nome dell'elemento in Product element (Elemento prodotto)
4. Scegli l'elemento per ciascun campo: Product identifier (Identificatore prodotto - obbligatorio), Product name (Nome prodotto), Description (Descrizione), Product page URL (URL pagina prodotto), Image URL (URL immagine), Price (Prezzo), Category path (Percorso categoria) e i restanti campi
5. Esegui nuovamente Test feed (Testa feed) e controlla i prodotti di esempio
6. Clicca su Connect (Collega)

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

Passaggio 4: pianificazione dell'aggiornamento

1. Vai su Training > E-commerce catalog (Addestramento > Catalogo e-commerce)
2. Nella scheda Feed XML, clicca su Retrain (Riaddestra)
3. Retrain now! (Riaddestra ora!) aggiorna immediatamente il catalogo
4. Per aggiornarlo in modo automatico, scegli la frequenza (ogni giorno, una volta alla settimana o una volta al mese), il giorno e l'ora, quindi clicca 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, mentre quelle giornaliere necessitano del riaddestramento giornaliero.

Passaggio 5: configura l'azione AI

Con l'indicizzazione automatica del catalogo attiva e l'accesso richiesto configurato, la connessione abilita Feed XML - AI product search. Altrimenti, attivala esplicitamente e addestra il catalogo. Per personalizzarla, 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 descrizione breve.

Testare l'integrazione

Apri il widget del tuo chatbot e prova a chiedere:

• "Mostrami bollitori sotto i 50 dollari" (testa la ricerca con filtro di prezzo)
• "Avete magliette di cotone blu?" (testa la corrispondenza degli attributi)

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

Consigli utili

• Inserisci la tipologia di prodotto nel feed (g:product_type) come percorso completo, ad esempio "Abbigliamento > Uomo > T-shirt": diventerà la categoria utilizzabile dal chatbot come filtro
• Mantieni complete le descrizioni nel feed; il chatbot le utilizza per trovare corrispondenze con le domande dei clienti
• Le varianti di uno stesso prodotto devono condividere lo stesso item_group_id: ChatLab raggruppa gli attributi di colore, taglia, materiale e motivo in un unico prodotto indicizzato. Il primo articolo determina il prezzo e il link del gruppo, quindi verifica i dettagli specifici delle varianti nel tuo negozio
• Se il tuo feed è molto grande, un feed compresso (.gz) verrà scaricato più rapidamente

Installa 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. Seleziona Widget e 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

Articoli correlati

• Guida alla configurazione dell'e-commerce
• Aggiungere il chatbot al tuo sito web