Интеграция с Shoper: AI Search, живой поиск по магазину и статус заказа

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

Пример диалога

Этот пример демонстрирует опыт взаимодействия с клиентом. Доступные действия и возвращаемая информация зависят от данной интеграции и ваших настроек.

Важно: рекомендации по 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 или чат-бот - оба будут созданы автоматически во время установки.

1. В панели управления Shoper перейдите в Add-ons and integrations > Applications (Дополнения и интеграции > Приложения), найдите ChatLab - AI Chatbot for Customer Support and Sales и установите его
2. Откройте приложение ChatLab в панели управления Shoper - панель ChatLab откроется в новом окне
3. Задайте пароль (для нового аккаунта) или войдите в свой существующий аккаунт ChatLab
4. Если вы начали настройку через мастер создания чат-бота, подтвердите подключение магазина к этому боту; в противном случае чат-бот для магазина будет создан в вашем аккаунте автоматически
5. Выберите тарифный план или останьтесь на бесплатном тарифе - перейти на другой план можно позже в разделе Account > Subscription (Аккаунт > Подписка)

Вот и все. Магазин подключен, действия для поиска товаров и проверки статуса заказа активны, а чат-бот появится на витрине вашего магазина сразу после завершения подключения. Перейдите к разделу Настройка действий Shoper ниже, чтобы проверить действия, или откройте Deploy > Shoper (Развертывание > Shoper) в ChatLab, чтобы снова просмотреть шаги по установке.

Способ 2: Ручная настройка

Используйте этот способ, если вы не можете установить приложение. Перед началом убедитесь, что:

• Ваша подписка ChatLab включает интеграцию с Shoper
• У вас есть доступ к панели администратора Shoper
• Ваш чат-бот уже создан в ChatLab

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

Шаг 1: Создайте группу администраторов

1. В панели администратора Shoper перейдите в раздел Settings > Store administrators (Настройки > Администраторы магазина)

2. Нажмите MORE (Еще) > Add administrators group (Добавить группу администраторов)

3. Введите название группы (например, «ChatLab Integration»), выберите тип доступа (Access type): «access to webapi» (доступ к webapi) и сохраните

Шаг 2: Настройте права группы

1. Откройте только что созданную группу и перейдите к настройкам прав доступа
2. Предоставьте доступ Read (Чтение) к следующим ресурсам:
   • Sales (Продажи) - чтение
   • Catalog (Каталог) - чтение
   • Configuration (Конфигурация) - чтение

Шаг 3: Добавьте администратора API

1. Перейдите в раздел Administrators (Администраторы) и нажмите Add administrator (Добавить администратора)

2. Заполните логин и пароль и назначьте администратора в группу, созданную на шаге 1

3. Сохраните администратора. Запишите логин и пароль - они понадобятся вам на следующем шаге.

Шаг 4: Подключите Shoper в ChatLab

1. Войдите в ChatLab и выберите вашего бота
2. Перейдите на вкладку Connect (Подключение)

3. Нажмите Connect (Подключить) на карточке Shoper
4. Введите Shop URL (адрес вашего магазина Shoper, например, myshop.shoper.pl)
5. Введите WebAPI Login (из шага 3)
6. Введите WebAPI Password (из шага 3)

7. Нажмите Initialize Configuration (Инициализировать конфигурацию) - это загрузит доступные языки из вашего магазина
8. Выберите нужный Shop Language (Язык магазина) из выпадающего списка (он определяет, какая языковая версия данных о товарах будет использоваться)
9. Нажмите 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.

Тестирование интеграции

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

• «Покажи кроссовки для бега» (проверяет поиск товаров)
• «Какой статус у моего заказа 12345?» (проверяет сведения о заказе; укажите соответствующий адрес электронной почты для заказа, к которому у вас есть доступ)

Убедитесь, что ответы соответствуют данным из вашего магазина Shoper, а ссылки на товары открываются корректно.

Установка чатбота в магазине Shoper

Если вы использовали способ 1 (приложение), виджет чата уже находится на витрине вашего магазина и ничего добавлять не требуется. Если вы использовали способ 2 (ручная настройка), откройте Deploy > Shoper (Развертывание > Shoper) в ChatLab, переключитесь на Manual Installation (Ручная установка), скопируйте код и вставьте его в панели администратора Shoper в разделе Add-ons and integrations > Custom integrations (Дополнения и интеграции > Пользовательские интеграции) в поле Page header (Заголовок страницы). Подробности см. в руководстве Adding chatbot to your website.

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

• AI Search: как ваш чат-бот находит товары
• Планы и лимиты для e-commerce
• Руководство по настройке e-commerce
• Добавление чат-бота на ваш сайт