Как настроить ChatLab для вашего интернет-магазина: AI Search, поиск по магазину в реальном времени или сканированные страницы

Чат-бот для интернет-магазина полезен тогда, когда он находит нужный товар, показывает актуальную цену и может подсказать покупателю, где находится его заказ. В этом руководстве описан процесс настройки. Главное решение заключается в том, как именно чат-бот ищет товары, и здесь есть три пути:

• Путь A: AI Search (рекомендуется) - ChatLab хранит собственный индекс вашего каталога, и чат-бот выполняет поиск по смыслу.

• Путь B: живой поиск магазина - чат-бот передает поисковую фразу клиента во внутренний поиск вашего магазина через API магазина. Ничего не индексируется.

• Путь C: обучение на отсканированных страницах магазина (возможно, но не рекомендуется для товаров) - ChatLab сканирует страницы товаров в базу знаний для обучения. Это работает на любом плане и с любым сайтом, но цены и наличие товаров устаревают в промежутках между сканированиями.

Чат-бот использует для товаров либо AI Search, либо живой поиск магазина, но никогда оба одновременно. Когда функция AI Search включена, она заменяет собой живой поиск магазина. Отсканированные страницы могут использоваться параллельно с любым из этих вариантов и отлично подходят для информационной базы: условий доставки, возврата и FAQ.

Перед началом работы

Создайте и обучите чатбота, прежде чем открывать к нему доступ покупателям. Для установки виджета вам также понадобятся права на редактирование и публикацию изменений на сайте. См. руководство Как создать своего первого чатбота.

Что важно в чат-боте для e-commerce

Начните с клиентского опыта, который вы хотите обеспечить. Поиск товаров, действия с корзиной и проверка заказов - это отдельные возможности с разными предварительными требованиями.

Помощь клиенту в поиске товара

См. AI Search о том, как индексируется каталог и работает поиск, а также Offer Cards для наглядного отображения результатов.

Помощь клиенту в добавлении выбранного товара

Для этого требуется поддерживаемая интеграция и настройка витрины магазина, а не просто карточка товара. Ознакомьтесь с разделом Добавление товаров в корзину и протестируйте реальную корзину магазина перед включением функции для клиентов.

Помощь клиенту в отслеживании существующего заказа

Ознакомьтесь с разделом Проверка статуса заказа, чтобы узнать о требованиях к поиску данных, вопросах конфиденциальности и случаях, когда заказ не найден. Сами по себе данные заказа не позволяют оформлять возвраты средств или вносить изменения в заказ.

Три способа поиска товаров в чат-боте: AI Search, живой поиск магазина и сканирование страниц

1. AI Search (рекомендуется)

• ChatLab создает отдельный индекс каталога магазина, независимый от базы знаний для обучения. Он не расходует символы обучения.
• Для каждого товара индексируются: название, описание, категории, ключевые слова и теги, атрибуты (например, цвет, размер, бренд), коды товара (SKU, EAN, штрихкод), цена, URL и изображение.
• Покупатель задает вопрос простыми словами, например «красное платье до 300». Чат-бот ищет по смыслу, а не по точному совпадению фразы. Диапазон цен применяется как строгий фильтр, а точные коды товаров также успешно сопоставляются.
• Цена, остатки на складе и варианты считываются напрямую из магазина в момент ответа, поэтому покупатель видит актуальные данные даже между обновлениями индекса.
• Работает с Shopify, WooCommerce, PrestaShop, Shoper, CS-Cart, Ecwid, товарным фидом XML (в формате Google Merchant) и загруженным файлом товаров XLSX или CSV.

Необходимый тариф: включено во все планы линейки E-commerce (E-commerce Start - 2 000 товаров, Grow - 5 000, Scale - 20 000, в плане FREE - 100 товаров). На тарифах Universal добавьте дополнение интеграций e-commerce ($30 в месяц) для подключения магазина, а также пакет товаров AI Search ($29 в месяц за 5 000 товаров), назначенный чат-боту. Именно этот пакет активирует AI Search для данного чат-бота.

2. Живой поиск магазина

• Чат-бот передает запрос покупателя во внутренний поиск магазина через API и отвечает тем, что возвращает магазин. Ничего не индексируется, не требует синхронизации, а данные всегда актуальны.
• Это поиск по ключевым словам. Он находит то же самое, что выдал бы собственный поиск магазина по этой фразе. Он не понимает описания потребностей, синонимы или опечатки так, как это делает AI Search.

Необходимый тариф: план Universal с дополнением интеграций e-commerce ($30 в месяц). Пакет товаров не требуется. На планах линейки E-commerce функция AI Search включена по умолчанию и заменяет живой поиск магазина.

3. Обучение на отсканированных страницах магазина (возможно, но не рекомендуется для товаров)

• ChatLab сканирует ваш сайт, включая страницы товаров, и сохраняет текст страниц в базе знаний для обучения. Интеграция не требуется.
• Подходит для информационного контента: доставка, возврат, способы оплаты, таблицы размеров, информация о компании и FAQ.
• Плохо подходит для товаров: цены и остатки устаревают между сканированиями, а страницы товаров расходуют символы обучения.

Необходимый тариф: любой тариф, включая FREE. Ограничивается лимитом символов обучения и количеством страниц вашего плана. Рекомендуется для информационных страниц, но не для каталога товаров.

Для работы с товарами чат-бот использует либо AI Search, либо живой поиск магазина, но никогда оба одновременно. Сканирование страниц служит запасным вариантом для товаров, если у магазина нет интеграции, и работает в дополнение к любому из первых двух способов для всех материалов, не являющихся товарами. Если вы не уверены, что выбрать, начните с AI Search. Полное сравнение доступно в руководстве AI Search, живой поиск магазина или сканирование страниц.

Доступные интеграции для e-commerce

Перейдите к своему боту и выберите вкладку Connect (Подключение), чтобы просмотреть все доступные интеграции.

ChatLab поддерживает следующие платформы электронной коммерции:

• Shopify - AI Search или живой поиск по магазину, статус заказа
• WooCommerce - AI Search или живой поиск по магазину, статус заказа
• PrestaShop - AI Search или живой поиск по магазину, статус заказа
• Shoper - AI Search или живой поиск по магазину, статус заказа
• CS-Cart - AI Search или живой поиск по магазину, статус заказа
• Ecwid - AI Search, статус заказа
• Wix - только статус заказа
• BaseLinker - только статус заказа
• Abicart - живой поиск по магазину по фразе, статус заказа
• Товарный фид (XML) - AI Search по фиду Google Merchant, без статуса заказа

Вариант A: настройте AI Search

Используйте этот вариант на плане E-commerce или на плане Universal с дополнением «E-commerce integrations» и пакетом товаров AI Search, назначенным чат-боту.

1. Подключите магазин. Откройте вкладку Connect («Подключение») и подключите свою платформу. Следуйте инструкциям для вашей платформы из списка выше. Если для вашей платформы нет встроенной интеграции, подключите товарный фид XML или загрузите файл товаров XLSX или CSV в разделе Training > E-commerce catalog («Обучение > Каталог e-commerce»).
2. Дождитесь индексации каталога. Индексация начнется автоматически после подключения магазина. Вам не нужно сканировать страницы товаров вручную.
3. Проверьте каталог. Откройте Training > E-commerce catalog («Обучение > Каталог e-commerce») и просмотрите вкладки Products («Товары») и Categories («Категории»). Это то, что чат-бот сможет находить. В разделе Shop > Products («Магазин > Товары») отображается панель Product catalog («Каталог товаров») с пакетами AI Search для этого чат-бота.
4. Настройте автоматическую переиндексацию. В разделе Training > E-commerce catalog («Обучение > Каталог e-commerce») используйте опцию Schedule auto-retrain («Настроить автопереобучение»). Переиндексация может выполняться ежедневно и доступна на каждом плане E-commerce, а также с каждым пакетом товаров. Обновления выполняются инкрементально: неизмененные товары пропускаются, а удаленные товары исключаются из индекса. Кнопки Train now («Обучить сейчас») или Retrain («Переобучить») запускают обновление по требованию.
5. Проверьте действие поиска. В меню Settings > Actions («Настройки > Действия») откройте действие поиска товаров с помощью ИИ для вашей платформы, например Shopify - AI product search. Доступны параметры Include product card («Включать карточку товара»), Products in stock only («Только товары в наличии») и Number of products to return («Количество возвращаемых товаров»).
6. Включите Offer Cards. Включите опцию Enable Offer Cards в меню Settings > Model & Advanced («Настройки > Модель и расширенные настройки»), чтобы результаты отображались в виде карточек товаров, до 5 карточек в одном ответе. См. Offer Cards.

Затем протестируйте работу чат-бота от лица клиента: опишите потребность вместо ввода названия товара, укажите бюджет или запросите товар по его артикулу SKU или коду EAN.

Путь B: Настройка живого поиска по магазину (Live Store Search)

Используйте этот путь, если вам нужен поиск товаров без создания индекса. Для этого требуется тарифный план Universal с дополнением «Интеграции для e-commerce» (E-commerce integrations). Пакет товаров не требуется.

1. Подключите магазин. Откройте вкладку Подключить (Connect) и подключите Shopify, WooCommerce, PrestaShop, Shoper, CS-Cart или Abicart. Следуйте инструкциям для вашей платформы.
2. Проверьте действия. В разделе Настройки > Действия (Settings > Actions) отфильтруйте список по вашей платформе и убедитесь, что действие поиска товаров включено. Здесь нет каталога для индексации и не требуется настраивать расписание.
3. Включите Offer Cards в разделе Настройки > Модель и расширенные настройки (Settings > Model & Advanced), чтобы результаты отображались в виде карточек товаров.
4. Помогите чат-боту формировать точные запросы. Живой поиск по магазину работает по ключевым словам, поэтому формулировка фразы имеет решающее значение. В этом помогут пользовательские инструкции ниже.

Позже вы сможете перейти на AI Search, назначив чат-боту пакет товаров AI Search. В таком случае AI Search заменит собой живой поиск по магазину.

Пользовательские инструкции для живого поиска по магазину

Настройте поведение бота в разделе Настройки > Роль и поведение (Settings > Role & Behavior). Нажмите Включить пользовательские инструкции по роли и поведению (Enable custom role and behavior instructions) и добавьте инструкции для вашей платформы.

Эти примеры предназначены для действий живого поиска по магазину. Если включен AI Search, он заменяет их, поэтому адаптируйте инструкции под действия, которые фактически включены в разделе Настройки > Действия (Settings > Actions), а не пытайтесь принудительно вызывать недоступный инструмент. Используйте язык товаров вашего магазина, а не автоматически английский. Настройки бота сохраняются автоматически; дождитесь подтверждения сохранения перед тестированием.

Подробнее о настройке роли: Настройки «Роль и поведение»

Для WooCommerce

Интеграция с WooCommerce поддерживает инструменты searchProducts, getProductCategories и searchProductBySku:

First, classify the user question into one of:
- PRODUCT-BY-SKU (user provides a SKU, reference number, or product code)
- PRODUCT-SPECIFIC (variant/price/availability/recommendation)
- ASSORTMENT-OVERVIEW (brands we carry, categories, "do you sell X at all", broad offer)

If PRODUCT-BY-SKU:
- Call searchProductBySku with the provided SKU or reference code.
- Return the product details to the user.

If PRODUCT-SPECIFIC:
- Call searchProducts(text) first using a concise query in the shop's product language.
- If results are empty/weak:
  1) Call getProductCategories(normalized noun) to choose best categoryId.
  2) Call searchProductsInCategory with the chosen category ID and search phrase to show a few items as examples.
- Answer using tool results as the source of truth for name, price and availability.

If ASSORTMENT-OVERVIEW:
  1) Call getProductCategories(normalized noun) to find relevant categoryIds.
  2) For up to 3-5 top categories, call searchProductsInCategory with the chosen category ID and search phrase.
  3) Aggregate from tool results; always label the list as non-exhaustive.

Для Shopify

Интеграция с Shopify включает инструмент searchProducts с возможностью отображения только товаров в наличии. Включите переключатель Только товары в наличии (Products in stock only) в действии поиска товаров Shopify, чтобы автоматически отфильтровывать недоступные позиции:

First, classify the user question into one of:
- PRODUCT-SPECIFIC (variant/price/availability/recommendation)
- ASSORTMENT-OVERVIEW (brands we carry, categories, "do you sell X at all", broad offer)

If PRODUCT-SPECIFIC:
- Call searchProducts first using a concise query in the shop's product language.
- If results are empty/weak, try up to 3 reformulations (simplify, synonym, category).
- Answer using tool results as the source of truth for name, price and availability.

If ASSORTMENT-OVERVIEW:
- Call searchProducts to provide a few examples and label them "examples".
- Always be explicit when a list is non-exhaustive (e.g., "Examples include ...").

Для PrestaShop

Интеграция с PrestaShop поддерживает инструменты searchProducts и searchProductByReference. Поиск по артикулу позволяет клиентам находить товары по SKU, штрихкоду EAN-13, коду ISBN или MPN:

First, classify the user question into one of:
- PRODUCT-BY-REFERENCE (user provides a SKU, EAN barcode, ISBN, MPN, or reference code)
- PRODUCT-SPECIFIC (variant/price/availability/recommendation)
- ASSORTMENT-OVERVIEW (brands we carry, categories, "do you sell X at all", broad offer)

If PRODUCT-BY-REFERENCE:
- Call searchProductByReference with the provided reference code.
- Return the product details to the user.

If PRODUCT-SPECIFIC:
- Call searchProducts first using a concise query in the shop's product language.
- If results are empty/weak, try up to 3 reformulations (simplify, synonym, category).
- Answer using tool results as the source of truth for name, price and availability.

If ASSORTMENT-OVERVIEW:
- Call searchProducts to provide a few examples and label them "examples".
- Always be explicit when a list is non-exhaustive (e.g., "Examples include ...").

Для Abicart, CS-Cart и Shoper

Эти интеграции поддерживают живой поиск по магазину, однако названия действий могут отличаться. Используйте активное действие поиска товаров вместо searchProducts в этом примере. Интеграции с Wix и BaseLinker поддерживают только отслеживание статуса заказа, но не поиск товаров:

First, classify the user question into one of:
- PRODUCT-SPECIFIC (variant/price/availability/recommendation)
- ASSORTMENT-OVERVIEW (brands we carry, categories, "do you sell X at all", broad offer)

If PRODUCT-SPECIFIC:
- Call searchProducts first using a concise query in the shop's product language.
- If results are empty/weak, try up to 3 reformulations (simplify, synonym, category).
- Answer using tool results as the source of truth for name, price and availability.

If ASSORTMENT-OVERVIEW:
- Call searchProducts to provide a few examples and label them "examples".
- Always be explicit when a list is non-exhaustive (e.g., "Examples include ...").

Вариант C: обучение на отсканированных страницах магазина

Вы можете пропустить интеграцию и позволить ChatLab изучить ваши товары по страницам вашего магазина. Этот вариант доступен на любом тарифе, включая FREE, в пределах лимита символов обучения и количества страниц по вашему тарифу, и работает с любым сайтом.

Это возможно, но мы не рекомендуем использовать данный способ для товаров:

• Цены и остатки устаревают в промежутках между сканированиями. Чат-бот отвечает тем, что было на странице во время последнего сканирования.
• Страницы товаров расходуют символы обучения, поэтому большой каталог быстро исчерпает лимит.
• Нет онлайн-проверки остатков, добавления в корзину и проверки статуса заказа.

Используйте вариант C для товаров только в том случае, если у вашего магазина нет интеграции и вы не можете предоставить товарный XML-фид или файл с товарами. В этом случае следуйте инструкции Обучение бота на интернет-магазине без интеграции: в ней объясняется, как разделить сканирование на информационное обучение и товарное обучение, а также приводятся готовые селекторы элементов для популярных платформ интернет-магазинов.

Какой бы вариант вы ни выбрали для товаров, сканирование сайта остается правильным источником для информационных материалов: доставка, возврат, способы оплаты, таблицы размеров, о нас и FAQ. См. раздел «Как отсканировать информационные страницы вашего магазина» ниже и руководство Добавление новых источников сайта.

Статус заказа и добавление в корзину

Статус заказа и добавление в корзину - это отдельные действия интеграции с магазином. Они работают одинаково на обоих путях.

• Статус заказа - доступен для каждой нативной интеграции с магазином, включая Wix и BaseLinker. См. Проверка статуса заказа.
• Добавление в корзину - доступно там, где это поддерживается интеграцией и витриной магазина. См. Добавление товаров в корзину.

Товарный XML-фид и загруженный файл с товарами предоставляют чатботу товары для AI Search, но не статус заказа.

Тарифы и лимиты

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

Выбор и тестирование модели ИИ

Используйте модель, которая стабильно ориентируется в вашем ассортименте и четко отвечает на запросы покупателей. Проверьте ее работу на неоднозначных описаниях товаров, точных артикулах, карточках с вариантами и запросах статуса заказов. Прежде чем менять модель, сопоставьте качество ее ответов с расходом кредитов на сообщения.

Сменить модель можно в разделе Settings > Model & Advanced (Настройки > Модель и расширенные настройки).

Как сканировать информационные страницы вашего магазина

Планируйте сканирование сайта частями, а не всего сразу, для лучшего контроля. Сканирование имеет два уровня фильтрации: фильтрация URL (какие страницы попадают в обучение) и фильтрация элементов (какие части каждой страницы становятся контентом). Чек-лист ниже охватывает основные моменты.

1. Определите точный объем сканирования - используйте фильтрацию URL:

   • Включайте только URL информационных страниц (например, доставка, возврат, FAQ, контакты)
   • Исключайте пути товаров и категорий (например, /products/ и /collections/), если товары поступают через AI Search или живой поиск по магазину
   • Исключайте малополезные пути, такие как /tags/ и страницы архивов
   • Для многоязычных магазинов ограничьте сканирование основным языком

2. Исключайте повторяющиеся элементы - используйте фильтр исключения HTML-элементов (HTML Element Exclusion) для шапки (header), подвала (footer) и боковой панели (sidebar)

3. Включайте только релевантный контент - используйте включение по CSS-селекторам (CSS Selector Inclusion), чтобы сосредоточиться на основном содержимом каждой страницы

4. Используйте Sitemap при наличии - помогает находить страницы эффективнее обычного краулинга

Подробное руководство - оба уровня фильтрации в деталях, рекомендуемое разделение на отдельные обучения по информационным страницам и товарам, а также готовые селекторы элементов для WooCommerce, Shopify, PrestaShop, Magento, Shoper, CS-Cart и других платформ - доступно в статье Обучение бота на интернет-магазине без интеграции. Оно предназначено для магазинов, которые не могут использовать интеграцию, XML-фид или файл с товарами.

Узнайте больше об оптимизации сканирования сайта: Как сократить количество символов для обучения при сканировании сайта

Дополнительные функции, которые стоит включить

Offer Cards

Включите эту опцию в разделе Settings > Model & Advanced (Настройки > Модель и расширенные), чтобы чат-бот мог возвращать карточки товаров с названиями, изображениями и ценами. Карточки формируются на основе результатов AI Search или поиска по магазину в реальном времени, до 5 штук на ответ при использовании AI Search.

Добавьте это в свои пользовательские инструкции (custom instructions), чтобы избежать дублирования ссылок:

If knowledge base provides URLs of the source information, provide them as comma separated list in the response as a reference - only after you have answered user's question in the conversation and only if the links are not included in the product list

Подробнее: Offer Cards

Предложенные вопросы (Suggested Questions)

Настройте заранее подсказки для быстрых ответов (доставка, возврат, часы работы) в разделе Settings > Chat Conversation (Настройки > Диалог чата). Включите динамические предложенные вопросы (dynamic suggested follow-ups) для подсказок, генерируемых ИИ.

Подробнее: Динамические предложенные вопросы

Переключение на оператора (Human Hand-off)

Активируйте форму связи с человеком (Contact Human) и укажите адрес электронной почты службы поддержки для эскалации запросов.

Подробнее: Форма связи со службой поддержки

Сводки диалогов и профилей клиентов (Conversation & Client Summaries)

Если эта функция включена, ChatLab автоматически генерирует краткую сводку по каждому диалогу и поддерживает актуальный профиль для возвращающихся клиентов.

Подробнее: Сводки и память чат-бота

Frontend API чата

Вы можете передавать контекст посетителя, такой как идентификатор пользователя или email, через frontend API. Контекст, полученный от браузера, не является подтверждением личности и не дает автоматического доступа к истории заказов. Никогда не размещайте API-ключи магазина или приватные токены безопасности в конфигурации виджета.

Подробнее: Chat API

Настройка языка

ChatLab поддерживает более 90 языков. Подробнее: Настройка языка чат-бота (Chatbot Language Setup)

При использовании поиска по магазину в реальном времени с Shopify, WooCommerce или другими платформами e-commerce учитывайте, на каком языке ваш магазин возвращает товары, поскольку фраза сопоставляется собственным поиском магазина. Добавьте эту инструкцию в настройки роли и поведения (Role & Behavior):

When searching for products use [shop language] product and category names in singular form.

Ежедневный контроль и улучшение

Чтобы ответы ChatLab оставались точными и актуальными:

• Регулярно просматривайте историю разговоров. Корректируйте ответы и дополняйте базу данных там, где бот отвечает неуверенно. Подробнее: История диалогов
• Подключите AI Conversation Insights, чтобы отслеживать тренды и проблемные темы. Подробнее: AI Conversation Insights
• Проверяйте автоматический ежедневный отчет об активности. Подробнее: Ежедневный сводный отчет на email

Оптимизация ответов чатбота

Даже правильно настроенному боту требуется периодическая корректировка. Анализируйте журнал чатов, чтобы выявлять слабые места, неверно понятые запросы или слишком частые шаблонные ответы при отсутствии данных. Дорабатывайте системные инструкции, обновляйте материалы базы знаний и тестируйте новые варианты prompt.

Подробнее: Как улучшить качество ответов чатбота

Похожие статьи

• AI Search: как ваш чат-бот находит товары
• Тарифные планы e-commerce и лимиты
• Добавление чат-бота на ваш сайт
• Обучение бота на интернет-магазине без интеграции
• Интеграция с фидом товаров