Installare TellMyShop

Installi TellMyShop come qualsiasi altro modulo PrestaShop. Ci vogliono circa 15 minuti. Alla fine hai l'indirizzo del negozio da incollare in Claude o ChatGPT. Questa pagina raccoglie i dettagli; la versione breve è in Primi passi.

Cosa ti serve

• PrestaShop 8.1 o successivo, fino a 9.x, con PHP 8.1 o successivo (pacchetto principale), oppure PrestaShop 1.7.8–8.2 con PHP 7.2–8.0 (pacchetto separato).
• Se non conosci la tua versione di PHP, chiedi al tuo hosting.
• Un indirizzo del negozio che inizia con https://.
• Un account Claude o ChatGPT. Vanno bene anche gli account gratuiti.
• Accesso al back office del negozio con il permesso di installare moduli.

Non ti serve un PrestaShop Account.

Quale pacchetto scaricare

• TellMyShop Pro: scarica lo ZIP dal tuo account, Account > Download. Ricevi anche una chiave di licenza.
• TellMyShop Free: uno ZIP gratuito separato, senza chiave. La chat legge il negozio, prepara report e ti dice cosa correggere, ma questo pacchetto non può salvare nessuna modifica.

Si installano entrambi allo stesso modo. Per passare più avanti da Free a Pro, carica lo ZIP Pro sopra quello gratuito e incolla la chiave. Impostazioni e cronologia restano.

Passo 1: caricare il modulo

1. Nel back office apri Moduli > Gestione moduli.
2. Clicca Carica un modulo e trascina il file ZIP. Non decomprimerlo.
3. Quando vedi «Modulo installato», clicca Configura.

Nell'elenco dei moduli il modulo si chiama TellMyShop. Se il caricamento non riesce, consulta le domande frequenti.

Passo 2: incollare la chiave di licenza

Con TellMyShop Free salta questo passo. Dettagli più sotto in Attivare la licenza.

Passo 3: configura in 3 passaggi

La scheda Inizio contiene l'elenco Configura in 3 passaggi. Spunta quello che è già fatto.

1. Attivare il connettore. Clicca Attiva il connettore. Questo solo pulsante crea un account separato, «Claude TellMyShop», con cui nessuno può accedere, attiva il connettore ed esegue un backup del database del negozio. Sotto compare l'Indirizzo del negozio per la chat. Fai clic su Copia. Non è segreto: senza la tua approvazione in una finestra del negozio non dà alcun accesso.
2. Aggiungere il negozio nell'app di chat e consentire l'accesso nella finestra del negozio: in Claude come connettore personalizzato, in ChatGPT come server MCP personalizzato nella sezione Plugins. Passo per passo: Collegare il negozio a Claude o ChatGPT.
3. Iniziare la prima conversazione. La scheda contiene un testo iniziale pronto. Incollalo in una nuova chat; la chat conosce il negozio e ti dice da dove cominciare.

L'account creato dal modulo si chiama «Claude TellMyShop» per motivi storici. Serve allo stesso modo per ChatGPT. Non cancellarlo e non modificarne il profilo.

Cosa è impostato dopo l'installazione

Per iniziare non devi cambiare nulla:

• La chat legge tutto il negozio (con TellMyShop Pro): prodotti, categorie, pagine, impostazioni, moduli e log. Non vede ciò che è sempre bloccato né i dati dei tuoi clienti.
• Con una licenza, le modifiche a contenuti, SEO e catalogo vengono salvate subito, sempre dopo un'anteprima e il tuo «sì» nella chat.
• Prezzi, tema, moduli e lavori tecnici sono disattivati. Li attivi nella scheda Salvataggio per area: Vendite resta attivo finché non lo disattivi, Tema e Moduli per 24 ore, Manutenzione per 3 ore. Vedi Cosa può fare la chat.
• I dati dei clienti sono inaccessibili all'IA e cifrati nella cronologia delle modifiche. L'accesso è un'impostazione a parte nella scheda Dati dei clienti (GDPR), e lo attivi solo tu. Vedi I dati dei tuoi clienti.
• Ricevi un'e-mail ogni volta che un'impostazione di sicurezza viene allentata, e un breve riepilogo giornaliero.

Attivare la licenza

1. Copia la chiave di licenza dall'e-mail d'acquisto o da Account > Licenze.
2. Nella schermata delle impostazioni apri la scheda Licenza, incolla la chiave e clicca Attiva. Il dominio del negozio viene assegnato da solo.

Senza una chiave attiva, il pacchetto Pro funziona come TellMyShop Free: la chat legge tutto il negozio e prepara un piano di modifiche, ma non salva nulla. Aggiorna ricontrolla la licenza; Libera il dominio libera il dominio prima di spostare la licenza. Dettagli: Licenze.

Aggiornare o rimuovere il modulo

• Aggiornamento: carica il nuovo ZIP in Gestione moduli, come la prima volta. Impostazioni, cronologia e il connettore nell'app di chat restano.
• Rimozione: Gestione moduli > TellMyShop > Disinstalla. L'indirizzo del connettore smette di funzionare e vengono cancellati l'account «Claude TellMyShop» e i backup del database. Cronologia delle modifiche, backup dei file, reindirizzamenti e licenza vengono conservati; per cancellare tutto, togli la spunta da Conserva cronologia e backup alla disinstallazione in Impostazioni: sicurezza, avvisi, limiti prima di disinstallare. La disinstallazione non libera il dominio della licenza: clicca prima Libera il dominio nella scheda Licenza, oppure liberalo nel tuo account. Le modifiche già approvate restano nel negozio.

Dettagli tecnici

• Nome tecnico tellmyshop. Endpoint: https://your-shop.com/module/tellmyshop/mcp. Per impostazione predefinita la chat effettua il login (OAuth) con la tua approvazione in una finestra del negozio. Metodo precedente (Chat collegate → Avanzate: come si collegano le chat → Indirizzo con chiave (metodo precedente)): token in ?token=… o Authorization: Bearer ….
• Token dell'indirizzo con chiave: vengono salvati solo un hash SHA-256 e un prefisso; il token completo viene mostrato una volta; un nuovo token revoca subito il precedente. Il token del test della connessione vale 2 minuti. Il connettore di servizio separato della 2.6.x è stato rimosso nella 2.7.0.
• Stato dopo l'installazione: connettore disattivato fino al passo 1 della scheda Inizio (Attiva il connettore); Contenuti e SEO, Catalogo salvati subito con una licenza attiva; Vendite, Tema, Moduli e Manutenzione disattivati; livello dei dati dei clienti off; avvisi via e-mail e riepilogo giornaliero attivi.
• Il passo 1 crea il profilo «Claude TellMyShop» e un dipendente inattivo «Claude TellMyShop» (SuperAdmin rifiutato). Dalla 2.7.0 il profilo riceve i permessi di tutte le aree; sono gli interruttori a decidere cosa viene salvato.
• L'installazione registra gli hook registerGDPRConsent, actionDeleteGDPRCustomer, actionExportGDPRData (psgdpr) e actionFrontControllerInitBefore (reindirizzamenti e 301 del blog). Crea la directory privata var/tellmyshop/ per backup e chiavi; la chiave di cifratura è var/tellmyshop/keys/history.key.
• La disinstallazione cancella sempre i token e la chiave di firma, dipendente e profilo creati dal modulo, lo script di emergenza e la sua chiave, il registro delle connessioni e tutti i backup del database. Con TELLMYSHOP_KEEP_ON_UNINSTALL attivo (valore di fabbrica) conserva cronologia delle modifiche, backup dei file, reindirizzamenti, registro di audit, la directory privata con la chiave e la licenza; disattivato, cancella tutte le tabelle del modulo, tutte le impostazioni TELLMYSHOP_* e var/tellmyshop/. La disinstallazione non contatta il server delle licenze, quindi il dominio resta attivato finché non viene liberato nella scheda Licenza o nell'account.
• Tutti i dettagli: Specifica tecnica.

---

PrestaShop è un marchio registrato di PrestaShop SA. Claude è un marchio di Anthropic. ChatGPT è un marchio di OpenAI. TellMyShop non è affiliato a nessuna di queste società.