Kaip pridėti Asyntai DI pokalbių robotą prie OpenCart

Žingsnis po žingsnio vadovas OpenCart svetainėms

Platforma:

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.

1 žingsnis: Gaukite savo įterpimo kodą

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>

Pastaba: Aukščiau pateiktas kodas yra tik pavyzdys. Turite nukopijuoti savo unikalų įterpimo kodą iš savo Valdymo skydelio, nes jame yra jūsų asmeninis valdiklio ID.

Step 2: Edit Footer Template

Paprasčiausias būdas pridėti pokalbių robotą yra redaguoti savo temos poraštės šabloną:

Pasiekite savo OpenCart failus per FTP arba failų tvarkyklę
Eikite į savo temos poraštės šabloną:
- 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
Atidarykite poraštės failą redagavimui
Raskite uždaromąją </body> žymą
Įklijuokite savo Asyntai įterpimo kodą prieš </body> žymą
Išsaugokite failą
Išvalykite OpenCart talpyklą: Valdymo skydelis → Mėlyna krumpliaračio piktograma (viršuje dešinėje) → Atnaujinti arba ištrinkite system/storage/cache/ turinį

Patarimas: Jei naudojate numatytąją temą, kelias būtų catalog/view/theme/default/template/common/footer.twig. Visada sukurkite atsarginę kopiją prieš redaguodami šablonų failus.

Alternatyva: temos individualaus kodo parinkties naudojimas

Daugelis šiuolaikinių OpenCart temų turi integruotą parinktį individualiam kodui:

Prisijunkite prie savo OpenCart administravimo skydelio
Eikite į Extensions → Themes (arba Extensions → Extensions → Themes)
Spustelėkite Redaguoti savo aktyviai temai
Ieškokite "Custom Code", "Footer Scripts" arba "Custom JavaScript" skilties
Įklijuokite savo Asyntai įterpimo kodą
Spustelėkite "Išsaugoti"
Išvalykite talpyklą

Pastaba: Ne visos temos turi šią parinktį. Jei jūsų tema neturi individualaus kodo laukų, naudokite šablono redagavimo metodą arba įdiekite plėtinį.

Alternatyva: individualaus kodo plėtinio naudojimas

Galite įdiegti nemokamą plėtinį iš OpenCart Marketplace, kad pridėtumėte individualius scenarijus:

Go to the OpenCart Marketplace
Ieškokite "Custom Script", "Header Footer Scripts" arba "Custom Code"
Atsisiųskite ir įdiekite tinkamą plėtinį
Savo administravimo skydelyje eikite į Extensions → Extensions → Modules
Raskite ir įdiekite individualaus kodo modulį
Sukonfigūruokite modulį ir įklijuokite savo Asyntai įterpimo kodą poraštės skiltyje
Išsaugokite ir išvalykite talpyklą

Svarbu: Plėtinių naudojimas yra rekomenduojamas vietoj pagrindinių failų redagavimo, nes jie išlieka po OpenCart atnaujinimų. Populiarūs plėtiniai apima "Custom Script in Header & Footer", prieinamą rinkoje.

Alternatyva: addScript metodo naudojimas (kūrėjams)

Kūrėjams OpenCart 3.x/4.x suteikia programinį būdą pridėti scenarijus:

Atidarykite catalog/controller/common/footer.php
Pridėkite šią eilutę prieš $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
Duomenų atributui turėsite modifikuoti footer.twig, kad jį įtrauktumėte rankiniu būdu, arba pridėti tiesioginį JavaScript po scenarijų ciklo

Pastaba: Kad valdiklis tinkamai veiktų su duomenų atributu, šablono metodas yra paprastesnis, nes addScript metodas tiesiogiai nepalaiko individualių atributų.

3 žingsnis: Patikrinkite diegimą

Išsaugoję pakeitimus ir išvalę talpyklą, apsilankykite savo parduotuvėje naujame naršyklės skirtuke arba inkognito lange. Turėtumėte matyti pokalbių valdiklio mygtuką apatiniame dešiniajame kampe. Spustelėkite jį, kad įsitikintumėte, jog jis atsidaro ir veikia teisingai.

Nematote valdiklio? Būtinai išvalykite OpenCart talpyklą. Eikite į administravimo skydelį, spustelėkite mėlyną krumpliaračio piktogramą viršutiniame dešiniajame kampe ir spustelėkite atnaujinimo mygtukus. Taip pat pabandykite išvalyti naršyklės talpyklą arba peržiūrėti inkognito lange. Jei modifikavote netinkamą šablono failą, patikrinkite, ar jūsų tema naudoja jūsų redaguotą failą.

Dokumentacija