Як додати AI чат-бот Asyntai до OpenCart

Покрокова інструкція для вебсайтів на OpenCart

Платформа:

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: Отримайте код для вставки

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>

Примітка: Код вище є лише прикладом. Ви повиннi скопiювати власний унiкальний код для вставки з вашої Панелi керування, оскiльки вiн мiстить ваш особистий ID вiджета.

Step 2: Edit Footer Template

Найпростіший спосіб додати чат-бот - відредагувати шаблон футера вашої теми:

Отримайте доступ до файлів OpenCart через FTP або файловий менеджер
Перейдіть до шаблону футера вашої теми:
- 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
Відкрийте файл футера для редагування
Знайдіть закриваючий тег </body>
Вставте ваш код для вставки Asyntai безпосередньо перед тегом </body>
Збережіть файл
Очистіть кеш OpenCart: Dashboard → Синій значок шестерні (вгорі праворуч) → Refresh або видаліть вміст system/storage/cache/

Порада: Якщо ви використовуєте тему за замовчуванням, шлях буде catalog/view/theme/default/template/common/footer.twig. Завжди створюйте резервну копію перед редагуванням файлів шаблону.

Альтернатива: Використання опції власного коду теми

Багато сучасних тем OpenCart мають вбудовану опцію для власного коду:

Увійдіть до вашої панелі адміністрування OpenCart
Перейдіть до Extensions → Themes (або Extensions → Extensions → Themes)
Натисніть Edit на вашій активній темі
Знайдіть розділ "Custom Code", "Footer Scripts" або "Custom JavaScript"
Вставте ваш код для вставки Asyntai
Натисніть "Save"
Очистіть кеш

Примітка: Не всі теми мають цю опцію. Якщо ваша тема не включає поля для власного коду, використовуйте метод редагування шаблону або встановіть розширення.

Альтернатива: Використання розширення для власного коду

Ви можете встановити безкоштовне розширення з OpenCart Marketplace для додавання власних скриптів:

Go to the OpenCart Marketplace
Знайдіть "Custom Script", "Header Footer Scripts" або "Custom Code"
Завантажте та встановіть відповідне розширення
У вашій панелі адміністрування перейдіть до Extensions → Extensions → Modules
Знайдіть та встановіть модуль власного коду
Налаштуйте модуль та вставте ваш код вбудовування Asyntai в розділ футера
Збережіть та очистіть кеш

Важливо: Використання розширень рекомендується замість редагування основних файлів, оскільки вони зберігаються після оновлень OpenCart. Популярні розширення включають "Custom Script in Header & Footer", доступне на маркетплейсі.

Альтернатива: Використання методу addScript (для розробників)

Для розробників OpenCart 3.x/4.x надає програмний спосіб додавання скриптів:

Відкрийте catalog/controller/common/footer.php
Додайте наступний рядок перед $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
Для атрибута data вам потрібно буде змінити footer.twig, щоб включити його вручну, або додати вбудований JavaScript після циклу скриптів

Примітка: Щоб віджет працював коректно з атрибутом data, метод шаблону є простішим, оскільки метод addScript не підтримує власні атрибути безпосередньо.

Крок 3: Перевірте встановлення

Після збереження змін та очищення кешу відвідайте ваш магазин у новій вкладці браузера або у вікні інкогніто. Ви повинні побачити кнопку чат-віджета у нижньому правому куті. Натисніть на неї, щоб переконатися, що вона відкривається та працює коректно.

Не бачите віджет? Переконайтеся, що ви очистили кеш OpenCart. Перейдіть до панелі адміністрування, натисніть синій значок шестерні у верхньому правому куті та натисніть кнопки оновлення. Також спробуйте очистити кеш браузера або переглянути сторінку у вікні інкогніто. Якщо ви змінили не той файл шаблону, перевірте, що ваша тема використовує файл, який ви редагували.

Документація