Кнопки «Купити», «До списку бажань» і «Порівняти» в картках товарів у чаті Elbuz викликають ваш JavaScript, і товар потрапляє в кошик сайту, не виходячи з розмови. Для поширених CMS код підставляється вибором зі списку.
Коли це знадобиться:
- «Купити» в чаті відкриває сторінку товару — код події додає товар у кошик сайту одразу.
- Сайт на OpenCart, WooCommerce, Shopify чи Horoshop — готовий код підставляє вибір «CMS ID».
- Чат накладається на кнопку іншого віджета — свій код при відкритті й закритті чату ховає та повертає її.
- Вікно чату не в тон сайту в дрібницях — свій CSS підправляє окремі елементи.
З чого почати: вкладка «Налаштування» → картка «Сайт» → «CMS ID».
Що налаштовується
- Готовий код для CMS — шість полів подій заповнюються вибором платформи.
- Код подій — що робить кожне поле і що буде, якщо воно порожнє.
- Дані товару — що отримує ваш код.
- Сайт із розумним пошуком — чий код спрацює.
- Свій JS і CSS — код при відкритті й закритті вікна, стилі.
Готовий код для вашої CMS
На вкладці «Налаштування», у картці «Сайт», виберіть платформу в «CMS ID». Програма підставить код для цієї CMS у шість полів вкладки «Події», а якщо заповнена «Адреса сайту» — ще й «Посилання на кошик» на вкладці «Посилання».
| CMS | Кошик | Обране і порівняння |
|---|---|---|
| OpenCart | додати й прибрати | є |
| Elbuz CMS | додати й прибрати | є |
| WooCommerce (WordPress) | додати й прибрати | є, під поширені плагіни обраного й порівняння |
| Magento (Adobe Commerce) | додати й прибрати | є |
| Horoshop | додати й прибрати | є |
| Shopify | додати й прибрати | немає |
| PrestaShop, BigCommerce, Squarespace Commerce | готового коду немає — код пише ваш розробник | немає |
«CMS theme» — теми OpenCart: OCT ShowCase, OCT Deals, OCT Promo; у списку лише теми вибраної CMS. Тема додає до коду OpenCart оновлення лічильників кошика, обраного й порівняння в шапці сайту і відкриття міні-кошика, а ShowCase і Deals — ще й код у «Виконати код JS після закриття».
Порожні поля програма заповнює мовчки. Якщо готовий код замінить поля, які ви вже заповнили, з'явиться питання «Застосувати налаштування CMS?» зі списком цих полів:
- «Замінити» — підставити готовий код і в заповнені поля;
- «Заповнити лише порожні» — ваш код лишиться, готовий піде тільки в порожні поля;
- «Скасувати» — нічого не змінювати.
Варіант «---» нічого не змінює.
Нові значення з'являються в полях, але зберігаються, коли ви закриєте вікно або зміните інше поле. У магазині на Elbuz CMS код подій заповнюється під час підключення віджета, вибирати нічого не треба. Якщо OpenCart вибрали до 15.11.2026, виберіть CMS ще раз і натисніть «Замінити» — тоді з чату запрацює й «Видалення з кошика».
1
Адреса сайту2
CMS ID3
CMS theme- Основа посилань; з нею вибір CMS заповнює й адреси кошика.
- Підставляє готовий код подій для вашої платформи.
- Теми OpenCart; у списку лише теми вибраної CMS.
Код подій: що робить кожне поле
На вкладці «Події» шість полів — по парі на кошик, обране й порівняння. Код виконується в браузері покупця, на вашому сайті, коли він натискає кнопку в картці товару в чаті.
| Поле | Коли виконується | Якщо поле порожнє |
|---|---|---|
| «Додавання в кошик» | натискання «Купити» в картці товару | натискання відкриває сторінку товару в новій вкладці |
| «Видалення з кошика» | повторне натискання на вже додану кнопку | повторне натискання нічого не робить |
| «Додавання до списку бажань», «Додати до порівняння» | натискання «До списку бажань» чи «Порівняти» | кнопка лише змінює вигляд, на сайт нічого не йде |
| «Видалення зі списку бажань», «Видалення з порівняння» | повторне натискання на ці кнопки | кнопка лише змінює вигляд |
Кнопка стає «доданою», тільки якщо код спрацював: якщо код робить запит до сайту, відповідь має бути успішною і без ознаки помилки. Інакше покупець бачить «Не вдалося додати: можливо, потрібно вибрати параметри товару.» і посилання на товар. Після вдалого додавання під списком товарів з'являється «Перейти до кошика», якщо задано посилання на кошик.
1
Додавання в кошик2
Видалення з кошика3
Обране й порівняння- Виконується по «Купити»; порожньо — відкривається сторінка товару.
- Повторне натискання на додану кнопку.
- Порожні поля — кнопка лише змінює вигляд.
Які дані товару отримує код
Код отримує змінну productData з полями:
| Поле | Що в ньому |
|---|---|
id | номер товару в Elbuz |
id_ext | номер товару у вашій CMS — його чекає кошик сайту |
sku, mpn | артикул і код виробника |
name, url, image_url | назва, посилання на товар і фото |
Кількості й ціни в productData немає: готові шаблони кладуть одну штуку. Номер у CMS (id_ext) береться з картки товару, а якщо на вкладці «Посилання» задано зовнішнє джерело — зі зв'язку з ним (джерело). Товар без номера в CMS у кошик сайту не потрапить.
Якщо номера в CMS у каталозі немає або він інший, заповніть картку «Витягування ID товару» на вкладці «Події»: перед кодом кошика віджет відкриває сторінку товару і бере номер CSS-селектором або регулярним виразом («Тип витягування»). Без галочки «Завжди витягувати ID зі сторінки товару» номер зі сторінки береться, лише коли в каталозі його немає; з галочкою — завжди. Працює так само, як у розумному пошуку.
Сайт, де стоїть ще й розумний пошук
Якщо на сторінці працює віджет розумного пошуку, «Купити», «До списку бажань» і «Порівняти» в чаті виконують код із налаштувань пошуку, а не чату (кошик у розумному пошуку). Прибрати товар із кошика — інакше: спершу виконується «Видалення з кошика» чату, а після успіху — код видалення пошуку. Тому на сайті з пошуком заповніть кошик у пошуку і «Видалення з кошика» в чаті.
Свій JS і CSS віджета
Картка «Налаштування JS, CSS» на вкладці «Налаштування» — для розробника, який підганяє чат під сайт.
- «Виконати код JS перед відкриттям» — виконується щоразу перед тим, як вікно чату з'явиться. Типове застосування — сховати кнопку іншого віджета, яка перекриває чат.
- «Виконати код JS після закриття» — після того як покупець закрив вікно: повернути сховане.
- «Стилі CSS» — додаються на сторінку, коли завантажується чат.
- «Код JS» — виконується один раз, коли чат завантажився на сторінці.
Код при відкритті й закритті чат доповнює своїм: ховає й повертає віджет Binotel, якщо той є на сайті.
1
Код при відкритті2
Код після закриття3
Стилі CSS- Виконується щоразу перед тим, як вікно чату з’явиться.
- Повернути те, що сховали при відкритті.
- Додаються на сторінку разом із чатом.
Сценарії
Сайт на OpenCart
Що налаштувати. «Адреса сайту», «CMS ID» — OpenCart, за потреби «CMS theme».
Що вийде. «Купити» в чаті кладе одну штуку в кошик сайту, повторне натискання прибирає її, під товарами — «Перейти до кошика».
Сайт на платформі без готового коду
Що налаштувати. Розробник пише в «Додавання в кошик» виклик кошика сайту з productData.id_ext.
Що вийде. Те саме, що з готовим кодом. Поки поле порожнє, «Купити» відкриває сторінку товару.
Чат перекриває кнопку зворотного дзвінка
Що налаштувати. У «Виконати код JS перед відкриттям» — сховати кнопку, у «Виконати код JS після закриття» — показати.
Що робити, коли кнопки в чаті не працюють
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Купити» відкриває сторінку товару | «Додавання в кошик» порожнє | Вибрати «CMS ID» або вписати код (CMS) |
| «Не вдалося додати: можливо, потрібно вибрати параметри товару.» | Сайт відповів помилкою — часто товару немає номера в CMS | Перевірити номер товару в CMS у картці товару або налаштувати «Витягування ID товару» (дані) |
| Після вибору CMS лишився старий код подій | У питанні «Застосувати налаштування CMS?» натиснули «Заповнити лише порожні» або «Скасувати» | Вибрати CMS ще раз і натиснути «Замінити» (CMS) |
| Код подій чату змінили, а на сайті нічого не змінилось | На сайті стоїть розумний пошук, працює його код | Правити код у віджеті пошуку (пошук) |
| Свій код при відкритті чи закритті не виконується | Синтаксична помилка в коді | Перевірити код у консолі браузера (JS) |
Часті запитання
Чи працює чат без коду подій?
Так. Чат відповідає й показує товари, а «Купити» відкриває сторінку товару, де покупець додає його в кошик сам.
Чи можна з чату покласти дві штуки?
Готові шаблони кладуть одну штуку: кількості в даних товару немає (дані). Більше — уже в кошику сайту.
Навіщо кошик сайту, якщо AI приймає замовлення в чаті?
Це два різні шляхи. Оформлення в розмові створює замовлення в Elbuz, а кошик сайту потрібен, коли покупець оформлює сам (замовлення з чату).
Чи потрібен код подій чату, якщо на сайті стоїть розумний пошук?
Для «Купити», обраного й порівняння — ні, працює код пошуку. «Видалення з кошика» в чаті заповніть, інакше прибрати товар із чату не вийде (пошук).
Де це і хто має доступ
- Меню
- Довідники → Категорії → «Інструменти каталогу» → «Налаштування віджету - Розумний помічник» → вкладка «Події»
- CMS, JS і CSS
- та сама форма, вкладка «Налаштування» → картки «Сайт» і «Налаштування JS, CSS»
- Підготувати
- номери товарів у CMS у картках товарів; для своєї платформи — розробника
Суміжні теми
- Якщо потрібна загальна картина налаштувань чату — як налаштувати віджет чату на сайті.
- Якщо «Перейти до кошика» веде не туди — посилання на кошик.
- Якщо на сайті стоїть і розумний пошук — кошик у розумному пошуку.
- Якщо покупець має оформити замовлення просто в розмові — заявки й замовлення з чату.
