Jak přidat Asyntai AI chatbota do OpenCart

Podrobný návod pro weby na platformě 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: Získejte svůj vkládací kód

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>

Poznámka: Kód výše je pouze příklad. Musíte zkopírovat svůj vlastní unikátní kód pro vložení z vašeho Dashboardu, protože obsahuje vaše osobní ID widgetu.

Step 2: Edit Footer Template

Nejpřímější způsob přidání chatbota je úprava šablony zápatí vašeho motivu:

Přistupte k souborům OpenCart přes FTP nebo správce souborů
Přejděte do šablony zápatí svého motivu:
- 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
Otevřete soubor zápatí pro úpravu
Najděte uzavírací značku </body>
Vložte svůj Asyntai embed kód těsně před značku </body>
Uložte soubor
Vymažte mezipaměť OpenCart: Nástěnka → Modrá ikona ozubeného kola (vpravo nahoře) → Obnovit nebo smažte obsah system/storage/cache/

Tip: Pokud používáte výchozí motiv, cesta by byla catalog/view/theme/default/template/common/footer.twig. Před úpravou souborů šablon vždy vytvořte zálohu.

Alternativa: Použití možnosti vlastního kódu motivu

Mnoho moderních motivů OpenCart obsahuje vestavěnou možnost pro vlastní kód:

Přihlaste se do administračního panelu OpenCart
Přejděte na Rozšíření → Motivy (nebo Rozšíření → Rozšíření → Motivy)
Klikněte na Upravit u svého aktivního motivu
Hledejte sekci "Vlastní kód", "Skripty zápatí" nebo "Vlastní JavaScript"
Vložte svůj vkládací kód Asyntai
Klikněte na "Save"
Vymažte mezipaměť

Poznámka: Ne všechny motivy mají tuto možnost. Pokud váš motiv neobsahuje pole pro vlastní kód, použijte metodu úpravy šablony nebo nainstalujte rozšíření.

Alternativa: Použití rozšíření pro vlastní kód

Můžete nainstalovat bezplatné rozšíření z OpenCart Marketplace pro přidání vlastních skriptů:

Go to the OpenCart Marketplace
Vyhledejte "Custom Script", "Header Footer Scripts" nebo "Custom Code"
Stáhněte a nainstalujte vhodné rozšíření
Ve svém administračním panelu přejděte na Rozšíření → Rozšíření → Moduly
Najděte a nainstalujte modul vlastního kódu
Nakonfigurujte modul a vložte svůj vložený kód Asyntai do sekce zápatí
Uložte a vymažte mezipaměť

Důležité: Použití rozšíření je doporučeno před úpravou základních souborů, protože přežijí aktualizace OpenCart. Mezi oblíbená rozšíření patří "Custom Script in Header & Footer" dostupné na tržišti.

Alternativa: Použití metody addScript (Pro vývojáře)

Pro vývojáře poskytuje OpenCart 3.x/4.x programový způsob přidání skriptů:

Otevřete catalog/controller/common/footer.php
Přidejte následující řádek před $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
Pro datový atribut budete muset upravit footer.twig tak, aby jej zahrnoval ručně, nebo přidat inline JavaScript za smyčku skriptů

Poznámka: Pro správné fungování widgetu s datovým atributem je metoda šablony jednodušší, protože metoda addScript přímo nepodporuje vlastní atributy.

Krok 3: Ověřte instalaci

Po uložení změn a vymazání mezipaměti navštivte svůj obchod v nové kartě prohlížeče nebo v anonymním okně. V pravém dolním rohu byste měli vidět tlačítko chatového widgetu. Klikněte na něj a ověřte, že se správně otevírá a funguje.

Nevidíte widget? Nezapomeňte vymazat mezipaměť OpenCart. Přejděte do svého administračního panelu, klikněte na modrou ikonu ozubeného kola v pravém horním rohu a klikněte na tlačítka obnovení. Zkuste také vymazat mezipaměť prohlížeče nebo stránku zobrazit v anonymním okně. Pokud jste upravili špatný soubor šablony, zkontrolujte, že váš motiv používá soubor, který jste upravili.

Dokumentace