Come aggiungere il chatbot IA Asyntai a OpenCart

Guida passo passo per siti web OpenCart

Piattaforma:

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: modifica il template del footer (consigliato)

Il modo più semplice per aggiungere il chatbot è modificare il template del footer del tuo tema:

Accedi ai file di OpenCart tramite FTP o gestore file
Vai al template del footer del tuo tema:
- OpenCart 3.x/4.x: catalog/view/theme/YOUR_THEME/template/common/footer.twig
- OpenCart 2.x: catalog/view/theme/YOUR_THEME/template/common/footer.tpl
Apri il file del footer per la modifica
Trova il tag di chiusura </body>
Incolla il codice di incorporamento Asyntai appena prima del tag </body>
Salva il file
Svuota la cache di OpenCart: Dashboard → icona ingranaggio blu (in alto a destra) → Refresh oppure elimina il contenuto di system/storage/cache/

Suggerimento: Se stai usando il tema predefinito, il percorso sarà catalog/view/theme/default/template/common/footer.twig. Crea sempre un backup prima di modificare i file dei template.

Alternativa: uso dell'opzione codice personalizzato del tema

Many modern OpenCart themes include a built-in option for custom code:

Accedi al tuo pannello di amministrazione OpenCart
Vai a Extensions → Themes (o Extensions → Extensions → Themes)
Clicca su Edit sul tuo tema attivo
Cerca una sezione "Custom Code", "Footer Scripts" o "Custom JavaScript"
Incolla il tuo codice di incorporamento Asyntai
Clicca su "Save"
Svuota la cache

Nota: Non tutti i temi hanno questa opzione. Se il tuo tema non include campi per il codice personalizzato, usa il metodo di modifica del template o installa un'estensione.

Alternativa: uso di un'estensione per codice personalizzato

Puoi installare un'estensione gratuita dall'OpenCart Marketplace per aggiungere script personalizzati:

Vai all'OpenCart Marketplace
Cerca "Custom Script", "Header Footer Scripts" o "Custom Code"
Scarica e installa un'estensione adatta
Nel tuo pannello di amministrazione, vai a Extensions → Extensions → Modules
Trova e installa il modulo per il codice personalizzato
Configura il modulo e incolla il tuo codice di incorporamento Asyntai nella sezione footer
Salva e svuota la cache

Importante: L'uso delle estensioni è consigliato rispetto alla modifica dei file core, poiché sopravvivono agli aggiornamenti di OpenCart. Le estensioni popolari includono "Custom Script in Header & Footer" disponibile sul marketplace.

Alternativa: uso del metodo addScript (per sviluppatori)

Per gli sviluppatori, OpenCart 3.x/4.x fornisce un modo programmatico per aggiungere script:

Apri catalog/controller/common/footer.php
Aggiungi la seguente riga prima di $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
Per l'attributo data, dovrai modificare il footer.twig per includerlo manualmente, oppure aggiungere JavaScript inline dopo il ciclo degli script

Nota: Affinché il widget funzioni correttamente con l'attributo data, il metodo del template è più semplice poiché il metodo addScript non supporta direttamente gli attributi personalizzati.

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 OpenCart. Vai al tuo pannello di amministrazione, clicca sull'icona ingranaggio blu nell'angolo in alto a destra e clicca sui pulsanti di aggiornamento. Prova anche a svuotare la cache del browser o a visualizzare in una finestra di navigazione in incognito. Se hai modificato il file del template sbagliato, verifica che il tuo tema stia usando il file che hai modificato.