Sådan tilføjer du Asyntai AI-chatbot til OpenCart

Trin-for-trin vejledning til OpenCart-websteder

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.

Trin 1: Hent din indlejringskode

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>

Bemærk: Koden ovenfor er blot et eksempel. Du skal kopiere din egen unikke indlejringskode fra dit Dashboard, da den indeholder dit personlige widget-ID.

Step 2: Edit Footer Template

Den mest ligetil måde at tilføje chatbotten på er ved at redigere dit temas sidefodsskabelon:

Få adgang til dine OpenCart-filer via FTP eller filhåndtering
Naviger til dit temas sidefodsskabelon:
- 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
Åbn sidefodsfilen til redigering
Find det afsluttende </body>-tag
Indsæt din Asyntai indlejringskode lige inden </body>-tagget
Gem filen
Ryd OpenCart-cache: Dashboard → Blåt tandhjulsikon (øverst til højre) → Opdater eller slet indholdet af system/storage/cache/

Tip: Hvis du bruger standardtemaet, vil stien være catalog/view/theme/default/template/common/footer.twig. Opret altid en sikkerhedskopi, inden du redigerer skabelonfiler.

Alternativ: Brug af temaets brugerdefinerede kodeindstilling

Mange moderne OpenCart-temaer inkluderer en indbygget mulighed for brugerdefineret kode:

Log ind på dit OpenCart Admin Panel
Gå til Udvidelser → Temaer (eller Udvidelser → Udvidelser → Temaer)
Klik på Rediger på dit aktive tema
Se efter en sektion med "Brugerdefineret kode", "Sidefodsskripter" eller "Brugerdefineret JavaScript"
Indsæt din Asyntai indlejringskode
Klik på "Gem"
Ryd cache

Bemærk: Ikke alle temaer har denne mulighed. Hvis dit tema ikke inkluderer brugerdefinerede kodefelter, skal du bruge skabelonredigeringsmetoden eller installere en udvidelse.

Alternativ: Brug af en brugerdefineret kodeudvidelse

Du kan installere en gratis udvidelse fra OpenCart Marketplace for at tilføje brugerdefinerede skripter:

Go to the OpenCart Marketplace
Søg efter "Brugerdefineret skript", "Header Footer-skripter" eller "Brugerdefineret kode"
Download og installer en passende udvidelse
I dit adminpanel skal du gå til Udvidelser → Udvidelser → Moduler
Find og installer det brugerdefinerede kodemodul
Konfigurer modulet og indsæt din Asyntai-indlejringskode i sidefodssektionen
Gem og ryd cache

Vigtigt: Brug af udvidelser anbefales frem for redigering af kernefiler, da de overlever OpenCart-opdateringer. Populære udvidelser inkluderer "Custom Script in Header & Footer" tilgængeligt på marketplace.

Alternativ: Brug af addScript-metoden (for udviklere)

For udviklere tilbyder OpenCart 3.x/4.x en programmatisk måde at tilføje skripter på:

Åbn catalog/controller/common/footer.php
Tilføj følgende linje før $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
For dataattributten skal du ændre footer.twig for at inkludere den manuelt eller tilføje inline JavaScript efter skript-løkken

Bemærk: For at widget'en fungerer korrekt med dataattributten er skabelonmetoden enklere, da addScript-metoden ikke understøtter brugerdefinerede attributter direkte.

Trin 3: Verificér installationen

Efter at have gemt dine ændringer og ryddet cachen skal du besøge din butik i en ny browserfane eller et inkognitovindue. Du bør se chat-widget-knappen i nederste højre hjørne. Klik på den for at sikre, at den åbner og fungerer korrekt.

Ser du ikke widget'en? Sørg for at rydde OpenCarts cache. Gå til dit adminpanel, klik på det blå tandhjulsikon i øverste højre hjørne, og klik på opdateringsknapperne. Prøv også at rydde din browsercache eller se siden i et inkognitovindue. Hvis du ændrede den forkerte skabelonfil, skal du kontrollere, at dit tema bruger den fil, du redigerede.

Dokumentation