Come aggiungere il chatbot IA Asyntai a OpenCart

Guida passo passo per siti web OpenCart

Piattaforma:

The Easy Way: Install the Asyntai Extension

We publish a free extension on the OpenCart Marketplace. It puts the chatbot on your storefront and connects your account, and there is no code to copy and no template to edit. It works on OpenCart 3.x and 4.x.

Download Asyntai - AI Chatbot from the OpenCart Marketplace
In your admin panel, go to Extensions → Installer and upload the ZIP file
Go to Extensions → Extensions, choose Modules in the list, find Asyntai AI Chatbot and press the green install button
Press edit, then press Connect to Asyntai. A window opens where you sign in or create an account.

That is all. The chatbot is live on your storefront when the window closes.

Your products, prices and stock

When you connect, the extension also lets Asyntai read your catalogue. Your assistant then answers with the price you charge today and tells shoppers what is in stock, instead of repeating whatever your pages said when they were last read.

Asyntai reads your products through a read-only address on your own store. Every request is signed, and the reply carries the prices a shopper would actually pay, with your tax rules already applied. You can switch this off at any time on the extension's settings screen.

Updating from version 1.0.0? OpenCart clears a module's settings when you uninstall it, so press Connect to Asyntai once after the update. From this version on, updates keep your connection.

Or Add the Code Yourself

Prefer not to install an extension? The rest of this page shows how to add the chatbot by hand. You will not get the catalogue reading this way.

Passaggio 1: ottieni il tuo codice di incorporamento

First, go to your Asyntai Dashboard and scroll down to the "Embed Code" section. Copy your unique embed code which will look like this:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</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.

Step 2: Edit Footer Template

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

Molti temi moderni di OpenCart includono un'opzione integrata per il codice personalizzato:

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:

Go to the 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.

Documentazione