Каталог на сайте
Подключение OpenCart к ReplAI
Установка расширения ReplAI Feed для OpenCart 3.x и ocStore 3.x — каталог и виджет чата за 5–10 минут, программист не нужен.
Инструкция для владельца магазина. Займёт 5–10 минут, программист не нужен. После подключения агент будет знать ваши товары, цены, остатки, акции и информационные страницы (доставка, оплата, гарантия) — и обновляться каждые 30 минут сам. Это же расширение умеет ставить на сайт виджет чата — без правки шаблонов (шаг 7).
Шаг 1. Скачайте расширение
Файл replai_feed.ocmod.zip — это модуль для вашего OpenCart. Скачайте его и
не распаковывайте: OpenCart принимает именно zip.
Шаг 2. Установите расширение
- Зайдите в админку вашего магазина OpenCart.
- Откройте Расширения → Установка расширений (Extension Installer).
- Нажмите Загрузить и выберите скачанный файл.
- Дождитесь сообщения об успешной установке.
Шаг 3. Включите модуль
- Откройте Расширения → Расширения, в списке «Тип расширения» выберите Модули.
- Найдите «ReplAI Feed (фид каталога + виджет чата)» (в версиях до 1.2.0 — «ReplAI Feed (фид каталога)») и нажмите зелёную кнопку «+» (Установить).
- Нажмите синюю кнопку «Редактировать» (карандаш).
- Поставьте Статус: Включено.
- Нажмите Сохранить (дискета справа сверху).
Секретный токен создаётся автоматически — вводить ничего не нужно.
Шаг 4. Скопируйте ссылку фида
- Снова откройте настройки модуля («Редактировать»).
- Внизу найдите поле «Ссылка фида» и нажмите «Копировать».
Ссылка выглядит примерно так:
https://ваш-магазин.kg/index.php?route=extension/module/replai_feed&token=a1b2c3…
Шаг 5. Вставьте ссылку в ReplAI
- Зайдите в кабинет ReplAI и выберите агента.
- Откройте Интеграции → Фид каталога → Настроить.
- В поле «Ссылка фида из модуля OpenCart» вставьте скопированную ссылку и нажмите «Сохранить URL».
- Нажмите «Забрать сейчас».
Через несколько секунд появится сообщение вида «Фид забран: товаров 120…» — значит всё работает. Дальше ReplAI обновляет данные сам, каждые 30 минут.
Шаг 6. Проверьте агента
Напишите агенту в чат на сайте (или в WhatsApp/Telegram, если подключены):
- «Какие у вас есть акции?»
- «Сколько стоит …?» — любой ваш товар
- «Как у вас с доставкой?»
Агент должен отвечать по данным вашего сайта, включая акционные цены («сейчас 2000 вместо 2500, акция до 15 августа»).
Шаг 7. Включите виджет чата (по желанию)
Чтобы окно чата ReplAI появилось в углу вашего сайта, шаблоны править не нужно — начиная с версии 1.2.0 это делает то же расширение:
- В кабинете ReplAI откройте Каналы → Виджет, включите канал и скопируйте
ключ агента (строка вида
agent_01ABC…из блока «Подключение» — можно скопировать и весь код целиком, модуль сам выделит ключ). - В настройках модуля OpenCart найдите секцию «Виджет чата на сайте»: поставьте «Виджет на сайте: Включено», вставьте ключ агента и нажмите Сохранить.
- Обновите любую страницу магазина — в углу появится кнопка чата.
Код добавляется на все страницы автоматически (перед </body>). Выключили
тумблер и сохранили — виджет пропал со всех страниц. Настройка внешнего вида,
разрешённые домены и проверка — в инструкции Чат на сайте
(виджет).
Что попадает в ReplAI
| Из OpenCart | Что увидит клиент у агента |
|---|---|
| Товары (включённые) | Название, цена, наличие, описание, категория |
| Акции («Скидки» / Special у товара) | Акционная цена, старая цена, срок акции |
| Информационные страницы (включённые) | Ответы про доставку, оплату, гарантию — со ссылкой на страницу |
Скрыли товар на сайте или закончилась акция — при следующем обновлении агент перестанет их предлагать.
Частые вопросы
Товары не появились после «Забрать сейчас»
Проверьте, что модуль включён (шаг 3) и ссылка вставлена целиком, вместе с
&token=…. В кабинете под полем URL видна последняя ошибка — её текст
подскажет причину.
В кабинете написано, что ответ фида слишком большой
Так отвечает расширение версии 1.0.0: оно отдавало весь каталог одним куском вместе с полными описаниями товаров. Обновите расширение до 1.1.0 — как обновить. После обновления каталог едет страницами, а описание товара обрезается до 1500 символов: на ответы агента это не влияет (в поиск и так попадало только начало текста), зато фид становится в разы легче.
Ссылка открывается в браузере и показывает 404
Модуль выключен или токен в ссылке не совпадает с токеном в настройках модуля. Откройте настройки модуля и скопируйте ссылку заново.
Как отключить
В кабинете внизу окна «Фид каталога» нажмите «Отключить фид». Уже загруженные товары останутся — их можно скрыть или удалить в разделе «Товары».
Цены с налогами или в другой валюте
Передаются цены, как они заведены в OpenCart (основная валюта магазина, без налогов). Если у вас цены отображаются иначе — напишите нам.
Магазин не на OpenCart?
Любой сайт может отдавать данные в том же формате — это открытый JSON-контракт. Передайте программисту спецификацию ReplAI Feed.