Torna alla Dashboard

Documentazione

Scopri come usare Asyntai

Come aggiungere il chatbot IA Asyntai a PrestaShop

Guida passo passo per siti web PrestaShop

Ottieni il codice di incorporamento

Passaggio 1: ottieni il tuo codice di incorporamento

Per prima cosa, vai alla tua Dashboard Asyntai e scorri fino alla sezione "Codice di incorporamento". Copia il tuo codice di incorporamento univoco che apparirà così:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Nota: Il codice sopra è solo un esempio. Devi copiare il tuo codice di incorporamento univoco dalla tua Dashboard poiché contiene il tuo ID widget personale.

Passaggio 2: uso del modulo codice personalizzato (consigliato)

Il modo più semplice per aggiungere il chatbot è usare un modulo gratuito "Custom Code" dal marketplace PrestaShop Addons:

  1. Accedi al tuo Back Office PrestaShop
  2. Vai a Modules → Module Manager
  3. Clicca su "Upload a module" o cerca nel marketplace "Custom Code" o "Header Footer Scripts"
  4. Install a module like "Custom JS and CSS" or similar
  5. Una volta installato, vai alla configurazione del modulo
  6. Trova la sezione "Footer Scripts" o "Before </body>"
  7. Incolla il tuo codice di incorporamento Asyntai
  8. Clicca su "Save"

Suggerimento: I moduli gratuiti popolari per questo scopo includono "Custom JS and CSS Pro", "Custom Code" e "Header and Footer Scripts". Questi moduli sopravvivono agli aggiornamenti del tema e di PrestaShop.

Alternativa: modifica del template del tema (PrestaShop 1.7+/8)

You can add the code directly to your theme's footer template:

  1. Accedi ai file di PrestaShop tramite FTP o gestore file
  2. Vai alla cartella del tuo tema: themes/your_theme/templates/_partials/
  3. Apri il file footer.tpl (o in alcuni temi, controlla templates/layouts/layout-both-columns.tpl)
  4. Trova il tag di chiusura </body> o la sezione {block name='javascript_bottom'}
  5. Incolla il tuo codice di integrazione Asyntai appena prima del tag di chiusura </body>
  6. Salva il file
  7. Svuota la cache di PrestaShop: Advanced Parameters → Performance → Clear cache

Importante: Le modifiche ai file del tema potrebbero essere sovrascritte durante l'aggiornamento del tema. Considera l'uso di un tema figlio o di un modulo per una soluzione più permanente.

Alternativa: uso del file JavaScript personalizzato del tema

Molti temi PrestaShop includono un file custom.js per i tuoi script:

  1. Vai a: themes/your_theme/assets/js/
  2. Cerca un file chiamato custom.js (crealo se non esiste)
  3. Aggiungi il seguente codice per caricare dinamicamente il chatbot:
    (function() {
      var script = document.createElement('script');
      script.async = true;
      script.src = 'https://asyntai.com/static/js/chat-widget.js';
      script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
      document.body.appendChild(script);
    })();
  4. Sostituisci YOUR_WIDGET_ID con il tuo ID widget effettivo
  5. Svuota la cache di PrestaShop

Alternativa: crea un modulo semplice (per sviluppatori)

Per gli sviluppatori, puoi creare un modulo semplice usando l'hook displayFooter:

  1. Crea una cartella: modules/asyntaichatbot/
  2. Crea asyntaichatbot.php con questo codice:
    <?php
    class AsyntaiChatbot extends Module {
      public function __construct() {
        $this->name = 'asyntaichatbot';
        $this->version = '1.0.0';
        $this->author = 'Your Name';
        parent::__construct();
        $this->displayName = 'Asyntai Chatbot';
      }
      public function install() {
        return parent::install() && $this->registerHook('displayFooter');
      }
      public function hookDisplayFooter($params) {
        return '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
      }
    }
  3. Sostituisci YOUR_WIDGET_ID con il tuo ID widget effettivo
  4. Installa il modulo tramite Modules → Module Manager

Passaggio 3: verifica l'installazione

Dopo aver salvato le modifiche e svuotato la cache, visita il tuo negozio in una nuova scheda del browser o in una finestra di navigazione in incognito. Dovresti vedere il pulsante del widget chat nell'angolo in basso a destra. Cliccaci sopra per assicurarti che si apra e funzioni correttamente.

Non vedi il widget? Assicurati di svuotare la cache di PrestaShop: vai a Advanced Parameters → Performance → Clear cache. Prova anche a svuotare la cache del browser o a visualizzare in una finestra di navigazione in incognito. Se usi un modulo personalizzato, verifica che sia abilitato nel Module Manager.