Інтеграція з PrestaShop

Підключіть свій чатбот ChatLab до магазину PrestaShop, щоб надати клієнтам доступ до інформації про товари та відстеження замовлень у реальному часі безпосередньо в чаті.

Важливо: найкращі практики для E-Commerce

Після завершення наведеної нижче інтеграції ознайомтеся з вичерпним посібником з оптимізації вашого чатбота для електронної комерції: How to set up ChatLab for your E-commerce store

Що забезпечує інтеграція

Пошук товарів - клієнти можуть шукати у вашому каталозі PrestaShop, ввівши фразу. Чатбот здійснює пошук за назвами та описами товарів, повертаючи топ-5 товарів, які найбільше відповідають запиту, разом із:

• ID товару, назвою та описом
• Ціною (за бажанням із застосуванням податку та спеціальних знижок)
• Прямим посиланням на сторінку товару у вашому магазині
• Зображенням товару

Пошук товарів за артикулом (SKU) - клієнти можуть шукати товари за точними кодами артикулів. Чатбот шукає за кількома типами ідентифікаторів - артикул/SKU, штрихкод EAN-13, ISBN та MPN - як для самих товарів, так і для їхніх варіантів (комбінацій). Це корисно, коли клієнти мають конкретний код товару з каталогу, рахунку або упаковки.

Деталі замовлення - клієнти можуть перевірити статус свого замовлення, вказавши ID замовлення та адресу електронної пошти, пов'язану із цим замовленням. Обидва значення перевіряються за записами вашого магазину PrestaShop. Чатбот повертає:

• Номер (reference) замовлення, дату та поточний статус (наприклад, в обробці, виконано, скасовано)
• Загальну суму замовлення
• Ім'я одержувача, компанію, повну адресу доставки (вулиця, місто, поштовий індекс) та номер телефону
• Назву перевізника та номери відстеження (підтримується кілька номерів відстеження)
• Замовлені позиції з назвами, кількістю та індивідуальними цінами

Попередні вимоги

Перед початком інтеграції з PrestaShop переконайтеся, що:

• Ваш чатбот уже додано до магазину PrestaShop - див. Installing Chatbot on a PrestaShop Store
• Ви маєте доступ до панелі адміністратора (back office) PrestaShop

Крок 1. Увімкніть вебслужбу в PrestaShop

1. Увійдіть до панелі керування PrestaShop
2. Перейдіть до Configure > Advanced Parameters > Webservice (Налаштувати > Розширені параметри > Вебслужба)

3. Прокрутіть униз до розділу Configuration (Конфігурація)
4. Встановіть перемикач Enable PrestaShop's webservice (Увімкнути вебслужбу PrestaShop) у положення Yes (Так)
5. Натисніть Save (Зберегти)

Крок 2. Створіть ключ вебслужби

1. На тій самій сторінці Webservice натисніть Add new webservice key (Додати новий ключ вебслужби)

2. Натисніть Generate (Згенерувати), щоб створити новий ключ
3. Введіть опис (наприклад, "ChatLab Integration")
4. Переконайтеся, що ключ має статус Enabled (Увімкнено)
5. У дозволах для ресурсів надайте доступ View (GET) (Перегляд (GET)) до таких ресурсів:
   • addresses
   • attachments
   • carriers
   • categories
   • combinations
   • configurations
   • customers
   • languages
   • order_carriers
   • order_details
   • order_states
   • orders
   • product_customization_fields
   • product_feature_values
   • product_features
   • product_option_values
   • product_options
   • products
   • search
   • specific_price_rules
   • specific_prices
   • states
   • states
   • stock_availables
   • tags
   • tax_rule_groups
   • tax_rules
   • taxes

6. Натисніть Save
7. Скопіюйте згенерований ключ вебслужби - він знадобиться вам на наступному кроці

Крок 3. Знайдіть формат URL ваших товарів

1. У панелі керування PrestaShop перейдіть до Configure > Shop Parameters > Traffic & SEO (Налаштувати > Параметри магазину > Трафік і SEO)

2. Прокрутіть униз до розділу Schema of URLs (Схема URL)
3. Скопіюйте значення з поля Route to products (Маршрут до товарів, наприклад, {category:/}{id}{-:id_product_attribute}-{rewrite}{-:tags}.html)

Крок 4. Підключіть PrestaShop у ChatLab

1. Увійдіть у ChatLab і виберіть свого бота
2. Перейдіть на вкладку Connect (Підключення)

3. Натисніть Connect на картці PrestaShop
4. Введіть свій Webservice key (Ключ вебслужби з кроку 2)
5. Введіть свій Shop url (повний URL вашого магазину, наприклад, https://www.mystore.com)
6. Введіть свій Product url format (Формат URL товару з кроку 3)

7. Натисніть Initialize Configuration (Ініціалізувати конфігурацію) - це завантажить доступні мови з вашого магазину
8. Виберіть потрібну мову зі спадного списку Default language (Мова за замовчуванням)
9. Натисніть Connect

ChatLab автоматично протестує з'єднання, перевіривши наявність необхідних прав доступу у вашого ключа вебслужби. У разі успіху ви побачите повідомлення з підтвердженням.

Крок 5. Налаштуйте дії PrestaShop

Після підключення ви можете активувати та налаштувати окремі дії AI. Перейдіть до Settings > Actions (Налаштування > Дії) та відфільтруйте список за платформою PrestaShop.

Доступні такі дії:

• Prestashop - product search - дозволяє чатботу шукати у вашому каталозі товарів за назвою
• Prestashop - search by reference - дозволяє чатботу знаходити товари за кодами артикулів/SKU, EAN-13, ISBN або MPN
• Prestashop - order details - дозволяє чатботу переглядати інформацію про замовлення
• Prestashop - get product variants - дозволяє чатботу отримувати детальну інформацію про варіанти (розміри, кольори) для конкретного товару

Натисніть кнопку активації біля кожної дії, щоб увімкнути її. Ви також можете змінити назву дії (повідомлення, яке відображається користувачам під час виконання дії) та інструкції, які визначають, як саме AI використовує кожну дію.

Якщо дію "Search by reference" увімкнено, звичайний пошук товарів також автоматично переходитиме на пошук за кодом артикулу, якщо за назвою нічого не знайдено. Це означає, що клієнти можуть ввести SKU або штрихкод у звичайному пошуковому запиті та все одно отримати точні результати.

Показувати товари з датою поповнення запасів (попереднє замовлення)

Коли в налаштуваннях дії Product Search увімкнено "Products in stock only", ви можете додатково активувати "Show products with restock date". Це дозволяє чатботу показувати товари, яких немає в наявності, але для яких у PrestaShop встановлено очікувану дату надходження. Замість того щоб повністю приховувати ці товари, чатбот повідомить клієнту дату поповнення запасів і те, що товар доступний для попереднього замовлення.

Вимоги:

• У PrestaShop має бути увімкнено "Allow ordering of out-of-stock products" (Дозволити замовлення товарів, яких немає в наявності) у розділі Shop Parameters > Product Settings
• Ключ вебслужби повинен мати доступ View (GET) до ресурсів combinations та configurations
• Товари повинні мати заповнене поле available_date у комбінаціях PrestaShop

Ціни з урахуванням податків

Увімкніть перемикач "Apply tax (VAT) to prices" у налаштуваннях дії Product Search, щоб показувати ціни разом із податком. Якщо це налаштування активне, чатбот розраховує ціни з використанням податкових правил вашого магазину PrestaShop на основі країни магазину за замовчуванням. Завдяки цьому ціни, які клієнти бачать у чаті, збігатимуться з цінами на вітрині вашого магазину.

Вимоги:

• Ключ вебслужби повинен мати доступ View (GET) до ресурсів taxes, tax_rules, tax_rule_groups та configurations

Спеціальні ціни (знижки та акції)

Увімкніть перемикач "Apply specific prices (discounts/promotions)" у налаштуваннях дії Product Search, щоб відображати знижені ціни згідно з правилами спеціальних цін PrestaShop. Коли для товару діє знижка, чатбот показує як ціну зі знижкою, так і початкову ціну, щоб клієнти бачили розмір економії.

Це поширюється на універсальні правила спеціальних цін - акції та розпродажі, які діють для всіх клієнтів за мінімальної кількості від 1 одиниці. Також підтримуються акції, обмежені в часі; чатбот застосовує лише ті знижки, які є активними на поточний момент відповідно до дат їхнього початку та завершення.

Вимоги:

• Ключ вебслужби повинен мати доступ View (GET) до ресурсів specific_prices та specific_price_rules

Тестування інтеграції

Після активації дій відкрийте віджет вашого чатбота та спробуйте:

• "Покажи мені бігові кросівки" (тестує пошук товарів)
• "Я шукаю товар ABC-12345" (тестує пошук за артикулом/SKU)
• "Який статус мого замовлення 12345?" (тестує інформацію про замовлення)

Переконайтеся, що відповіді збігаються з даними вашого магазину PrestaShop, посилання на товари відкриваються належним чином, а ціни включають податки та знижки, якщо ці опції увімкнено.

Встановлення чатбота у вашому магазині PrestaShop

Щоб додати віджет чату на вітрину вашого магазину PrestaShop, перегляньте детальний посібник: Installing Chatbot on a PrestaShop Store