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

Подключение 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. Установите расширение

Зайдите в админку вашего магазина 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.
В поле «Ссылка из модуля OpenCart» вставьте скопированную ссылку и нажмите «Подключить».

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

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

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

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

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

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

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

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

С версии 1.5.0 работает и корзина из чата: когда агент показывает товары карточками, на фото каждой есть кнопка «В корзину» — выбранный цвет и размер ложатся в корзину вашего сайта, а покупатель остаётся в разговоре. Проверки те же, что на странице товара: обязательные опции, минимальное количество, наличие. Если товар нельзя положить без выбора на странице, покупатель увидит подсказку под карточкой, а карточка откроет страницу товара. Отдельно включать ничего не нужно — достаточно обновить расширение.

С версии 1.5.3 агент узнаёт о добавлении: подтверждает покупку, может предложить подходящее к товару и даёт кнопку «Оформить заказ» — она ведёт на оформление заказа на вашем сайте.

Корзина в шапке сайта показывает новый товар сразу, без перезагрузки страницы, в стандартной теме OpenCart, а с версии 1.5.1 — и в темах Unishop2 и Deals (Octemplates). В других темах товар тоже ложится в корзину, но счётчик в шапке может обновиться только при переходе на другую страницу — напишите в поддержку, и мы добавим вашу тему.

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

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

Из OpenCart	Что увидит клиент у агента
Товары (включённые)	Название, цена, наличие, описание, категория, производитель, фото
Статус товара, когда он закончился («Под заказ», «Предзаказ», «2-3 дня», «Нет в наличии»), начиная с плагина 1.4.3	«Под заказ» — агент так и говорит и предлагает оформить через менеджера; иначе, в том числе при отрицании («Недоступен для заказа»), — «нет в наличии»
Опции цвета, размера или памяти: «Цвет», «Размер», «Память» и подобные, а у обязательной опции — и «Выбрать цвет смартфона», «Встроенная память», «Цвет ремешка» (тип «Список», «Переключатель», «Картинка»)	Варианты товара: какие цвета и размеры/объёмы памяти есть, цена и наличие каждого
Артикул карточки (`SKU` в OpenCart, начиная с плагина 1.4.2)	Артикул товара отдельно от технического номера; цветовые варианты не получают выдуманные отдельные артикулы
Необязательные допы со значениями на выбор: стекло, чехол, карта памяти, способ оплаты и другие	Пока ничего: пометка «Дополнительная опция на сайте» сохраняется в характеристиках товара в каталоге ReplAI, но агенту не передаётся, и сам доп он не предложит. Доп не становится размером или вариантом, его цена и наличие не попадают в товар; выбрать доп покупатель может на сайте
Акции («Скидки» / Special у товара)	Акционная цена, старая цена, срок акции
Информационные страницы (включённые)	Ответы про доставку, оплату, гарантию — со ссылкой на страницу
Адрес страницы товара (с ЧПУ, если он включён), начиная с плагина 1.5.0	Фото и название карточки товара в чате открывают товар на сайте

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

Цвет — опция с названием «Цвет», «Цвет товара», «Цвет корпуса», Color, Colour, «Колір» или «Түс». Второй осью становится размер или память: «Размер», «Размер одежды», «Размер обуви», Size, «Память», «Объём», «Объём памяти», Memory, Storage, RAM, ROM, Volume. Такие названия — ось у любой опции, обязательной или нет. Регистр, двоеточие, лишние пробелы и «ё»/«е» не важны: «Размер:» — тоже размер.

С версии 1.4.3 у обязательной опции осью становится и длинное название с отдельным словом «цвет», Color/Colour, «Түс» или «размер», Size, «память», RAM, ROM, «накопитель», Storage, «ёмкость», «объём» вместе с памятью/накопителем: «Выбрать цвет смартфона», «Встроенная память», «Объём накопителя», «Цвет ремешка». Раньше такие товары скрывались с пометкой «Требуется выбор на сайте». Необязательная опция с таким названием остаётся допом: «Размер защитного стекла», «Цвет чехла» или «Добавить карту памяти» не меняют цену и наличие самого товара. Опции, которые названием похожи на доп или оплату (стекло, плёнка, чехол, кабель, зарядка, карта, взнос, предоплата, рассрочка, кредит, оплата, гарантия, доставка, установка), осью не становятся и тогда, когда они обязательные. Карта и чехол узнаются только целым словом: обязательные «Цвет картриджа», «Размер картины» или «Размер обуви (Чехия)» — оси, а «Карта памяти» и «Цвет чехла» — допы. Допы вроде «Добавить защитное стекло», «Платежные карты» или «Добавить чековая лента» осью тоже не становятся.

Остаток варианта не превышает актуальный остаток самого товара. Выбранные цвет и размер дополнительно ограничивают его своими остатками, если у значения включено «Вычитать со склада». Значение без списания, даже с нулём в поле количества, не уменьшает остаток товара. Если сам товар закончился, наличие стекла или другого допа не делает его доступным. Настройка магазина «Оформлять заказ при отсутствии» разрешает заказ, но не подтверждает наличие. OpenCart не хранит запас отдельных сочетаний: показанное число — предел для выбранного варианта, а не отдельный склад каждой комбинации.

Поддержаны две оси: цвет и размер/память. Третья обязательная ось, обязательный неподдержанный выбор (например способ оплаты или гравировка), а также неподдержанная операция цены вместо +/- требуют оформления на сайте. Такие варианты скрываются у агента; причина передаётся в атрибутах каталога. Необязательные допы автоматически не выбираются: от них остаётся только пометка в характеристиках товара, и агенту она пока не передаётся. Пометку «Дополнительная опция на сайте» получает только доп, который покупатель может выбрать: со значениями, типа «Список», «Переключатель», «Флажок» или «Картинка». Пустые опции и текстовые поля её не дают. Если расширение ocStore изменяет правила корзины или склада, проверьте соответствие остатков с вашим разработчиком.

После обновления плагина нажмите «Обновить сейчас» в ReplAI и дождитесь полного обхода фида. Старые варианты, созданные из дополнительных опций, исчезнут после этого снимка; уже распознанные цвета/размеры сохраняют свои технические ID и ссылки для заказа. Если опция впервые стала цветом или размером (с версии 1.4.3 — например обязательная «Встроенная память» или «Размер:»), у товара появятся варианты с новыми техническими ID и ссылками заказа, а прежняя запись снимается с продажи — подробнее.

С версии 1.4.2 артикул берётся из поля SKU товара в OpenCart. Номер товара в базе и поле Модель вместо артикула не подставляются. Если SKU не заполнен, бизнес-артикул остаётся пустым. У товара с выбираемыми цветами или размерами SKU карточки сохраняется отдельно: стандартный OpenCart не хранит собственный SKU каждого сочетания. Подписи «Кредит» и «Рассрочка», включая варианты «через банк», больше не становятся штрихкодами; условия оплаты агент получает из информационных страниц магазина.

Под заказ

OpenCart показывает на сайте статус товара, когда остаток кончился: его выбирают в карточке товара на вкладке «Данные» (в английской админке — Out Of Stock Status). С версии 1.4.3 расширение передаёт этот статус в ReplAI:

Статус в карточке при остатке 0	Что скажет агент
«Под заказ», «Предзаказ», «Ожидание», «2-3 дня», «1 неделя» — любой с «заказ», «ожида», днями или неделями, если в нём нет отрицания	Под заказ — назовёт ваш статус и предложит оформить через менеджера
«Нет в наличии», «Отсутствует», «Закончился» и любой статус с отрицанием: «Недоступен для заказа», «Заказ невозможен», «Не ожидается», «Нельзя заказать», Unavailable	Нет в наличии
«В наличии» или свой текст без этих слов	Нет в наличии — остаток 0

Если остаток больше нуля, товар в наличии, какой бы статус ни стоял. Статус относится к остатку самого товара. Вариант, у которого распродан выбранный цвет или размер (у значения включено «Вычитать со склада», а количество 0), — нет в наличии при любом статусе: такое значение OpenCart на сайте не показывает. Заказ на товар под заказ агент сам не оформляет: его подтверждает ваш менеджер, как и сейчас при нулевом остатке.

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

Товары не появились после подключения

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

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

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