Как добавить ИИ-чат-бот 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>

Примечание: Код выше — всего лишь пример. Вы должны скопировать свой уникальный код для встраивания с вашей Панели управления, так как он содержит ваш персональный идентификатор виджета.

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: Панель управления → Синяя шестерёнка (верхний правый угол) → Обновить или удалить содержимое 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. Перейдите в панель администратора, нажмите на синюю иконку шестерёнки в правом верхнем углу и нажмите кнопки обновления. Также попробуйте очистить кэш браузера или открыть сайт в режиме инкогнито. Если вы изменили не тот файл шаблона, убедитесь, что ваша тема использует именно отредактированный файл.

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