Jak dodać chatbota Asyntai AI do OpenCart

Instrukcja krok po kroku dla stron OpenCart

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.

Krok 1: Pobierz swój kod osadzania

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>

Uwaga: Powyższy kod to tylko przykład. Musisz skopiować swój własny unikalny kod osadzania z Panelu, ponieważ zawiera on Twój osobisty identyfikator widgetu.

Step 2: Edit Footer Template

Najprostszym sposobem dodania chatbota jest edycja szablonu stopki Twojego motywu:

Uzyskaj dostęp do plików OpenCart przez FTP lub menedżera plików
Przejdź do szablonu stopki Twojego motywu:
- 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
Otwórz plik stopki do edycji
Znajdź zamykający znacznik </body>
Wklej kod osadzania Asyntai tuz przed znacznikiem </body>
Zapisz plik
Wyczyść pamięć podręczną OpenCart: Dashboard → Niebieska ikona zębatki (prawy górny róg) → Refresh lub usuń zawartość system/storage/cache/

Wskazówka: Jeśli używasz domyślnego motywu, ścieżka będzie catalog/view/theme/default/template/common/footer.twig. Zawsze twórz kopię zapasową przed edycją plików szablonów.

Alternatywa: Użycie opcji niestandardowego kodu motywu

Wiele nowoczesnych motywów OpenCart posiada wbudowaną opcję dodawania własnego kodu:

Zaloguj się do panelu administracyjnego OpenCart
Przejdź do Extensions → Themes (lub Extensions → Extensions → Themes)
Kliknij Edit przy aktywnym motywie
Poszukaj sekcji "Custom Code", "Footer Scripts" lub "Custom JavaScript"
Wklej swój kod osadzania Asyntai
Kliknij "Save"
Wyczyść pamięć podręczną

Uwaga: Nie wszystkie motywy mają tę opcję. Jeśli Twój motyw nie zawiera pól niestandardowego kodu, użyj metody edycji szablonu lub zainstaluj rozszerzenie.

Alternatywa: Użycie rozszerzenia niestandardowego kodu

Możesz zainstalować darmowe rozszerzenie z OpenCart Marketplace, aby dodać niestandardowe skrypty:

Go to the OpenCart Marketplace
Wyszukaj "Custom Script", "Header Footer Scripts" lub "Custom Code"
Pobierz i zainstaluj odpowiednie rozszerzenie
W panelu administracyjnym przejdź do Extensions → Extensions → Modules
Znajdź i zainstaluj moduł niestandardowego kodu
Skonfiguruj moduł i wklej kod osadzania Asyntai w sekcji stopki
Zapisz i wyczyść pamięć podręczną

Ważne: Użycie rozszerzeń jest zalecane zamiast edycji plików podstawowych, ponieważ przetrwają one aktualizacje OpenCart. Popularne rozszerzenia obejmują „Custom Script in Header & Footer” dostępne na rynku.

Alternatywa: Użycie metody addScript (dla deweloperów)

Dla deweloperów OpenCart 3.x/4.x udostępnia programistyczny sposób dodawania skryptów:

Otwórz catalog/controller/common/footer.php
Dodaj nastepujaca linie przed $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
W przypadku atrybutu data należy zmodyfikowac footer.twig, aby dolaczyc go ręcznie, lub dodać wbudowany JavaScript po petli skryptów

Uwaga: Aby widget działał poprawnie z atrybutem data, metoda szablonowa jest prostsza, ponieważ metoda addScript nie obsługuje bezpośrednio niestandardowych atrybutow.

Krok 3: Weryfikacja instalacji

Po zapisaniu zmian i wyczyszczeniu pamięci podręcznej odwiedź swoj sklep w nowej karcie przeglądarki lub w oknie incognito. Powinieneś zobaczyć przycisk widgetu czatu w prawym dolnym rogu. Kliknij go, aby upewnić sie, ze otwiera sie i działa poprawnie.

Nie widzisz widgetu? Upewnij sie, ze wyczysciles pamięć podręczna OpenCart. Przejdź do panelu administracyjnego, kliknij niebieska ikone zebatki w prawym gornym rogu i kliknij przyciski odswiezania. Spróbuj również wyczyść pamięć podręczna przeglądarki lub wyświetlić stronę w oknie incognito. Jeśli zmodyfikowales niewlasciwy plik szablonu, sprawdź, czy Twój motyw używa edytowanego pliku.

Dokumentacja