Інтеграція з CS-Cart: AI Search, пошук у магазині наживо та статус замовлення

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

Приклад розмови

Цей приклад ілюструє досвід клієнта. Доступні дії та надана інформація залежать від цієї інтеграції та ваших налаштувань.

Перед початком роботи

Спочатку створіть або виберіть чатбота. Вам потрібні права на керування його інтеграціями та доступ до налаштувань підключення зовнішнього облікового запису. Якщо на картці Connect відображається пропозиція оновити тарифний план або зв'язатися з підтримкою, переконайтеся, що ваша підписка містить цю інтеграцію. Зберігайте облікові дані API в таємниці; ніколи не вставляйте їх у код для вбудовування на сайті.

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

Після завершення наведеної нижче інтеграції прочитайте детальний посібник з оптимізації вашого чатбота для електронної комерції: Як налаштувати ChatLab для вашого інтернет-магазину

Як чат-бот шукає товари в CS-Cart: AI Search та пошук у магазині в реальному часі

Чат-бот ChatLab може шукати товари в магазині CS-Cart двома способами. Чат-бот використовує або один, або інший, але ніколи обидва одночасно.

AI Search (рекомендовано) - ChatLab створює власний індекс вашого каталогу CS-Cart, і чат-бот здійснює пошук за змістом запиту.

• Покупці запитують звичайною мовою, наприклад, "червона сукня до 300". Діапазон цін застосовується як строгий фільтр, а точні коди товарів (SKU, EAN) також зіставляються.
• Ціна, наявність та варіанти зчитуються в реальному часі безпосередньо з CS-Cart у момент відповіді, тому клієнти бачать актуальні дані навіть між оновленнями індексу.
• Результати відображаються у вигляді карток товарів у чаті, до 5 штук на відповідь.
• Індексація запускається автоматично після підключення магазину. Каталог не витрачає символи для навчання (training characters).
• Необхідний тариф: входить до кожного плану лінійки E-commerce (Free 100 товарів, Start 2 000, Grow 5 000, Scale 20 000). На універсальному тарифі додайте доповнення "Інтеграції e-commerce" ($30 на місяць) разом із пакетом товарів AI Search ($29 на місяць за 5 000 товарів), призначеним чат-боту.

Пошук у магазині в реальному часі (Live store search) - чат-бот передає фразу покупця до внутрішнього пошуку CS-Cart через API магазину та відповідає тим, що повертає магазин.

• Нічого не індексується і немає потреби синхронізувати дані. Інформація завжди актуальна.
• Це пошук за ключовими словами: він знаходить те саме, що знайшов би власний пошук вашого магазину за цим запитом. Він не розуміє описів потреб, синонімів або одруків так, як це робить AI Search.
• Необхідний тариф: універсальний план із доповненням "Інтеграції e-commerce" ($30 на місяць). Пакет товарів купувати не потрібно.

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

Що дає інтеграція

Пошук у магазині в реальному часі (пошук товарів за фразою) - чатбот надсилає фразу клієнта до пошуку CS-Cart і повертає відповідні товари з такими даними:

• Назва та опис товару
• Ціна
• SKU (код товару)
• Пряме посилання на товар у вашому магазині
• Зображення товару
• Доступні варіанти (розміри, кольори тощо)

Ви можете налаштувати, за якими полями товару виконується пошук (назва, короткий опис, повний опис, ключові слова) та скільки результатів повертати.

Деталі замовлення (Order Details) - клієнти можуть перевірити статус замовлення, вказавши номер замовлення та свою адресу електронної пошти. Чатбот повертає:

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

Крок 1: Увімкніть доступ до API у CS-Cart

1. Увійдіть до панелі адміністрування CS-Cart
2. Перейдіть до Customers > Administrators

3. Натисніть на обліковий запис адміністратора, який використовуватиметься для підключення через API
4. Перейдіть на вкладку API access
5. Позначте пункт "Yes, allow this user to use the API"
6. Натисніть Save

7. Скопіюйте API key, який з'явиться після збереження - збережіть його в надійному місці
8. Занотуйте email address, прив'язану до цього облікового запису адміністратора

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

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

3. Натисніть Connect (Підключити) на картці CS-Cart
4. Введіть свій API Key (з Кроку 1)
5. Введіть свій Account Email (електронну пошту адміністратора з доступом до API)
6. Введіть свій Shop Url (наприклад, https://yourstore.com)

Ви також можете налаштувати параметри пошуку:

• Searchable fields - виберіть поля товару, за якими чатбот здійснюватиме пошук (назва товару, короткий опис, повний опис, ключові слова)
• Number of search results - скільки товарів повертати на один запит (за замовчуванням: 5)

7. Натисніть Connect

Після успішного підключення ви побачите повідомлення з підтвердженням і можливістю налаштувати дії ШІ.

Крок 3: Налаштуйте дії CS-Cart

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

Стандартні дії включають:

• CsCart - product search - дозволяє чатботу шукати у вашому каталозі товарів
• CsCart - order details - дозволяє чатботу переглядати інформацію про замовлення

Налаштування підключення активує стандартні дії. Перевірте їхній статус і вимкніть ті, які клієнтам не слід використовувати. Відкрийте дію для редагування, потім скористайтеся кнопкою Enable (Увімкнути) або Update (Оновити) у діалоговому вікні. Ви також можете змінити мітку дії (повідомлення, яке бачать користувачі під час виконання дії) та інструкції, що визначають, як ШІ використовує кожну дію.

AI Search для CS-Cart: каталог, повторна індексація та налаштування

У плані E-commerce або в плані Universal, коли до чат-бота призначено пакет продуктів AI Search, функція AI Search увімкнена та замінює пошук по магазину наживо. Індексація запускається автоматично після підключення магазину.

• Перевірте каталог - відкрийте Training > E-commerce catalog (Навчання > Каталог e-commerce) і перегляньте вкладки Products (Товари) та Categories (Категорії). У розділі Shop > Products (Магазин > Товари) відображається панель Product catalog (Каталог товарів) і картка AI Search packs on this chatbot (Пакети AI Search на цьому чат-боті).
• Заплануйте повторну індексацію - скористайтеся опцією Schedule auto-retrain (Запланувати автоперенавчання) у Training > E-commerce catalog. Повторна індексація може відбуватися щодня та доступна в кожному плані E-commerce і з кожним пакетом продуктів. Кнопки Train now (Навчати зараз) або Retrain (Перенавчити) запускають її за запитом. Оновлення є інкрементними: незмінені товари пропускаються, а видалені товари вилучаються з індексу.
• Перегляньте дію - у розділі Settings > Actions (Налаштування > Дії) відкрийте CsCart - AI product search (CsCart - пошук товарів AI). Його параметри: Include product card (Включити картку товару), Products in stock only (Тільки товари в наявності) та Number of products to return (Кількість товарів для повернення).
• Показуйте картки товарів - увімкніть Enable Offer Cards (Увімкнути Offer Cards) у Settings > Model & Advanced (Налаштування > Модель і розширені налаштування). Див. Offer Cards.

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

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

Після активації дій відкрийте Overview (Огляд) і спробуйте:

• "Покажіть мені тренувальні рукавички" (перевіряє пошук товарів)
• "Який статус мого замовлення 12345?" (перевіряє деталі замовлення; вкажіть відповідну електронну пошту замовлення, до якого у вас є доступ)

Переконайтеся, що відповіді відповідають даним із вашого магазину CS-Cart.

Поради щодо налаштування пошуку

• Увімкніть Product name та Short description для найкращого балансу швидкості та точності
• Додайте Keywords, якщо ваші товари мають розширені метадані ключових слів
• Вмикайте Full description лише тоді, коли коротші поля не дають бажаних результатів - це може сповільнити пошук
• Почніть із 5 результатів на запит і відкоригуйте залежно від розміру вашого каталогу

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

Щоб додати віджет чату на вітрину CS-Cart:

1. У ChatLab перейдіть на вкладку Deploy (Розгортання) для вашого бота
2. Виберіть вкладку платформи CS-Cart
3. Скопіюйте фрагмент коду
4. В адмін-панелі CS-Cart перейдіть до Design > Layouts
5. Додайте HTML block у макеті за замовчуванням і вставте фрагмент коду віджета на вкладці Content
6. Збережіть зміни блоку та макета. Перевірте сторінки з окремими макетами (наприклад, оформлення замовлення) та всі мовні версії вітрини

Якщо ви використовуєте HTML-блок із підтримкою Smarty, обгорніть фрагмент коду в {literal} та {/literal}. Дивіться інструкції CS-Cart щодо додавання власного коду. Відкрийте опубліковану вітрину магазину та перевірте роботу віджета на комп'ютерах і мобільних пристроях.

Схожі статті

• AI Search: як ваш чатбот шукає товари
• Тарифні плани та ліміти E-commerce
• Посібник із налаштування E-commerce
• Додавання чатбота на ваш вебсайт