Privacy, risoluzione dei problemi e hook per sviluppatori — WebMCP

Dati e privacy

Il modulo salva tutto nel database del tuo negozio. Nulla viene inviato a PrestaChamps.

Una visita dal link di un assistente viene ricordata per 30 giorni nel cookie del tuo negozio stesso (nessun nuovo cookie): solo il canale, l’assistente e l’ora. Le valutazioni e le recensioni vengono lette dal tuo modulo di recensioni quando un assistente le chiede, mai copiate.

Le richieste di reso e di annullamento non lasciano alcun record proprio nel modulo. Una richiesta di reso è un reso merce di PrestaShop, come se il cliente avesse usato il form di reso della pagina del suo ordine. Una richiesta di annullamento è un messaggio sull’ordine nel Servizio clienti di PrestaShop, scritto dall’account del cliente; a differenza del form dei messaggi della pagina dell’ordine, non salva alcun indirizzo IP. I loro limiti giornalieri sono contatori come i limiti di richieste descritti sopra.

Il modulo elimina da solo i record scaduti, al massimo ogni 6 ore. Eliminare un cliente elimina i suoi collegamenti, token, checkout preparati e test; le sue righe del registro vengono eliminate dopo Giorni di conservazione del registro. I checkout preparati di un test con IA (Prova con un agente IA) vengono conservati 30 giorni come tutti gli altri. Mentre il modulo è disattivato non elimina nulla, nemmeno quando viene eliminato un cliente: disinstallalo per eliminare i suoi dati.

Cosa indicare nella tua informativa sulla privacy: che gli acquirenti possono collegare un assistente IA al loro account, cosa conserva il modulo di questi collegamenti (vedi sopra), e che il fornitore dell’assistente (OpenAI, Anthropic) decide cosa conservare della conversazione; e, se fai test come clienti reali in Prova con un agente IA, che i loro ordini e prezzi vengono inviati al fornitore di IA con cui fai i test.

Disinstallazione. Disinstallare il modulo elimina i suoi carrelli di prova aperti, poi tutto quanto sopra: ogni tabella e ogni impostazione del modulo. Il robots.txt resta com’è (generalo di nuovo in Parametri Negozio › Traffico & SEO per rimuovere il gruppo del modulo).

Link di pagamento dopo la disattivazione o la disinstallazione. Disattivare o disinstallare il modulo chiude subito ogni accesso aperto da un link di pagamento. Un browser che ha aperto un link di questo tipo può ancora mostrare nei dati della pagina il nome, l’indirizzo e-mail e gli indirizzi dell’acquirente finché il suo cookie del negozio non scade, perché PrestaShop stesso legge il cliente da quel cookie (segnalato a PrestaShop).

↑ Torna su

Risoluzione dei problemi

Parti da Diagnostica: ogni riga qui sotto è un controllo del suo elenco, con cosa significa e come correggerlo. Mentre gli assistenti sul telefono sono disattivati, le cinque righe «Assistenti sul telefono» sono solo informative.

• Modulo attivo per questo negozio – fallisce quando il modulo non è attivato per questo negozio in Gestione Moduli (Apri Gestione Moduli), è disattivato nelle sue impostazioni (Apri le impostazioni), o quando il negozio è in modalità di manutenzione (visitatori e assistenti vedono allora la pagina di manutenzione; Apri le impostazioni di manutenzione).
• Strumenti offerti – fallisce quando nessuno strumento è attivo («gli assistenti non trovano nulla da usare nel tuo negozio»), richiede attenzione quando sono attive solo le modifiche al carrello (gli assistenti non possono cercare né leggere il tuo catalogo per trovare cosa aggiungere). Correzione: Scegli gli strumenti.
• Pagine sicure (HTTPS) – fallisce senza HTTPS: i browser offrono WebMCP solo sulle pagine sicure. «HTTPS è attivo solo su alcune pagine»: attiva HTTPS su tutte le pagine (Apri le impostazioni generali). Un negozio sul tuo computer mostra «Sicuro solo per lo sviluppo».
• Collegamento alle pagine del negozio – «Il modulo non è collegato del tutto alle pagine del negozio, che quindi potrebbero non offrire gli strumenti.» Correzione: Ripara gli hook nella stessa scheda.
• Token Origin Trial – informativo se non c’è un token: «Senza un token, solo i browser con il flag di test WebMCP vedono i tuoi strumenti.» (Aggiungi un token). Segnala un avviso quando un token è per un altro indirizzo, non è della prova WebMCP, è scaduto o scade entro 14 giorni.
• Indice di ricerca – vedi L’indice di ricerca.
• Il negozio risponde – il modulo chiama dal tuo server l’indirizzo del proprio negozio. «Il tuo server non è riuscito ad aprire l’indirizzo del proprio negozio (succede spesso dietro un firewall e in Docker)»: usa Apri il controllo del negozio nel tuo browser. «Il negozio reindirizza questo indirizzo altrove invece di rispondere»: controlla l’indirizzo del negozio e le regole di reindirizzamento. «Il negozio risponde «non disponibile»»: di solito è la modalità di manutenzione. Dopo una correzione, Pulisci la cache.
• Motore di ricerca del negozio – informativo: quale modulo risponde alle ricerche del tuo negozio («Le ricerche del negozio usano la ricerca di PrestaShop.» oppure «Alle ricerche del negozio risponde …»); «Il modulo di ricerca ha interrotto la richiesta invece di rispondere»: la sua soluzione di riserva reindirizza alla pagina di ricerca del negozio; gli assistenti ricevono allora la ricerca di PrestaShop.
• Assistenti sul telefono: indirizzo sicuro (HTTPS) – fallisce senza SSL: ChatGPT e Claude si collegano solo ai negozi con HTTPS (Apri le impostazioni generali). Un negozio sul tuo computer risulta superato come «Solo per sviluppo».
• Assistenti sul telefono: URL semplificati – fallisce quando gli URL semplificati sono disattivati (Apri le impostazioni SEO e URL).
• Assistenti sul telefono: indirizzi di rilevamento – il negozio recupera i propri documenti /.well-known/oauth-…, dove gli assistenti imparano come accedono gli acquirenti. Richiede attenzione quando rispondono solo le copie del modulo (la maggior parte degli assistenti si collega comunque); fallisce quando non risponde nessuno o quando indicano un altro indirizzo (controlla il dominio del negozio e l’impostazione SSL). Correzione: il tuo server web deve inviare a PrestaShop gli indirizzi che iniziano con /.well-known/oauth-; su Apache nessuna regola del .htaccess deve fermare /.well-known/ prima delle regole di PrestaShop; su Nginx aggiungi una location per /.well-known/oauth- che passi a index.php. Dietro un firewall il server potrebbe non raggiungere il proprio indirizzo: usa invece Apri il documento nel tuo browser.
• Assistenti sul telefono: intestazione di accesso – fallisce quando il tuo server scarta l’accesso inviato dagli assistenti collegati (l’header Authorization): allora non possono usare il carrello, gli ordini né il checkout. Correzione: Apache con PHP come CGI o FastCGI: aggiungi CGIPassAuth On al .htaccess del negozio, oppure mantieni la riga di PrestaShop che copia l’header in HTTP_AUTHORIZATION; Nginx: aggiungi fastcgi_param HTTP_AUTHORIZATION $http_authorization alla location PHP.
• Assistenti sul telefono: lo stesso carrello sul sito – informativo quando Mostra il carrello al login è disattivato: un acquirente che accede al tuo sito riceve allora un carrello nuovo e vuoto invece di quello dell’assistente (il link di pagamento apre comunque il carrello dell’assistente). Correzione: Apri le impostazioni clienti e attivalo.
• Directory di agenti IA – informativo finché Descrivi questo negozio per le directory di agenti IA è disattivato; richiede attenzione se il robots.txt indica ancora la descrizione alle directory (apri Impostazioni › Impostazioni avanzate › Directory di agenti IA e salva). Fallisce quando gli URL semplificati sono disattivati (Parametri Negozio › Traffico & SEO), quando la descrizione o la guida per gli agenti IA non risponde (controlla che il modulo sia attivo per questo negozio, poi pulisci la cache del negozio) o quando la descrizione non rispetta il formato (i dettagli elencano ogni problema). Richiede attenzione quando il tuo server non è riuscito ad aprire il proprio indirizzo (usa invece Apri la descrizione nel tuo browser); quando il tuo server non passa /.well-known/ard.json e /.well-known/ai-catalog.json a PrestaShop (Apache: nessuna regola del .htaccess deve fermare /.well-known/ prima delle regole di PrestaShop; Nginx: una location per questi due indirizzi che passi a index.php); quando /llms.txt non risponde con il riepilogo del modulo (Nginx: fai ripiegare su index.php la location per i file .txt); quando il robots.txt non ha ancora una riga Agentmap: o ne ha una non aggiornata (apri Impostazioni › Impostazioni avanzate › Directory di agenti IA e salva); o quando la sua riga Agentmap: indica un altro dominio (rimuovi quella riga se non è tua). Vedi Directory di agenti IA e llms.txt.
• Form per gli agenti IA – informativo quando Contrassegna i form per gli agenti IA è disattivato («Chrome Lighthouse indica i form del tuo negozio come non contrassegnati per gli agenti IA»; Apri le impostazioni) o quando Offri gli strumenti in questo negozio è disattivato. Richiede attenzione quando negli ultimi 7 giorni le pagine del negozio hanno segnalato form che Chrome considera problemi WebMCP (solo con la Modalità diagnostica attiva): un form del tema o di un altro modulo con solo uno degli attributi toolname e tooldescription (dagli entrambi o nessuno dei due), un form che usa il nome di uno degli strumenti del modulo (rinominalo), due form con lo stesso nome nella stessa pagina, un form contrassegnato con un campo senza nome o senza etichetta, o pulsanti di opzione fuori da un fieldset (correggili nel tema), oppure form contrassegnati come non destinati agli agenti che il browser ha offerto comunque (disattiva Contrassegna i form per gli agenti IA e cerca un aggiornamento del modulo). Vedi Form per gli agenti IA sulle tue pagine.
• Valutazioni e recensioni – quale modulo di recensioni leggono le risposte sui prodotti («Le risposte sui prodotti includono le valutazioni e le recensioni recenti di …»). Informativo quando Mostra valutazioni e recensioni agli agenti IA è disattivato (Apri le impostazioni), quando non è attivo nessun modulo di recensioni che questa versione sa leggere, o quando quello attivo conserva le recensioni sui propri server, raccoglie recensioni del negozio anziché dei prodotti, o questa versione non sa ancora leggerlo; richiede attenzione quando il modulo è attivo ma le sue tabelle delle recensioni non possono essere lette. Vedi Valutazioni e recensioni.
• Spedizione verso i tuoi paesi principali – richiede attenzione quando nessun corriere spedisce verso il tuo paese predefinito o verso uno dei paesi da cui hai ricevuto più ordini negli ultimi 90 giorni («Nessun corriere spedisce verso: …. Clienti e assistenti non trovano alcuna opzione di spedizione.»). Correzione: Apri i corrieri e aggiungi la zona del paese a un corriere.
• Agenti IA verificati – informativo finché Riconosci gli agenti IA verificati è disattivato (Apri le impostazioni) o finché nessun agente IA ha inviato una richiesta firmata nell’ultima settimana (pochi agenti firmano già). È superato con il numero di richieste da agenti verificati. Richiede attenzione quando il tuo PHP non ha l’estensione sodium (chiedi al tuo hosting di attivarla), o quando la maggior parte delle firme di agenti noti non è risultata valida: può dipendere da un proxy o da una CDN che cambia l’indirizzo del negozio, o da un orologio del server sbagliato; i Dettagli elencano i motivi.
• Firewall e agenti IA – il tuo server apre il tuo negozio come un browser, poi come ChatGPT e altri agenti IA, e il tuo server MCP come ChatGPT. È superato quando gli agenti ricevono il tuo negozio come lo riceve un browser. Fallisce quando una regola del firewall o anti-bot li rifiuta o li sottopone a una verifica, e la nomina con cosa cambiare: Cloudflare (criteri per i bot IA: imposta Agent e Search su Allow; Bot Fight Mode non si può aggirare con regole), Imunify360, ModSecurity, LiteSpeed, Sucuri, Akamai, BitNinja, o un limite dell’hosting che risponde «troppe richieste». Richiede attenzione quando il tuo server non riesce ad aprire il proprio indirizzo (frequente dietro i firewall e in Docker) o viene a sua volta sottoposto a verifica, quindi non può stabilirlo da qui.
• Richieste di reso e di annullamento – informativo finché entrambi gli strumenti sono disattivati (Apri gli strumenti). Richiede attenzione quando Richiedi un reso è attivo ma il tuo negozio non accetta resi merce, quindi ogni richiesta di reso viene rifiutata: attiva i resi in Servizio clienti › Restituzione Prodotto (Apri i resi merce). Mostra il tuo periodo di reso.
• Feed dei prodotti per ChatGPT – informativo quando il modulo separato «OpenAI / ChatGPT Ads» non è installato. Richiede attenzione quando è installato ma non attivo in questo negozio, quando il suo feed di prodotti è disattivato, o quando la sua modalità di consegna (indirizzo del feed ospitato o SFTP) non è ancora stata scelta (Apri le sue impostazioni). È superato quando gestisce il tuo feed.
• WebMCP in questo browser – informazioni sul browser che usi ora (vedi Questo browser e i rapporti del negozio).

Altre domande frequenti:

• L’assistente dice che il negozio non ha strumenti. Offri gli strumenti in questo negozio è disattivato, nessuno strumento è attivo in Strumenti, oppure una cache delle pagine serve ancora pagine di prima: svuotala.
• L’assistente non riesce ad aggiungere al carrello. Aggiungi al carrello è disattivato in Strumenti; sul telefono, l’acquirente non ha collegato il suo account.
• Un acquirente non riesce a collegarsi. Il suo account è stato creato con un ordine come ospite (deve crearne uno con una password), oppure un’app diversa da ChatGPT o Claude cerca di collegarsi mentre Consenti qualsiasi app di assistente è disattivato.
• Il link di pagamento dice che non è più valido. È stato usato o è scaduto: l’acquirente chiede all’assistente un link nuovo.
• Un assistente dice che il negozio non ha una risposta su spedizione o resi. Scrivi la risposta in FAQ per gli agenti IA, oppure aggiungi una pagina sull’argomento in Aspetto › Pagine (vedi FAQ per gli agenti IA). Cerca informazioni sul negozio deve essere attivo in Strumenti.
• Un codice sconto viene rifiutato con «Troppi tentativi falliti». Sono stati provati troppi codici che il tuo negozio non conosce da quella sessione o da quell’indirizzo: i tentativi funzionano di nuovo dopo un po’ (vedi Codici sconto).
• Ordini degli assistenti IA resta vuoto. Contano solo gli ordini validi, e solo quelli nel cui carrello è intervenuto un assistente o che sono arrivati dal link di un assistente entro 30 giorni; controlla che Conta gli ordini degli assistenti IA sia attivo (Impostazioni › Impostazioni avanzate › Registrazione). Dietro una cache delle pagine, svuota la cache una volta dopo un aggiornamento (vedi Visite dai link IA dietro una cache delle pagine).
• Un assistente dice che non può inviare una richiesta di reso. Richiedi un reso è disattivato in Strumenti, il cliente non ha effettuato l’accesso, il tuo negozio non accetta resi merce, l’ordine non è ancora stato consegnato o il suo periodo di reso è terminato, oppure il cliente ha già inviato 5 richieste oggi.
• Un link al carrello apre un carrello vuoto. Link al carrello per gli assistenti IA è disattivato, oppure i prodotti non sono disponibili o sono esauriti (la pagina del carrello li indica). Il link riempie il carrello del browser che lo apre, e lo stesso link aggiunge i suoi prodotti una sola volta nell’arco di 10 minuti.
• Prodotti per gli agenti IA mostra punteggi vecchi. I punteggi sono quelli dell’ultimo controllo: scegli Controlla di nuovo.
• Gli assistenti non menzionano il tuo testo per gli agenti IA. Controlla che Dai agli agenti IA i tuoi testi sui prodotti (Impostazioni › Risposte sui prodotti) e lo strumento Mostra i dettagli del prodotto siano attivi, e che il testo esista nella lingua dell’acquirente o nella tua lingua predefinita.
• Gli assistenti trovano meno prodotti della casella di ricerca. Vedi L’indice di ricerca.
• Dietro una CDN le chiamate vengono rifiutate con «troppe richieste». I visitatori che arrivano dallo stesso nodo della CDN ne condividono i limiti: compila Proxy attendibili con gli intervalli di indirizzi pubblicati dalla tua CDN (Impostazioni › Impostazioni avanzate › Limiti).
• Prova con un agente IA dice «Aggiungi una chiave IA o scegli la demo.» Aggiungi una chiave in Chiavi IA, oppure scegli la demo. «Il limite di oggi per i test con IA è stato raggiunto.» Alza Budget giornaliero dei test con IA o aspetta domani; la demo funziona comunque. «… non ha risposto in tempo.» / «Il negozio non è riuscito a raggiungere ….» Il tuo server non riesce ad aprire connessioni HTTPS verso il fornitore: chiedi al tuo hosting di consentire le connessioni HTTPS in uscita verso il fornitore di IA che usi (Anthropic, OpenAI o Google).
• L’audit dice «Il tuo server non è riuscito ad aprire le pagine del proprio negozio.» Usa Controlla da questo browser.
• Il punteggio non è cambiato dopo una correzione. Le barre e le risposte sono quelle dell’ultimo audit completo: esegui di nuovo l’audit completo.
• Il controllo «Agentic browsing» di Chrome Lighthouse elenca elementi senza nome. Esegui l’audit completo e apri Accessibilità per gli agenti IA: i suoi dettagli indicano ogni elemento, la sua pagina e la parte del template che lo stampa (vedi Accessibilità per gli agenti IA). Gli elementi costruiti dagli script li vede solo Lighthouse.
• /llms.txt mostra un testo diverso dal riepilogo del modulo. Viene servito invece un file chiamato llms.txt alla radice del negozio: eliminalo o rinominalo perché risponda il riepilogo del modulo.
• Un link di pagamento aperto su un telefono risponde «Pagina non trovata». Su PrestaShop 8, l’opzione Disattiva su mobile di Gestione Moduli è attiva per il modulo: i link di pagamento allora non si aprono sui telefoni (l’accesso non avviene). Disattivala per questo modulo.

Quando contatti l’assistenza PrestaChamps, indica quali righe di Diagnostica richiedono attenzione e, se il registro è attivo, l’ora e lo strumento di una chiamata non riuscita.

↑ Torna su

Per gli sviluppatori

Altri moduli possono offrire i propri strumenti agli assistenti tramite l’hook del modulo actionPchwebmcpRegisterTools: compaiono allora in Strumenti come «Aggiunto da un altro modulo», disattivati finché non li attivi, e vengono offerti agli assistenti sul telefono solo quando Offri gli strumenti di altri moduli agli assistenti sul telefono è attivo. La guida per sviluppatori (disponibile presso PrestaChamps) descrive l’hook, il formato degli strumenti, i livelli di accesso, l’API del negozio e il server MCP.

↑ Torna su