Asyntai AI -chatbotin lisääminen OpenCartiin

Vaiheittainen ohje OpenCart-verkkosivustoille

Alusta:

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.

Vaihe 1: Hanki upotuskoodisi

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>

Huomautus: Yllä oleva koodi on vain esimerkki. Sinun on kopioitava oma yksilöllinen upotuskoodisi Hallintapaneelistasi, sillä se sisältää henkilökohtaisen widget-tunnuksesi.

Step 2: Edit Footer Template

Yksinkertaisin tapa lisätä chatbot on muokata teemasi alatunnistemallia:

Käytä OpenCart-tiedostojasi FTP:n tai tiedostonhallinnan kautta
Siirry teemasi alatunnistemalliin:
- 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
Avaa alatunnistetiedosto muokattavaksi
Etsi sulkeva </body>-tagi
Liitä Asyntai-upotuskoodisi juuri ennen </body>-tagia
Tallenna tiedosto
Tyhjennä OpenCartin välimuisti: Dashboard → sininen rataskuvake (oikeassa yläkulmassa) → Refresh tai poista kansion system/storage/cache/ sisältö

Vinkki: Jos käytät oletusteemaa, polku on catalog/view/theme/default/template/common/footer.twig. Tee aina varmuuskopio ennen mallitiedostojen muokkaamista.

Vaihtoehto: Teeman mukautettu koodi -vaihtoehdon käyttö

Monissa OpenCart-teemoissa on sisäänrakennettu vaihtoehto mukautetulle koodille:

Kirjaudu sisään OpenCart Admin Panel -hallintapaneeliin
Siirry kohtaan Extensions → Themes (tai Extensions → Extensions → Themes)
Napsauta Edit aktiivisessa teemassasi
Etsi "Custom Code"-, "Footer Scripts"- tai "Custom JavaScript" -osio
Liitä Asyntai-upotuskoodisi
Napsauta "Save"
Tyhjennä välimuisti

Huomautus: Kaikissa teemoissa ei ole tätä vaihtoehtoa. Jos teemassasi ei ole mukautetun koodin kenttiä, käytä mallin muokkausmenetelmää tai asenna laajennus.

Vaihtoehto: Mukautetun koodin laajennuksen käyttö

Voit asentaa ilmaisen laajennuksen OpenCart Marketplace -kauppapaikasta mukautettujen skriptien lisäämiseksi:

Go to the OpenCart Marketplace
Etsi hakusanoilla "Custom Script", "Header Footer Scripts" tai "Custom Code"
Lataa ja asenna sopiva laajennus
Siirry hallintapaneelissa kohtaan Extensions → Extensions → Modules
Etsi ja asenna mukautetun koodin moduuli
Määritä moduuli ja liitä Asyntai-upotuskoodisi alatunnisteosioon
Tallenna ja tyhjennä välimuisti

Tärkeää: Laajennusten käyttö on suositeltavampaa kuin ydintiedostojen muokkaaminen, koska ne säilyvät OpenCart-päivitysten yli. Suosittuja laajennuksia ovat esimerkiksi "Custom Script in Header & Footer", joka on saatavilla kauppapaikassa.

Vaihtoehto: addScript-metodin käyttö (kehittäjille)

Kehittäjille OpenCart 3.x/4.x tarjoaa ohjelmallisen tavan lisätä skriptejä:

Avaa catalog/controller/common/footer.php
Lisää seuraava rivi ennen kohtaa $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
Data-attribuuttia varten sinun tulee muokata footer.twig-tiedostoa sisällyttämään se manuaalisesti tai lisätä inline-JavaScript skriptiisilmukan jälkeen

Huomautus: Jotta widget toimisi oikein data-attribuutin kanssa, mallimenetelmä on yksinkertaisempi, koska addScript-metodi ei tue mukautettuja attribuutteja suoraan.

Vaihe 3: Vahvista asennus

Kun olet tallentanut muutoksesi ja tyhjäntänyt välimuistin, avaa kauppasi uudessa selaimen välilehdessä tai incognito-ikkunassa. Chat-widgetin painikkeen pitäisi näkyä oikeassa alakulmassa. Napsauta sitä varmistaaksesi, että se avautuu ja toimii oikein.

Etkö näe widgetiä? Varmista, että tyhjennät OpenCartin välimuistin. Siirry hallintapaneeliin, napsauta sinistä rataskuvaketta oikeassa yläkulmassa ja napsauta päivityspainikkeita. Kokeile myös tyhjentää selaimen välimuisti tai katsoa sivua incognito-ikkunassa. Jos muokkasit väärää mallitiedostoa, tarkista, että teemasi käyttää muokkaamaasi tiedostoa.

Dokumentaatio