Подключите чат-бота ChatLab к магазину Shoper, чтобы клиенты могли находить товары и проверять свои заказы прямо в чате. Поиск товаров осуществляется с помощью функции AI Search, которая ищет по смыслу в проиндексированном каталоге Shoper, или через прямой поиск по магазину, отправляющий запросы к API магазина.
Пример диалога
Проверить заказ
Требуется подключенный магазин и включенное действие для работы с заказами. Доступные поля зависят от интеграции. Совпадение адреса эл. почты не является подтверждением личности.
Посетитель: Где мой заказ?
Запустите пример или прочитайте его ниже. Реальные данные клиентов не используются.Клиен т спрашивает о существующем заказе.
Воспроизведение приостанавливается, когда пример пропадает с экрана. Это симуляция, а не живой чат. Элементы управления виджетом во время воспроизведения неинтерактивны.Прочитать пример полностью
- Клиент спрашивает о существующем заказе.
Посетитель: Где мой заказ?
- По умолчанию для поиска требуются оба идентификатора.
Ассистент: Пожалуйста, укажите номер заказа и адрес эл. почты, использованный при оформлении.
- В этом примере используются вымышленные данные.
Посетитель: 41982, anna@example.com
- Действие отправляет запрос в подключенный магазин.
Проверяю заказ 41982...
- Сообщайте только те данные, которые вернул магазин.
Ассистент: Заказ 41982 отмечен как отправленный. Служба доставки - DPD. Статус доставки можно отслеживать на странице трекинга.
Этот пример демонстрирует опыт взаимодействия с клиентом. Доступные действия и возвращаемая информация зависят от данной интеграции и ваших настроек.
Важно: рекомендации по e-commerce
После завершения настройки интеграции ниже ознакомьтесь с подробным руководством по оптимизации вашего чат-бота для e-commerce: Как настроить ChatLab для вашего интернет-магазина (E-commerce)
Как чат-бот находит товары в Shoper: AI Search и поиск по магазину в реальном времени
Чат-бот ChatLab находит товары в магазине Shoper двумя способами. Бот использует либо один, либо другой, но никогда оба сразу.
AI Search (рекомендуется) - ChatLab создает собственный индекс вашего каталога Shoper, и чат-бот ищет в нем товары по смыслу.
- Покупатели задают вопросы простыми словами, например: «красное платье до 300». Диапазон цен применяется как строгий фильтр, а также точно сопоставляются коды товаров (SKU, EAN).
- Цена, наличие и варианты считываются из Shoper в реальном времени прямо в момент ответа, поэтому клиенты видят актуальные данные даже между обновлениями индекса.
- Результаты отображаются в виде карточек товаров в чате, до 5 в одном ответе.
- Индексация запускается автоматически при подключении магазина. Каталог не расходует символы для обучения.
- Необходимый план: входит во все планы E-commerce (Free 100 товаров, E-commerce Start 2 000, E-commerce Grow 5 000, E-commerce Scale 20 000). На плане Universal требуется надстройка интеграций E-commerce ($30 в месяц) плюс пакет товаров AI Search ($29 в месяц, 5 000 товаров), назначенный чат-боту.
Поиск по магазину в реальном времени - чат-бот передает запрос покупателя во внутренний поиск Shoper через API магазина и отвечает тем, что возвращает магазин.
- Ничего не индексируется и не требует синхронизации. Данные всегда актуальны.
- Это поиск по ключевым словам: он находит то, что нашел бы собственный поиск вашего магазина по этой фразе. Он не понимает описания потребностей, синонимы или опечатки так, как это делает AI Search.
- Необходимый план: план Universal с надстройкой интеграций E-commerce ($30 в месяц). Пакет товаров не требуется.
Когда включен AI Search, он заменяет поиск по магазину в реальном времени. Проверка статуса заказа работает одинаково в обоих случаях. Третий вариант - обучение на просканированных страницах магазина - доступен на любом плане и предназначен для информационной информации, такой как условия доставки и возврата, а не для товаров. Полное сравнение смотрите в разделе AI Search: how your chatbot finds products (AI Search: как чат-бот находит товары), а лимиты на товары - в разделе E-commerce plans and limits (Планы и лимиты E-commerce).
Что дает интеграция
Поиск по магазину в реальном времени (поиск товаров по фразе) - чат-бот отправляет фразу клиента в поиск Shoper. Он ищет по названиям товаров с использованием нечеткого соответствия (fuzzy matching), возвращая до 10 подходящих товаров со следующими данными:
- Название и описание товара
- Цена и артикул (SKU)
- Прямая ссылка на страницу товара в вашем магазине
- Изображение товара
- Статус наличия
- Дополнительно: вложения к товару (PDF-файлы, документы)
Вы также можете включить фильтр товаров в наличии (in-stock filter), чтобы отображать только те товары, которые сейчас доступны.
Детали заказа (Order Details) - клиенты могут проверять статус своего заказа, указав номер заказа и адрес электронной почты, привязанный к заказу. Оба значения сверяются с данными вашего магазина Shoper. Чат-бот возвращает:
- Номер заказа, дату и текущий статус
- Общую сумму заказа и валюту
- Заказанные позиции с названиями, количеством и ценами
- Адрес доставки (улица, город, почтовый индекс, страна, телефон)
- Адрес для выставления счета
- Примечания к заказу
Два способа подключения магазина
Подключить Shoper к ChatLab можно двумя способами:
- Способ 1: приложение ChatLab из Shoper App Store (рекомендуется) - установка в один клик. Приложение настраивает интеграцию, включает поиск товаров и просмотр статуса заказов, а также добавляет виджет чата на витрину вашего магазина. Никакие ключи API копировать не нужно.
- Способ 2: ручная настройка - вы создаете администратора WebAPI в Shoper и вводите его учетные данные в ChatLab. Используйте этот способ только в том случае, если вы не можете установить приложение или хотите подключить магазин к чат-боту с особыми настройками управления.
Выберите один из способов. Не создавайте второе подключение с помощью Способа 2, если магазин уже подключен через приложение.
Способ 1: Установка приложения ChatLab из Shoper App Store
Бесплатное приложение ChatLab в Shoper App Store - самый быстрый способ начать работу. Вам не требуется существующий аккаунт ChatLab или чат-бот - и то, и другое создается автоматически во время установки.
- В панели управления Shoper перейдите в раздел Дополнения и интеграции > Приложения (Add-ons and integrations > Applications), найдите ChatLab - AI Chatbot for Customer Support and Sales и установите его
- Откройте приложение ChatLab в панели управления Shoper - панель ChatLab откроется в новом окне
- Задайте пароль (для нового аккаунта) или войдите в свой существующий аккаунт ChatLab
- Если вы начали с мастера настройки чат-бота, подтвердите подключение магазина к этому чат-боту; в противном случае чат-бот для магазина будет создан в вашем аккаунте автоматически
- Выберите тарифный план или останьтесь на бесплатном плане - вы сможете обновить тариф позже в разделе Аккаунт > Подписка (Account > Subscription)
Вот и все. Магазин подключен, действия поиска товаров и получения данных о заказах включены, а чат-бот появится на витрине вашего магазина сразу после установки соединения. Перейдите к разделу Настройка действий Shoper ниже, чтобы проверить действия, или откройте Тестирование и развертывание > Shoper (Test & Deploy > Shoper) в ChatLab, чтобы снова просмотреть эти шаги установки.
Способ 2: Ручная настройка
Используйте этот способ, если вы не можете установить приложение. Перед началом убедитесь, что:
- Ваша подписка ChatLab включает интеграцию с Shoper
- У вас есть доступ к панели администратора Shoper
- Ваш чат-бот уже создан в ChatLab
Ручная настройка подключает только данные магазина. Виджет чата необходимо добавить на витрину магазина отдельно, см. раздел Установка чат-бота в магазине Shoper в конце этой статьи.
Шаг 1: Создайте группу администраторов
- В панели администратора Shoper перейдите в раздел Settings > Store administrators (Настройки > Администраторы магазина)
- Нажмите MORE (Еще) > Add administrators group (Добавить группу администраторов)
- Введите название группы (например, «ChatLab Integration»), выберите тип доступа (Access type): «access to webapi» (доступ к webapi) и сохраните
Шаг 2: Настройте права группы
- Откройте только что созданную группу и перейдите к настройкам прав доступа
- Предоставьте доступ Read (Чтение) к следующим ресурсам:
- Sales (Продажи) - чтение
- Catalog (Каталог) - чтение
- Configuration (Конфигурация) - чтение
Шаг 3: Добавьте администратора API
- Перейдите в раздел Administrators (Администраторы) и нажмите Add administrator (Добавить администратора)
- Заполните логин и пароль и назначьте администратора в группу, созданную на шаге 1
- Сохраните администратора. Запишите логин и пароль - они понадобятся вам на следующем шаге.
Шаг 4: Подключите Shoper в ChatLab
- Войдите в ChatLab и выберите вашего бота
- Перейдите на вкладку Connect (Подключение)
- Нажмите Connect (Подключить) на карточке Shoper
- Введите Shop URL (адрес вашего магазина Shoper, например,
myshop.shoper.pl) - Введите WebAPI Login (из шага 3)
- Введите WebAPI Password (из шага 3)
- Нажмите Initialize Configuration (Инициализировать конфигурацию) - это загрузит доступные языки из вашего магазина
- Выберите нужный Shop Language (Язык магазина) из выпадающего списка (он определяет, какая языковая версия данных о товарах будет использоваться)
- Нажмите Connect (Подключить)
ChatLab автоматически проверит подключение, выполнив тестовый поиск товаров. В случае успеха вы увидите подтверждающее сообщение, а действия по поиску товаров и получению информации о заказах включатся по умолчанию.
Настройка действий Shoper
После подключения любым из способов вы можете включить и настроить отдельные действия ИИ. Перейдите в раздел Settings > Actions (Настройки > Действия) и отфильтруйте список по платформе Shoper.
Стандартные действия включают:
- Shoper - product search - позволяет чат-боту искать товары в вашем каталоге
- Shoper - order details - позволяет чат-боту находить информацию о заказах
При настройке интеграции стандартные действия включаются автоматически. Проверьте их статус и отключите те, доступ к которым клиентам не нужен. Откройте действие для редактирования и нажмите Enable (Включить) или Update (Обновить) в диалоговом окне. Вы также можете настроить ярлык действия (сообщение, отображаемое пользователям во время выполнения действия) и инструкции, определяющие, как именно ИИ использует каждое действие.
Для поиска товаров нажмите кнопку Edit (Редактировать) и перейдите на вкладку Product Search Settings (Настройки поиска товаров). Доступны две дополнительные опции:
- Include product attachments (Включать вложения товаров) - если включено, чат-бот добавляет файлы вложений товаров (PDF-файлы, документы) в результаты поиска
- Products in stock only (Только товары в наличии) - если включено, чат-бот возвращает только те товары, которые сейчас есть на складе
AI Search для Shoper: каталог, переиндексация и настройки
В тарифе E-commerce или в тарифе Universal, когда к чатботу подключен пакет продуктов AI Search, функция AI Search включена и заменяет поиск по магазину в реальном времени. Индексация запускается автоматически при подключении магазина.
- Проверьте каталог - откройте Обучение > Каталог e-commerce (Training > E-commerce catalog) и просмотрите вкладки Товары (Products) и Категории (Categories). В разделе Магазин > Товары (Shop > Products) отображаются панель Каталог товаров (Product catalog) и карточка Пакеты AI Search на этом чатботе (AI Search packs on this chatbot).
- Настройте расписание переиндексации - используйте Запланировать автопереобучение (Schedule auto-retrain) в разделе Обучение > Каталог e-commerce (Training > E-commerce catalog). Переиндексация может выполняться раз в день; она доступна на всех тарифах E-commerce и с любым пакетом продуктов. Кнопка Обучить сейчас (Train now) или Переобучить (Retrain) запускает процесс по запросу. Обновления происходят инкрементально: неизмененные товары пропускаются, а удаленные товары исключаются из индекса.
- Проверьте действие - в разделе Настройки > Действия (Settings > Actions) откройте Shoper - AI product search. Доступные параметры: Включать карточку товара (Include product card), Только товары в наличии (Products in stock only) и Количество возвращаемых товаров (Number of products to return).
- Показывайте карточки товаров - включите Включить Offer Cards (Enable Offer Cards) в разделе Настройки > Модель и расширенные (Settings > Model & Advanced). См. Offer Cards.
Если каталог превышает лимит по товарам, индексация останавливается на лимите, а владельцу чатбота отправляется e-mail. Параметры описанного выше действия для поиска по магазину в реальном времени не обязательно применяются к AI Search.
Тестирование интеграции
После активации действий откройте Test & Deploy (Тестирование и развертывание) и попробуйте:
- "Show me running shoes" (проверяет поиск товаров)
- "What's the status of my order 12345?" (проверяет детали заказа; укажите соответствующий адрес электронной почты для заказа, к которому у вас есть доступ)
Убедитесь, что ответы соответствуют данным из вашего магазина Shoper, а ссылки на товары открываются корректно.
Установка чат-бота в ваш магазин Shoper
Если вы использовали Способ 1 (приложение), виджет чата уже находится на витрине вашего магазина, и добавлять ничего не нужно. Если вы использовали Способ 2 (ручная настройка), откройте в ChatLab раздел Test & Deploy > Shoper («Тестирование и развертывание > Shoper»), перейдите на вкладку Manual Installation («Ручная установка»), скопируйте код и вставьте его в панели администратора Shoper в разделе Add-ons and integrations > Custom integrations («Дополнения и интеграции > Пользовательские интеграции») в поле Page header («Заголовок страницы»). Подробности см. в статье Добавление чат-бота на ваш сайт.