Collegare WooCommerce a ChatGPT: dal catalogo al feed senza errori

Collegare WooCommerce a ChatGPT: dal catalogo al feed senza errori

Collegare WooCommerce a ChatGPT significa rendere disponibile il catalogo prodotti tramite un feed strutturato che la superficie shopping di OpenAI può leggere, usando l'Agentic Commerce Protocol (ACP). Servono un feed con campi obbligatori (id, title, description, link, image_link, price, availability, brand e gtin oppure identifier_exists), la registrazione tramite l'onboarding per merchant di OpenAI e una validazione prima della pubblicazione.

La maggior parte dei negozi WooCommerce dispone già di un catalogo perfettamente utilizzabile dagli utenti che navigano sul sito. Ciò che legge ChatGPT è diverso: serve un feed, cioè un file strutturato con campi definiti, non una pagina web. Un crawler che visita una pagina prodotto può dedurre il prezzo dal layout; un lettore di feed non può dedurre nulla: legge soltanto il campo previsto nel formato previsto. Questa è la differenza pratica tra avere un negozio ben realizzato e averne uno che un assistente AI può citare concretamente in una risposta.

Perché collegare WooCommerce a ChatGPT è importante proprio ora

Gli acquirenti chiedono sempre più spesso agli assistenti AI consigli sui prodotti e un assistente può menzionare soltanto i prodotti che riesce a leggere da una fonte strutturata e leggibile dalle macchine.

Non si tratta di sostituire il lavoro SEO già svolto: è una superficie aggiuntiva. Google Shopping, il tuo negozio e il feed shopping di ChatGPT hanno requisiti tecnici distinti, e prepararsi per uno non significa essere pronti per l'altro. Una pagina prodotto ben posizionata nella ricerca tradizionale può comunque essere completamente invisibile a un assistente AI se il feed sottostante manca o non è valido.

Puoi immaginare il sistema a livelli: il livello del negozio è ciò che vede una persona, con foto, layout, recensioni e pulsante per il checkout; il livello del feed è ciò che legge una macchina, cioè un elenco piatto di campi privo di contesto visivo. Un prodotto può apparire perfetto nel negozio e fallire completamente nel feed, perché i due livelli sono progettati per lettori diversi. Ecco perché il titolare di un negozio può sorprendersi quando una prima submission del feed viene rifiutata: sul sito non sembra esserci nulla di sbagliato, ma il feed non ha mai avuto i campi corretti.

Preparazione del catalogo: cosa verificare prima del collegamento

Prima di collegare qualsiasi cosa, verifica che ogni prodotto abbia compilati con valori reali, non segnaposto, i nove campi richiesti da ACP.

I campi sono: id (un identificativo univoco e stabile, di solito lo SKU), title, description, link (l'URL canonico del prodotto), image_link, price (con valuta), availability (in stock, out of stock, preorder), brand e gtin oppure identifier_exists impostato su false quando non si applica alcun GTIN. La mancanza anche di uno solo di questi campi in una parte del catalogo è spesso il motivo per cui una submission viene rifiutata o ignorata parzialmente.

1. Apri l'elenco Prodotti di WooCommerce ed esporta il catalogo in CSV usando l'esportatore integrato, nella sezione Prodotti > Tutti i prodotti > Esporta.
2. Apri l'esportazione e aggiungi una colonna per ciascuno dei nove campi ACP, segnando ogni riga in cui un campo è vuoto, generico o contiene un segnaposto come "N/A".
3. Per ogni prodotto privo di gtin, verifica caso per caso se il codice esiste davvero (controllando la confezione del fornitore o la fattura) oppure imposta identifier_exists su false.
4. Confronta la colonna price con il prezzo attualmente mostrato su ogni pagina prodotto, perché promozioni e arrotondamenti possono creare differenze non evidenti.
5. Confronta il valore di availability con lo stato delle scorte di WooCommerce, assicurandoti che corrisponda a uno dei tre valori accettati e non a un'etichetta personalizzata.

• Titoli composti soltanto da un numero di modello, senza testo descrittivo
• Descrizioni copiate alla lettera da un PDF del fornitore, compresi blocchi di testo irrilevanti
• Varianti (taglia, colore) che condividono lo stesso id, compromettendo l'univocità
• Prezzi senza valuta o diversi da quelli mostrati nella pagina online
• Campo brand mancante per prodotti a marchio privato o realizzati a mano

Negozi con meno di cinquanta prodotti

Un catalogo piccolo è più semplice da controllare manualmente, prodotto per prodotto, prima di generare il feed. Conviene farlo una volta con attenzione invece di correggere gli errori dopo un rifiuto. Per esempio, un negozio con trenta candele può esaminare il CSV esportato riga per riga in meno di un'ora, segnalando i casi in cui il titolo dice soltanto "candela profumata" senza indicare marchio o dimensione e correggendoli prima ancora di generare il feed.

Venditori multicanale già presenti su Amazon, Etsy o eBay

Se gestisci già inserzioni su altri canali, probabilmente possiedi quasi tutti i dati richiesti, ma non nei campi WooCommerce previsti da ACP. Di solito il problema è il mapping, non l'assenza di informazioni. Per esempio, un GTIN presente in un'inserzione Amazon spesso non viene mai trasferito nel campo personalizzato del prodotto WooCommerce: il generatore del feed lo considera mancante anche se il dato esiste nei tuoi sistemi.

Come collegare il catalogo WooCommerce al feed prodotti di ChatGPT

Esistono due percorsi pratici: l'estensione Stripe per WooCommerce, che espone un feed ACP, oppure un feed generato separatamente e inviato al programma merchant di OpenAI.

Il primo percorso utilizza l'estensione ufficiale Stripe for WooCommerce, che può esporre il catalogo nel formato del feed ACP direttamente dall'infrastruttura di checkout del negozio, poiché ACP è costruito intorno al checkout agentico di Stripe. Se il negozio elabora già i pagamenti tramite Stripe, questa è la strada più breve: installa l'estensione, conferma il mapping dei prodotti e l'endpoint del feed viene generato automaticamente.

1. Dall'amministrazione di WordPress, vai su Plugin > Aggiungi nuovo e cerca "Stripe for WooCommerce".
2. Installa e attiva l'estensione, poi vai su WooCommerce > Impostazioni > Pagamenti > Stripe per verificare che l'account Stripe esistente sia collegato.
3. Nel pannello delle impostazioni dell'estensione, individua la sezione ACP Feed e abilita la generazione del feed per il catalogo prodotti.
4. Controlla il mapping dei campi mostrato sullo schermo, verificando che id, price e availability vengano recuperati dagli attributi corretti del prodotto WooCommerce e non da valori predefiniti.
5. Copia l'URL del feed generato mostrato in fondo al pannello: dovrai inserirlo più avanti nell'onboarding merchant di OpenAI.

Il secondo percorso consiste nel generare il feed in modo indipendente, al di fuori di Stripe, e inviarlo direttamente tramite l'onboarding merchant di OpenAI. È la soluzione per i negozi che usano un altro gestore dei pagamenti o per chi vuole generare il feed a partire da un audit del catalogo, anziché dai dati WooCommerce non elaborati. Una guida dedicata spiega il processo nel dettaglio: come inviare il feed prodotti WooCommerce a ChatGPT senza errori.

Un feed privo dei nove campi ACP compilati non è invisibile a ChatGPT: è illeggibile, proprio come un modulo con campi obbligatori vuoti non può essere inviato.

Onboarding merchant passo dopo passo, con i nomi esatti dei menu

L'onboarding merchant di OpenAI ti chiede di registrarti come venditore, inviare l'URL del feed e confermare la proprietà del dominio prima che il feed passi in revisione.

1. Vai alla registrazione del programma merchant di OpenAI e crea un account usando un indirizzo email aziendale associato al dominio del negozio.
2. Nel modulo di onboarding, alla voce Dettagli del negozio, inserisci il nome del negozio e il dominio canonico, cioè quello che corrisponde al campo link dei prodotti.
3. Alla voce Feed prodotti, incolla l'URL del feed: l'endpoint generato dall'estensione Stripe oppure l'URL del file ospitato autonomamente.
4. Conferma la proprietà del dominio tramite il metodo di verifica proposto, di solito un record DNS TXT o il caricamento di un file.
5. Invia la richiesta per la revisione. OpenAI controlla la struttura del feed e un campione di campi prima di approvarlo.

Prima di iniziare il modulo di onboarding, è utile avere tutto pronto in un unico posto: il dominio canonico esatto (con o senza "www", identico a quello presente nel campo link), l'URL del feed già testato in un browser per verificare che si carichi e l'accesso alle impostazioni DNS del dominio o al file manager dell'hosting per la verifica della proprietà. Saltare la verifica del dominio o verificare un dominio diverso da quello usato nei link dei prodotti è un motivo comune per cui l'onboarding si blocca a metà.

Come verificare che il collegamento funzioni davvero

La conferma consiste nel controllare il feed rispetto allo schema richiesto prima dell'invio e poi verificare lo stato del feed nella dashboard merchant dopo la revisione.

Prima dell'invio, esegui il feed nel validatore gratuito per feed di Katapic. Controlla ogni riga prodotto rispetto ai nove campi ACP e segnala ciò che manca, senza modificare il negozio, così puoi correggere gli errori prima che vengano rilevati dalla revisione di OpenAI e ritardino l'approvazione.

1. Incolla l'URL del feed nel validatore e avvia il controllo.
2. Esamina il report riga per riga: per ogni prodotto segnalato viene indicato il campo esatto mancante o non valido.
3. Correggi i dati del prodotto WooCommerce, rigenera il feed e ripeti la validazione finché il report non risulta pulito.
4. Solo a quel punto invia l'URL del feed nel modulo di onboarding di OpenAI oppure invialo nuovamente se una submission precedente è stata rifiutata.
5. Dopo l'approvazione, controlla periodicamente nella dashboard merchant la presenza di un indicatore come "richiede attenzione", che segnala quando una modifica successiva al catalogo ha reso non valido un campo prima corretto.

Errori comuni

La maggior parte dei rifiuti deriva da pochi problemi ricorrenti, ciascuno con un messaggio di errore preciso, una causa chiara e una soluzione semplice.

• "Missing required field: gtin or identifier_exists". Causa: né il GTIN né identifier_exists sono stati impostati sul prodotto. Rimedio: imposta identifier_exists su false in modo esplicito per gli articoli handmade o a marchio privato che non hanno davvero un GTIN, invece di lasciare il campo vuoto.
• "Duplicate id detected". Causa: di solito una variante condivide l'id del prodotto padre. Rimedio: assegna a ogni variante un id proprio, distinto da quello del prodotto padre.
• "image_link unreachable". Causa: l'URL dell'immagine restituisce un 404 o reindirizza altrove. Rimedio: verifica che l'hosting delle immagini non blocchi le richieste esterne e che l'URL punti direttamente al file immagine.
• "price mismatch". Causa: il prezzo nel feed è diverso da quello mostrato sulla pagina prodotto live. Rimedio: rigenera subito il feed dopo ogni modifica di prezzo, soprattutto al termine di una promozione.
• "availability value not recognized". Causa: il campo usa un testo libero come "pochi pezzi rimasti" invece di un valore accettato. Rimedio: mappa lo stato dello stock WooCommerce solo su in stock, out of stock o preorder.

Cosa cambia dopo: monitorare le citazioni nelle risposte AI

Quando il feed è online, il compito successivo è verificare se i tuoi prodotti vengono effettivamente menzionati quando qualcuno chiede a ChatGPT una raccomandazione nella tua categoria.

Essere collegati tecnicamente non garantisce una citazione: la rende soltanto possibile. Conviene porre periodicamente una domanda simile a quella di un cliente, nella propria categoria, e controllare se compare il negozio e quali concorrenti vengono citati al suo posto. È un'attività di monitoraggio, non un controllo una tantum, perché i feed diventano obsoleti e i cataloghi cambiano.

1. Una volta alla settimana, chiedi a ChatGPT qualcosa di naturale sui prodotti della tua categoria, formulando la domanda come farebbe un cliente reale.
2. Annota se il tuo negozio viene menzionato e, in caso contrario, quali concorrenti vengono indicati.
3. Confronta ogni prodotto menzionato con il feed online per verificare che prezzo e disponibilità siano ancora corretti.
4. Se un prodotto citato in precedenza smette di comparire, controlla prima il validatore: un campo obsoleto è la causa più comune.

Un feed inviato una volta e mai più controllato perde l'allineamento con il negozio online non appena cambia un prezzo o il livello delle scorte.

Venditori che aggiornano spesso prezzi o disponibilità

Se i prezzi cambiano spesso, per esempio per articoli stagionali o collezioni a disponibilità limitata, il feed deve riflettere le variazioni quasi in tempo reale. Altrimenti l'errore di mancata corrispondenza del prezzo diventa un problema ricorrente, non una correzione occasionale. Per esempio, un negozio che lancia una vendita lampo il venerdì e torna al prezzo pieno il lunedì deve automatizzare la rigenerazione del feed, anziché farlo manualmente, altrimenti la discrepanza emergerà ogni settimana.

Venditori con molti articoli handmade o unici

Gli articoli realizzati a mano raramente hanno un GTIN e ciascuno può avere un id leggermente diverso. Impostare correttamente il campo identifier_exists su larga scala è il principale punto critico per questo gruppo. Una soluzione pratica consiste nel creare il campo id usando uno schema coerente, come codice della categoria più numero progressivo, così anche i pezzi unici ottengono un identificativo stabile e univoco senza dover improvvisare ogni volta.

Prossimi passi per mantenere il catalogo pronto per ChatGPT

Mantenere un feed pronto per ChatGPT è un'attività continua: controlla la completezza dei campi dopo ogni modifica al catalogo, ripeti la validazione prima di un nuovo invio e rivedi periodicamente una checklist.

Una checklist strutturata aiuta a trasformare il processo in una routine ripetibile, invece che in una correzione una tantum: la checklist del feed WooCommerce prima dell'invio a ChatGPT ripercorre gli stessi campi trattati qui in un formato più breve e ripetibile. Per una panoramica più ampia di cosa significhi essere pronti per l'AEO oltre il feed, cinque modi per misurare la preparazione AEO di un prodotto WooCommerce illustra i segnali importanti anche prima dell'invio del feed.

Come Katapic supporta il collegamento tra WooCommerce e ChatGPT

Katapic genera un feed pronto per ChatGPT a partire dal catalogo WooCommerce esistente e ti permette di controllarlo rispetto ai campi richiesti prima di inviare qualsiasi cosa.

La scansione gratuita di WooCommerce legge un catalogo pubblico in modalità di sola lettura, fino a 100 prodotti, senza account, e assegna a ogni prodotto un punteggio relativo alla preparazione per la ricerca classica, alla preparazione per gli assistenti AI, alla rilevanza e alla completezza, cioè le lacune a livello di campo che di solito fanno fallire un feed. La vista della preparazione per canale mostra poi quali prodotti sono pronti nello specifico per il feed ChatGPT (ACP), oltre che per Google Shopping, Meta e il tuo negozio, ed esporta il CSV Google Shopping per Merchant Center solo per i prodotti idonei. Il validatore gratuito per feed indicato sopra rileva gli stessi problemi relativi ai nove campi prima della revisione di OpenAI. Nulla di tutto questo sostituisce il giudizio umano sul catalogo: Katapic lavora sui dati già disponibili e una riscrittura non viene addebitata se non supera effettivamente il controllo dei fatti. Puoi iniziare dalla home page di Katapic con la scansione gratuita, senza bisogno di un account.

Domande frequenti

Come invio un feed prodotti WooCommerce a ChatGPT?

Genera un feed con i nove campi ACP compilati (id, title, description, link, image_link, price, availability, brand, gtin o identifier_exists), poi invia il relativo URL tramite l'onboarding merchant di OpenAI, usando l'estensione Stripe for WooCommerce oppure un file ospitato autonomamente, e conferma la proprietà del dominio prima della revisione.

Posso usare un generatore AI di descrizioni prodotto per WooCommerce prima di inviare il feed?

Sì, ma il campo description del feed deve comunque corrispondere a ciò che viene mostrato nella pagina prodotto online e descrivere fatti reali, non specifiche inventate. Qualsiasi strumento di riscrittura dovrebbe conservare gli attributi effettivi già disponibili, senza crearne di nuovi.

Qual è la differenza tra il feed prodotti WooCommerce per OpenAI e un normale feed Google Shopping?

Entrambi condividono diversi campi obbligatori, ma il feed ChatGPT segue la struttura dell'Agentic Commerce Protocol collegata al programma merchant di OpenAI, mentre i feed Google Shopping seguono le specifiche di Google Merchant Center. Un prodotto può essere pronto per uno dei due canali e non per l'altro se il mapping dei campi è diverso.

Per collegare WooCommerce a ChatGPT serve un consulente o posso usare un software?

Gran parte del lavoro è meccanica: compilare i campi obbligatori, validare il feed e correggere messaggi di errore letterali. Un consulente può aiutare con la strategia e i casi particolari, ma un software di validazione gestisce direttamente il controllo campo per campo; un confronto più ampio tra i due approcci è disponibile nell'articolo consulenza o software per il tuo catalogo artigianale.

Quanto costa in genere la consulenza SEO per WooCommerce rispetto a uno strumento per feed?

I costi della consulenza variano molto in base all'ambito dell'incarico e vengono spesso fatturati con un compenso continuativo, mentre gli strumenti per feed e preparazione del catalogo hanno di solito un costo una tantum o per singola azione. Un'analisi dettagliata di cosa comprende normalmente una consulenza SEO per WooCommerce è disponibile nell'articolo quanto costa davvero una consulenza SEO per WooCommerce.

Perché il mio feed prodotti WooCommerce non viene mostrato correttamente in ChatGPT?

Le cause più comuni sono campi obbligatori mancanti, id duplicati tra le varianti, link alle immagini che restituiscono un errore oppure un prezzo nel feed che non corrisponde più alla pagina prodotto online. Eseguire il feed in un validatore prima di inviarlo nuovamente di solito mostra il campo esatto che causa il rifiuto.

Dove posso verificare se il catalogo WooCommerce è pronto per la ricerca AI prima di creare un feed?

Una scansione gratuita e in sola lettura può segnalare campi mancanti e lacune di completezza a livello di catalogo prima ancora di generare un feed. Un elenco di strumenti gratuiti per questo controllo è disponibile nell'articolo strumenti gratuiti per verificare se il catalogo è pronto per la ricerca AI.