Центр допомоги
Інтеграції чатбота

Інтеграція з фідом товарів (XML, Google Merchant)

Останнє оновлення:

Підключіть будь-який інтернет-магазин до вашого чатбота ChatLab за допомогою товарного фіда. Якщо ваша платформа не має нативної інтеграції з ChatLab, фід - це спосіб надати чатботу ваш каталог: він зчитує товари з фіда, індексує їх за допомогою AI Search і відповідає картками товарів із посиланнями на ваш магазин.

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

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

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

AI-пошук товарів - клієнти описують власні потреби своїми словами, а чатбот знаходить відповідні товари у вашому каталозі. Відповідь містить:

  • назву та опис товару
  • ціну (та акційну ціну, якщо вона є у фіді)
  • зображення товару
  • пряме посилання на сторінку товару у вашому магазині
  • бренд, наявність, GTIN / SKU та інші атрибути з фіда

Категорії - коли фід містить тип товару (наприклад, "Home > Kitchen > Kettles"), чатбот може звузити пошук до певної категорії.

Оновлення за розкладом - каталог оновлюється за встановленим вами графіком, тому нові товари, ціни та наявність потрапляють до чатбота без вашого втручання.

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

Фід - це файл, а не пряме підключення до вашого магазину, тому чатбот не може:

  • перевіряти статус замовлення
  • додавати товари до кошика або оформлювати замовлення
  • отримувати дані про актуальні залишки на складі в реальному часі між оновленнями

Картки товарів завжди ведуть до вашого магазину, де покупець завершує оформлення покупки. Якщо вам потрібне відстеження замовлень або додавання до кошика, скористайтеся нативною інтеграцією.

Вимоги

  • Інтеграція Feed XML, включена до вашого плану
  • Пакет товарів AI Search product pack, призначений чатботу: він визначає, скільки товарів можна проіндексувати
  • Товарний фід у форматі XML Google Merchant (Google Shopping), доступний за загальнодоступною адресою https. Підтримуються стиснені фіди (.gz) та фіди, захищені іменем користувача й паролем.

Крок 1: Отримайте товарний фід із вашого магазину

Більшість платформ експортують фід Google Merchant одразу або через безкоштовне розширення:

  • Magento / Adobe Commerce - розширення фіда Google Shopping (наприклад, із Magento Marketplace) генерує XML за такою адресою, як https://yourstore.com/feeds/google.xml
  • IdoSell - Marketing and integrations, Price comparison sites and marketplaces, Google Merchant: увімкніть фід і скопіюйте його адресу
  • OpenCart - Extensions, Feeds, Google Base: увімкніть його та скопіюйте URL-адресу фіда даних
  • BigCommerce - Channel Manager, Google Shopping, або застосунок для фідів із BigCommerce App Marketplace
  • Shopware - Marketing, Product comparisons, Google Shopping: створіть експорт і скопіюйте його URL-адресу
  • osCommerce та власні платформи - будь-який модуль, що створює фід RSS 2.0 або Atom з атрибутами товарів g:

Фід має містити принаймні ідентифікатор товару (g:id), назву та посилання. Ціна, зображення, опис, наявність і тип товару роблять відповіді значно точнішими.

Крок 2: Підключіть фід у ChatLab

  1. Увійдіть у ChatLab і виберіть свого бота
  2. Перейдіть на вкладку Connect (Підключення)
  3. Натисніть Connect (Підключити) на плитці Feed XML
  4. Вставте Feed URL (URL-адреса фіда)
  5. Якщо фід вимагає авторизації, увімкніть параметр The feed requires a username and password (Фід вимагає ім'я користувача та пароль) і введіть облікові дані
  6. За бажанням установіть Product language (Мова товару - дволітерний код мови, що використовується у фіді)
  7. Натисніть Test feed (Перевірити фід) - ChatLab завантажить початок фіда й покаже формат, кількість знайдених товарів, перші товари в тому вигляді, як вони будуть проіндексовані, а також будь-які попередження (відсутні ціни, посилання, зображення чи категорії)
  8. Натисніть Connect (Підключити)

Після успішного підключення ChatLab починає індексацію каталогу у фоновому режимі. Залежно від розміру фіда це триває від однієї хвилини до кількох десятків хвилин. Ви можете стежити за процесом у розділі Training > E-commerce catalog (Навчання > Каталог e-commerce).

Крок 3: Нестандартні фіди (зіставлення полів)

Якщо ваш фід не відповідає формату Google Merchant, ChatLab все одно може його прочитати:

  1. Спочатку запустіть Test feed (Перевірити фід) - назви елементів, знайдені у вашому файлі, з'являться у списках вибору для зіставлення
  2. Відкрийте Field mapping for non-standard feeds (Зіставлення полів для нестандартних фідів)
  3. Якщо окремий товар не є елементом item або entry, введіть назву в полі Product element (Елемент товару)
  4. Виберіть елемент для кожного поля: Product identifier (Ідентифікатор товару - обов'язково), Product name (Назва товару), Description (Опис), Product page URL (URL сторінки товару), Image URL (URL зображення), Price (Ціна), Category path (Шлях категорії) та інших
  5. Знову запустіть Test feed (Перевірити фід) і перевірте зразки товарів
  6. Натисніть Connect (Підключити)

Поля, залишені зі значенням "Default (Google Merchant)", зберігають стандартні назви, тому фід, який відповідає стандарту, взагалі не потребує налаштування зіставлення.

Крок 4: Розклад оновлення

  1. Перейдіть до Training > E-commerce catalog (Навчання > Каталог e-commerce)
  2. На картці Feed XML натисніть Retrain (Навчити повторно)
  3. Кнопка Retrain now! (Навчити повторно зараз!) негайно оновлює каталог
  4. Щоб налаштувати автоматичне оновлення, виберіть періодичність (щодня, раз на тиждень або раз на місяць), день і час, після чого натисніть Schedule retrain (Запланувати повторне навчання)

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

Крок 5: Налаштуйте дію AI

Після підключення дія Feed XML - AI product search вмикається автоматично для чатботів із продуктом AI Search. Щоб змінити її параметри, перейдіть до Settings > Actions (Налаштування > Дії) та відфільтруйте список за платформою Feed XML. Ви можете змінити назву дії, інструкції для AI, а також увімкнути опцію Include product card (Включити картку товару), щоб чатбот надавав повну картку товару замість короткого опису.

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

Відкрийте віджет вашого чатбота та спробуйте такі запити:

  • "Show me kettles under 50 dollars" (тестує пошук із фільтром за ціною)
  • "Do you have blue cotton t-shirts?" (тестує відповідність за атрибутами)

У відповідях мають відображатися товари з вашого фіда з посиланнями на ваш магазин.

Поради

  • Додавайте тип товару у фід (g:product_type) у вигляді повного шляху, наприклад "Clothing > Men > T-Shirts" - він стає категорією, за якою чатбот може фільтрувати товари
  • Складайте детальні описи у фіді: чатбот використовує їх для пошуку відповідей на запитання клієнтів
  • Варіанти одного товару повинні мати спільний item_group_id - ChatLab показує їх як один товар із вибором усіх кольорів і розмірів
  • Якщо ваш фід має великий розмір, стиснений фід (.gz) завантажується швидше

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

Щоб додати віджет чату на сторінки вашого магазину:

  1. У ChatLab перейдіть на вкладку Deploy (Розгортання) для вашого бота
  2. Скопіюйте фрагмент коду
  3. Вставте його в шаблон вашого магазину перед закриваючим тегом </body> або скористайтеся налаштуваннями "користувацький HTML" чи "скрипти" вашої платформи