Покроковий гайд: безкоштовний модуль для OpenCart 3, 4 та ocStore — каталог синхронізується прямо з магазину, без фіда і правок теми, а на вітрині зʼявляються AI-пошук і чат-помічник.

OpenCart — один із найпоширеніших безкоштовних рушіїв для інтернет-магазинів: він self-hosted, відкритий і має величезну екосистему, включно з українською збіркою ocStore. Тепер підключити до нього Looma можна офіційним модулем: AI-пошук по каталогу і розумний чат-помічник беруть товари прямо з магазину — без фіда, без правок шаблону теми і без програміста.
У цьому гайді пройдемо весь шлях: від встановлення модуля до працюючих віджетів на вітрині. Реальний час — близько 10 хвилин.

Модуль піднімає в магазині захищений read-only ендпоінт, через який Looma читає каталог. На практиці це означає:
Назви й описи мовами магазину, ціни й акційні ціни, головні та додаткові фото — каталог імпортується цілком, посторінково, без вивантаження файлів.
Статуси «в наявності», «немає» і «під замовлення» приїжджають з магазину. Клієнт не побачить у пошуку товар, якого вже немає, а передзамовлення не прикинеться наявним.
Дерево категорій магазину імпортується разом із посиланнями — пошук уміє вести клієнта одразу в потрібний розділ каталогу.
Інформаційні сторінки — «Доставка», «Оплата», «Повернення» — потрапляють у базу знань асистента. Чат відповідає на питання про умови вашими ж словами, а не вигаданими.
Модуль сам додає тег Looma у вітрину — тему правити не треба, і після оновлення шаблону нічого не відвалюється. Якщо ви вже вставили сніпет руками, автовставка вимикається одним перемикачем.
Ключ підключення зберігається в магазині як SHA-256-хеш, працює лише HTTPS, а ендпоінт віддає тільки каталог: замовлення й дані покупців назовні не експонуються. Ядро магазину модуль не патчить.
Є два архіви — під вашу версію платформи:
OpenCart 4.0.x — looma.ocmod.zip
OpenCart 3.0.x та ocStore — looma-oc3.ocmod.zip
Модуль також доступний в офіційному маркетплейсі OpenCart.
Важливо: архів для OpenCart 4 не можна перейменовувати — ім'я файла задає теку розширення в магазині. Перейменований архів встановиться, але працювати не буде.
Виберіть завантажений архів модуля — інсталятор розпакує його сам.
Знайдіть Looma у списку модулів і натисніть «+». На OpenCart 4 цей крок обов'язковий: доки модуль не активовано, його адреса для Looma просто не існує. На 3.x і ocStore «+» вмикає автовставку віджета у вітрину.
Натисніть «Редагувати» біля модуля — відкриється екран підключення до Looma.

Натисніть «Редагувати» біля модуля. На екрані два головні поля:
«Адреса для Looma» — готова адреса вашого магазину для підключення. Не збирайте її руками: маршрут відрізняється між версіями платформи, тому модуль показує правильну сам.
«Ключ підключення» — вставте ключ, згенерований у кабінеті Looma (мінімум 24 символи). У магазині він зберігається лише хешем: прочитати його назад із бази чи побачити в коді сторінки неможливо.

Тут же — перемикачі: що передавати в Looma (товари, розділи, інформаційні сторінки) і чи вставляти віджет у вітрину автоматично. Поле «Останній запит від Looma» покаже час останнього успішного звернення — зручно, щоб одним поглядом перевірити, що зв'язок живий.

Якщо у вас ocStore — модуль повністю локалізований українською:

У кабінеті Looma відкрийте Інтеграції → OpenCart, оберіть свій сайт і натисніть «Налаштувати»:
1. Вставте адресу з екрана модуля.
2. Вставте той самий ключ підключення.
3. Збережіть і натисніть «Перевірити з'єднання».
Статус зміниться на «Підключено», і Looma одразу підтягне розділи та інформаційні сторінки магазину — чекати нічного оновлення не доведеться.
У налаштуваннях сайту в розділі Товари оберіть тип джерела «Інтеграція з магазином» — і запустіть імпорт. Далі каталог оновлюється автоматично раз на добу, а кнопка «Оновити дані» запускає імпорт будь-якої миті — наприклад, після великого завезення товару.
Після імпорту Looma один раз обробляє нові товари для розумного пошуку — і з цього моменту пошук розуміє помилки, синоніми, латиницю та описи, а не лише точні збіги в назві.
На сторінці інтеграції видно всі інформаційні сторінки магазину. Позначте ті, з яких асистент має вчитися — «Доставка і оплата», «Повернення», «Гарантія» — і вони потраплять у базу знань. Тепер на питання «а як у вас із поверненням?» чат відповість умовами саме вашого магазину.
У розділі Команда додайте операторів: кнопка «Запросити учасника» надсилає запрошення на пошту, колега переходить за посиланням — і вже відповідає клієнтам. Оператори працюють у повноцінному інтерфейсі: усі діалоги в одному вікні, картка клієнта, швидкі відповіді й підказки AI. Детально розібрали його в гайді «Онлайн-чат для інтернет-магазину».


На вітрині працюють обидва інструменти. Швидкий пошук відкривається по кліку на звичне поле пошуку магазину: живі результати з фото, цінами, знижками і статусом наявності — за перші символи запиту. А розумний помічник відповідає на питання про товари, доставку й оплату, допомагає обрати з каталогу і за потреби з'єднує з живим оператором.
Ні. Модуль сам додає віджет у вітрину — це і є його головна зручність. Ручна вставка сніпета лишається як опція для тих, хто вже зробив її раніше: тоді автовставку просто вимикають перемикачем.
Ні. Встановлення — стандартний інсталятор розширень OpenCart, підключення — скопіювати адресу та вставити ключ. Файли теми правити не потрібно.
OpenCart 3.0.x, OpenCart 4.0.x і ocStore 3.0.3.7 — сумісність перевірена наживо на кожній. Потрібні PHP 7.4+ і HTTPS на магазині.
Модуль безкоштовний і відкритий (GPL-3.0). Looma — сервіс за передплатою: потрібен акаунт на тарифі з доступом до API.
Лише каталог: товари, розділи та інформаційні сторінки. Замовлення й дані покупців ендпоінт не віддає взагалі — їх неможливо отримати навіть із правильним ключем.
Автоматично раз на добу, плюс кнопка ручного оновлення в кабінеті — для термінових змін.
Так. Перемикач «Вимкнено» в модулі гасить одразу все: ендпоінт, віджет у вітрині й запам'ятований ключ. У Looma інтеграція відключається кнопкою на сторінці підключення.
Реєстрація безкоштовна, підключення — близько 10 хвилин. Ваш каталог уже готовий до розумного пошуку.
Спробувати LoomaLooma підключається за кілька хвилин і починає продавати за вас 24/7.
Спробувати безкоштовно →Looma підключається за кілька хвилин і продає за вас 24/7.