Перейти к содержимому
ReplAI
Разделы документации

Каталог на сайте

Подключение OpenCart к ReplAI

Установка расширения ReplAI Feed для OpenCart 3.x и ocStore 3.x — каталог и виджет чата за 5–10 минут, программист не нужен.

Инструкция для владельца магазина. Займёт 5–10 минут, программист не нужен. После подключения агент будет знать ваши товары, цены, остатки, акции и информационные страницы (доставка, оплата, гарантия) — и обновляться каждые 30 минут сам. Это же расширение умеет ставить на сайт виджет чата — без правки шаблонов (шаг 7).

Шаг 1. Скачайте расширение

Файл replai_feed.ocmod.zip — это модуль для вашего OpenCart. Скачайте его и не распаковывайте: OpenCart принимает именно zip.

Скачать replai_feed.ocmod.zip

Шаг 2. Установите расширение

  1. Зайдите в админку вашего магазина OpenCart.
  2. Откройте Расширения → Установка расширений (Extension Installer).
  3. Нажмите Загрузить и выберите скачанный файл.
  4. Дождитесь сообщения об успешной установке.

Шаг 3. Включите модуль

  1. Откройте Расширения → Расширения, в списке «Тип расширения» выберите Модули.
  2. Найдите «ReplAI Feed (фид каталога + виджет чата)» (в версиях до 1.2.0 — «ReplAI Feed (фид каталога)») и нажмите зелёную кнопку «+» (Установить).
  3. Нажмите синюю кнопку «Редактировать» (карандаш).
  4. Поставьте Статус: Включено.
  5. Нажмите Сохранить (дискета справа сверху).

Секретный токен создаётся автоматически — вводить ничего не нужно.

Шаг 4. Скопируйте ссылку фида

  1. Снова откройте настройки модуля («Редактировать»).
  2. Внизу найдите поле «Ссылка фида» и нажмите «Копировать».

Ссылка выглядит примерно так:

https://ваш-магазин.kg/index.php?route=extension/module/replai_feed&token=a1b2c3…

Шаг 5. Вставьте ссылку в ReplAI

  1. Зайдите в кабинет ReplAI и выберите агента.
  2. Откройте Интеграции → Фид каталога → Настроить.
  3. В поле «Ссылка фида из модуля OpenCart» вставьте скопированную ссылку и нажмите «Сохранить URL».
  4. Нажмите «Забрать сейчас».

Через несколько секунд появится сообщение вида «Фид забран: товаров 120…» — значит всё работает. Дальше ReplAI обновляет данные сам, каждые 30 минут.

Шаг 6. Проверьте агента

Напишите агенту в чат на сайте (или в WhatsApp/Telegram, если подключены):

  • «Какие у вас есть акции?»
  • «Сколько стоит …?» — любой ваш товар
  • «Как у вас с доставкой?»

Агент должен отвечать по данным вашего сайта, включая акционные цены («сейчас 2000 вместо 2500, акция до 15 августа»).

Шаг 7. Включите виджет чата (по желанию)

Чтобы окно чата ReplAI появилось в углу вашего сайта, шаблоны править не нужно — начиная с версии 1.2.0 это делает то же расширение:

  1. В кабинете ReplAI откройте Каналы → Виджет, включите канал и скопируйте ключ агента (строка вида agent_01ABC… из блока «Подключение» — можно скопировать и весь код целиком, модуль сам выделит ключ).
  2. В настройках модуля OpenCart найдите секцию «Виджет чата на сайте»: поставьте «Виджет на сайте: Включено», вставьте ключ агента и нажмите Сохранить.
  3. Обновите любую страницу магазина — в углу появится кнопка чата.

Код добавляется на все страницы автоматически (перед </body>). Выключили тумблер и сохранили — виджет пропал со всех страниц. Настройка внешнего вида, разрешённые домены и проверка — в инструкции Чат на сайте (виджет).

Что попадает в ReplAI

Из OpenCart Что увидит клиент у агента
Товары (включённые) Название, цена, наличие, описание, категория
Акции («Скидки» / Special у товара) Акционная цена, старая цена, срок акции
Информационные страницы (включённые) Ответы про доставку, оплату, гарантию — со ссылкой на страницу

Скрыли товар на сайте или закончилась акция — при следующем обновлении агент перестанет их предлагать.

Частые вопросы

Товары не появились после «Забрать сейчас»

Проверьте, что модуль включён (шаг 3) и ссылка вставлена целиком, вместе с &token=…. В кабинете под полем URL видна последняя ошибка — её текст подскажет причину.

В кабинете написано, что ответ фида слишком большой

Так отвечает расширение версии 1.0.0: оно отдавало весь каталог одним куском вместе с полными описаниями товаров. Обновите расширение до 1.1.0 — как обновить. После обновления каталог едет страницами, а описание товара обрезается до 1500 символов: на ответы агента это не влияет (в поиск и так попадало только начало текста), зато фид становится в разы легче.

Ссылка открывается в браузере и показывает 404

Модуль выключен или токен в ссылке не совпадает с токеном в настройках модуля. Откройте настройки модуля и скопируйте ссылку заново.

Как отключить

В кабинете внизу окна «Фид каталога» нажмите «Отключить фид». Уже загруженные товары останутся — их можно скрыть или удалить в разделе «Товары».

Цены с налогами или в другой валюте

Передаются цены, как они заведены в OpenCart (основная валюта магазина, без налогов). Если у вас цены отображаются иначе — напишите нам.

Магазин не на OpenCart?

Любой сайт может отдавать данные в том же формате — это открытый JSON-контракт. Передайте программисту спецификацию ReplAI Feed.