Cum să adăugați Chatbot-ul AI Asyntai în OpenCart

Ghid pas cu pas pentru site-urile OpenCart

Platformă:

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.

Pasul 1: Obțineți codul de încorporare

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>

Notă: Codul de mai sus este doar un exemplu. Trebuie să copiați propriul cod unic de încorporare din Tabloul de bord, deoarece conține ID-ul personal al widgetului dvs.

Step 2: Edit Footer Template

Cel mai direct mod de a adăuga chatbot-ul este prin editarea șablonului de subsol al temei:

Accesați fișierele OpenCart prin FTP sau managerul de fișiere
Navigați la șablonul de subsol al temei:
- 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
Deschideți fișierul footer pentru editare
Găsiți eticheta de închidere </body>
Inserați codul de încorporare Asyntai chiar înainte de eticheta </body>
Salvați fișierul
Goliți cache-ul OpenCart: Dashboard → Pictograma roată albastră (dreapta sus) → Refresh sau ștergeți conținutul din system/storage/cache/

Sfat: Dacă utilizați tema implicită, calea ar fi catalog/view/theme/default/template/common/footer.twig. Faceți întotdeauna o copie de siguranță înainte de a edita fișierele de șablon.

Alternativă: Utilizarea opțiunii de cod personalizat a temei

Multe teme OpenCart moderne includ o opțiune integrată pentru cod personalizat:

Conectați-vă la Panoul de administrare OpenCart
Mergeți la Extensions → Themes (sau Extensions → Extensions → Themes)
Faceți clic pe Edit pe tema activă
Căutați o secțiune "Custom Code", "Footer Scripts" sau "Custom JavaScript"
Inserați codul de încorporare Asyntai
Faceți clic pe "Salvare"
Goliți cache-ul

Notă: Nu toate temele au această opțiune. Dacă tema dvs. nu include câmpuri de cod personalizat, utilizați metoda de editare a șablonului sau instalați o extensie.

Alternativă: Utilizarea unei extensii de cod personalizat

Puteți instala o extensie gratuită de pe OpenCart Marketplace pentru a adăuga scripturi personalizate:

Go to the OpenCart Marketplace
Căutați "Custom Script", "Header Footer Scripts" sau "Custom Code"
Descărcați și instalați o extensie potrivită
În panoul de administrare, mergeți la Extensions → Extensions → Modules
Găsiți și instalați modulul de cod personalizat
Configurați modulul și lipiți codul de integrare Asyntai în secțiunea de subsol
Salvați și goliți cache-ul

Important: Utilizarea extensiilor este recomandată în locul editării fișierelor de bază, deoarece acestea supraviețuiesc actualizărilor OpenCart. Extensiile populare includ "Custom Script in Header & Footer" disponibilă pe marketplace.

Alternativă: Utilizarea metodei addScript (Pentru dezvoltatori)

Pentru dezvoltatori, OpenCart 3.x/4.x oferă o modalitate programatică de a adăuga scripturi:

Deschideți catalog/controller/common/footer.php
Adăugați următoarea linie înainte de $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
Pentru atributul data, va trebui să modificați footer.twig pentru a-l include manual, sau să adăugați JavaScript inline după bucla de scripturi

Notă: Pentru ca widget-ul să funcționeze corect cu atributul data, metoda șablonului este mai simplă deoarece metoda addScript nu suportă atribute personalizate direct.

Pasul 3: Verificați instalarea

După ce ați salvat modificările și ați golit cache-ul, vizitați magazinul într-o filă nouă de browser sau într-o fereastră incognito. Ar trebui să vedeți butonul widget-ului de chat în colțul din dreapta jos. Faceți clic pe el pentru a vă asigura că se deschide și funcționează corect.

Nu vedeți widgetul? Asigurați-vă că goliți cache-ul OpenCart. Mergeți la panoul de administrare, faceți clic pe pictograma roată albastră din colțul din dreapta sus și faceți clic pe butoanele de reîmprospătare. De asemenea, încercați să goliți cache-ul browserului sau să vizualizați într-o fereastră incognito. Dacă ați modificat fișierul de șablon greșit, verificați că tema dvs. utilizează fișierul pe care l-ați editat.

Documentație