> For the complete documentation index, see [llms.txt](https://smartypilot.gitbook.io/smartypilot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smartypilot.gitbook.io/smartypilot/cms-supportati/cms-supportati/prestashop.md). # Prestashop ### 1. Installazione del modulo {% hint style="info" %} **Versioni supportate**: PrestaShop dalla 1.7 alla 9.x. {% endhint %} Per prima cosa, scarica e installa il modulo Smartypilot per PrestaShop: 1. [**Scarica il modulo**](https://plugin.smartypilot.ai/downloads/prestashop/smartypilot_1.7.13.zip) seguendo questo link (versione 1.7.13). 2. Accedi al pannello di amministrazione di PrestaShop. 3. Vai su **Moduli → Gestione moduli → Carica un modulo**. 4. Trascina il file `.zip` appena scaricato nell'area di upload, oppure clicca per selezionarlo. 5. PrestaShop installerà e attiverà il modulo automaticamente. Una volta installato, troverai le impostazioni del modulo in **Moduli → Gestione moduli**, cercando "Smartypilot". *** ### 2. Configurazione guidata Al primo accesso alla pagina del modulo, viene avviata automaticamente una procedura guidata in tre passi che collega il modulo al tuo account Smartypilot. Non devi cercare o copiare manualmente alcun codice tecnico. #### Dove trovare la chiave di integrazione Prima di iniziare, recupera la tua chiave dal pannello Smartypilot: 1. Accedi a [**admin.smartypilot.ai**](https://admin.smartypilot.ai/). 2. Vai in **Catalogo prodotti**, seleziona il tuo indice e apri la sezione **Generali**. 3. Copia il valore **Chiave di integrazione plugin CMS**. #### Passo 1 — Connessione 1. Nella pagina del modulo, incolla la chiave nel campo **Chiave di integrazione CMS**. 2. Clicca su **Connetti**. Il modulo contatta Smartypilot e recupera automaticamente tutte le informazioni necessarie (ID store e chiavi indice per ogni lingua). Se la chiave non è corretta, viene mostrato un messaggio di errore e puoi riprovare. #### Passo 2 — Impostazioni feed e ricerca Dopo la connessione, scegli come il modulo deve sincronizzare il catalogo prodotti con Smartypilot: **Modalità Diretta** *(consigliata)*\ Smartypilot recupera il catalogo direttamente dal tuo sito ogni volta che avvia una sincronizzazione. Non richiede configurazioni aggiuntive sull'hosting. **Modalità Cron**\ Il catalogo viene generato come file durante la notte tramite un'attività pianificata. Adatta a negozi con cataloghi molto grandi. Richiede la configurazione di un cron job nel pannello del tuo hosting (vedi istruzioni al Passo 3). Verifica anche il valore del campo **ID del campo di ricerca**: indica l'attributo `name` o `id` dell'elemento di ricerca del tuo tema. Il valore predefinito `s` è quello del tema nativo di PrestaShop 8 e 9; se usi un tema personalizzato, controlla il codice sorgente del tuo sito per trovare il valore corretto. {% hint style="warning" %} Se il campo di ricerca non viene identificato correttamente, il widget di ricerca Smartypilot non si aggancerà al campo giusto nel tuo tema. In caso di dubbi, chiedi supporto al team Smartypilot. {% endhint %} Clicca su **Completa configurazione** per procedere. #### Passo 3 — Sincronizzazione del catalogo La configurazione è completata. Prima che la ricerca sia operativa, devi eseguire la prima sincronizzazione del catalogo. **Se hai scelto la modalità Diretta:** 1. Accedi a [**admin.smartypilot.ai**](https://admin.smartypilot.ai/). 2. Vai in **Catalogo prodotti** e seleziona il tuo indice. 3. Clicca su **Avvia sincronizzazione**. **Se hai scelto la modalità Cron:** Prima della sincronizzazione, devi attivare il cron: 1. Copia le URL cron mostrate nella pagina di completamento (una per ogni lingua del negozio). 2. Accedi al pannello di gestione del tuo hosting e registra quelle URL come attività pianificate (es. ogni notte alle 02:00). 3. Attendi che il cron venga eseguito almeno una volta, oppure avvialo manualmente dal pannello hosting. 4. Solo dopo la prima esecuzione del cron, accedi a [**admin.smartypilot.ai**](https://admin.smartypilot.ai/) e avvia la sincronizzazione da **Catalogo prodotti → Avvia sincronizzazione**. {% hint style="danger" %} Senza la prima sincronizzazione, i widget di ricerca non mostreranno risultati. La sincronizzazione è un passaggio obbligatorio dopo l'installazione. {% endhint %} *** ### 3. Attivazione del chatbot (se incluso) Se il tuo abbonamento include il Chatbot AI, la configurazione dell'endpoint di recupero ordini avviene automaticamente durante la procedura guidata. Per abilitare il widget nel front-end del sito: 1. Accedi alle impostazioni del modulo e vai nella tab **Chatbot**. 2. Attiva l'opzione **Abilita Chatbot Smartypilot**. *** ### 4. Attivazione del widget Product Q\&A (se incluso) Il modulo include il widget **Product Q\&A**, che permette agli utenti di fare domande direttamente sulla pagina prodotto e ricevere risposte generate dall'AI. 1. Vai nella tab **ProductQA** nella pagina di configurazione. 2. Spunta **Abilita Product Q\&A**. 3. Scegli la **posizione** in cui visualizzare il widget nella pagina prodotto: * **In fondo alla pagina prodotto** (impostazione predefinita) * **Sotto le immagini del prodotto** * **Sotto il pulsante Aggiungi al carrello** *** ### 5. Export del catalogo prodotti Il modulo esporta automaticamente il tuo catalogo verso Smartypilot in formato CSV. Il campo **Modalità sincronizzazione feed** offre due scelte: * **Diretta / Asincrona (URL live)**: il file viene generato quando Smartypilot lo richiede. In questa modalità il modulo ti mostra due indirizzi: quello **diretto**, che genera il file al momento ed è adatto a cataloghi piccoli, e quello **asincrono**, che lavora in background senza bloccare il server ed è consigliato per cataloghi medi o grandi. Scegli quale dei due indicare in Smartypilot. * **Programmata (Cron notturno)**: il file viene generato a orari prestabiliti da un'attività pianificata sul tuo hosting. Puoi anche configurare i **gruppi clienti** da includere nell'export, per esportare prezzi differenziati per tipologia di acquirente. Il file generato contiene tutte le informazioni sui prodotti: nome, SKU, EAN, categoria, prezzo, disponibilità, immagini, attributi delle combinazioni e feature. *** ### 6. Modificare la configurazione o rifare la procedura guidata Dopo aver completato la configurazione guidata, puoi accedere in qualsiasi momento alle impostazioni del modulo dalla tab **Ricerca**, **Chatbot** e **ProductQA**. Se hai bisogno di ricollegare il modulo a un account diverso, o di aggiornare le impostazioni del feed, usa il pulsante **Riesegui configurazione guidata** in fondo alla pagina di configurazione. La procedura guidata riparte dall'inizio e puoi incollare una nuova chiave di integrazione.