Встановлення

Додайте Looma на ваш сайт за допомогою єдиного тега скрипта. Жодних інструментів збірки чи залежностей не потрібно.

Код встановлення

Перейдіть на вкладку Код установки у налаштуваннях сайту в Дашборді Looma і скопіюйте код встановлення. Він виглядає так:

<script>
(function(d) {
    var s = d.createElement('script');
    s.defer = true;
    s.src = 'https://widget.looma.chat/loader.js?token=YOUR_SITE_TOKEN';
    if (d.head) d.head.appendChild(s);
})(document);
</script>

Вставте цей код у секцію <head> або перед закривальним тегом </body> на кожній сторінці вашого сайту.

WARNING

Замініть YOUR_SITE_TOKEN на ваш реальний токен сайту з дашборду. Кожен сайт має унікальний токен.

Вкладка Код установки також має кнопку Завантажити PDF, яка експортує покрокову інструкцію (зручно для передачі розробнику), і опцію Google Tag Manager для сайтів, де ви не можете редагувати HTML напряму.

Угорі вкладки — стан встановлення (Віджет не встановлено, доки віджет не завантажився на вашому сайті), далі сам код у блоці Крок 1: Скопіюйте цей код з кнопкою Копіювати код, а в Кроці 2 — приклад, куди саме на сторінці його вставити. Примітка внизу нагадує спершу налаштувати AI-асистента або Швидкий пошук: від цих налаштувань залежить, які віджети з'являться на сайті.

Через Google Tag Manager

Якщо на сайті вже працює Google Tag Manager, а шаблон редагувати не можна, натисніть на тій самій вкладці або через Google Tag Manager. У вікні інструкції п'ять кроків: відкрити контейнер на tagmanager.google.com, створити тег Custom HTML, вставити код (кнопка Копіювати код — тут же), налаштувати тригер All Pages, зберегти тег і натиснути Submit для публікації.

Що буде встановлено

Скрипт-завантажувач автоматично додає на ваш сайт два віджети:

• AI Чат — інтелектуальна бульбашка асистента в нижньому правому куті
• Швидкий пошук — рядок пошуку, який може замінити стандартний пошук вашого магазину (опціонально, потребує налаштування)

За замовчуванням кнопка чату — синя кнопка з іконкою та скругленими кутами в правому нижньому куті; її розташування, форму, колір і підпис задають у налаштуваннях віджета AI-асистента.

Інструкції для конкретних платформ

Shopify

1. Перейдіть у Online Store > Themes > Edit code
2. Відкрийте файл theme.liquid
3. Вставте код встановлення перед закривальним тегом </head>
4. Натисніть Save

WooCommerce / WordPress

1. Перейдіть у Appearance > Theme File Editor
2. Відкрийте header.php (або functions.php)
3. Вставте код перед закривальним тегом </head>
4. Натисніть Update File

Альтернативно скористайтеся плагіном на кшталт Insert Headers and Footers:

1. Встановіть та активуйте плагін
2. Перейдіть у Settings > Insert Headers and Footers
3. Вставте код у секцію "Scripts in Header"

OpenCart

1. Перейдіть у Design > Theme Editor (або редагуйте файли шаблонів напряму)
2. Відкрийте шаблон хедера (common/header.twig)
3. Вставте код перед </head>
4. Збережіть зміни

PrestaShop

1. Перейдіть у Design > Theme & Logo > Advanced
2. Або відредагуйте themes/your-theme/templates/_partials/head.tpl
3. Додайте код встановлення
4. Очистіть кеш

Wix

1. Перейдіть у Settings > Custom Code (у розділі Advanced)
2. Натисніть Add Custom Code
3. Вставте код встановлення
4. Встановіть розміщення Head і застосуйте до All pages
5. Опублікуйте ваш сайт

Tilda

1. Перейдіть у Site Settings > More > HTML in head
2. Вставте код встановлення
3. Збережіть і перепублікуйте

Власний / статичний HTML

Просто додайте тег скрипта у ваш HTML-шаблон у секцію <head> або перед </body>.

Перевірка встановлення

Після додавання коду:

1. Відвідайте ваш сайт
2. Ви маєте побачити бульбашку чату Looma в нижньому правому куті
3. На вкладці Код установки в Дашборді Looma стан зміниться на зелений Віджет встановлено

Стан стежить за реальними завантаженнями віджета: він стає зеленим, щойно віджет завантажився на вашому сайті, і повертається до Віджет не встановлено, якщо віджет не завантажувався понад 6 годин (наприклад, код прибрали або сторінка віддається зі старого кешу).

Тестування

Ви можете протестувати віджет перед встановленням на сайт:

• Чат: https://widget.looma.chat/chat.html?token=YOUR_SITE_TOKEN
• Пошук: https://widget.looma.chat/search.html?token=YOUR_SITE_TOKEN

Наступні кроки

• Налаштування AI Асистента — персоналізуйте поведінку чату
• Налаштування Швидкого пошуку — увімкніть пошуковий віджет
• Товари та AI Magic Data — керуйте вашим каталогом товарів