Подключите ваш чат-бот ChatLab к магазину Shoper, чтобы предоставить клиентам доступ к информации о товарах и отслеживанию заказов в реальном времени прямо в чате.
Важно: лучшие практики для e-commerce
После завершения интеграции ниже ознакомьтесь с подробным руководством по оптимизации вашего чат-бота для электронной коммерции: Как настроить ChatLab для вашего интернет-магазина
Что дает интеграция
Поиск товаров - клиенты могут искать товары по вашему каталогу Shoper, вводя поисковую фразу. Чат-бот выполняет поиск по названиям товаров с использованием нечеткого соответствия и возвращает до 10 подходящих позиций со следующими данными:
- Название и описание товара
- Цена и артикул (SKU)
- Прямая ссылка на страницу товара в вашем магазине
- Изображение товара
- Статус наличия на складе
- Опционально: вложения товара (файлы PDF, документы)
Вы также можете включить фильтр товаров в наличии, чтобы возвращать только те позиции, которые сейчас доступны для покупки.
Детали заказа - клиенты могут проверить статус своего заказа, указав номер заказа и адрес электронной почты, привязанный к заказу. Оба значения сверяются с данными вашего магазина Shoper. Чат-бот возвращает:
- Номер заказа, дату и текущий статус
- Общую сумму заказа и валюту
- Заказанные товары с названиями, количеством и ценами
- Адрес доставки (улица, город, почтовый индекс, страна, телефон)
- Адрес для выставления счета
- Примечания к заказу
Предварительные требования
Перед началом интеграции с Shoper убедитесь, что:
- У вас активна подписка ChatLab уровня STANDARD или PREMIUM
- У вас есть доступ к панели администратора Shoper
- Ваш чат-бот уже создан в ChatLab
Шаг 1: Создайте группу администраторов
- В панели администратора Shoper перейдите в Settings > Store administrators (Настройки > Администраторы магазина)
- Нажмите MORE (Еще) > Add administrators group (Добавить группу администраторов)
- Введите название группы (например, "ChatLab Integration"), выберите тип доступа (Access type): "access to webapi" и сохраните изменения
Шаг 2: Настройте права доступа группы
- Откройте только что созданную группу и перейдите к настройкам прав доступа
- Предоставьте доступ Read (Чтение) к следующим ресурсам:
- Sales (Продажи) - чтение
- Catalog (Каталог) - чтение
- Configuration (Конфигурация) - чтение
Шаг 3: Добавьте администратора API
- Перейдите в раздел Administrators (Администраторы) и нажмите Add administrator (Добавить администратора)
- Заполните логин и пароль, затем назначьте администратора в группу, созданную на шаге 1
- Сохраните данные администратора. Запишите логин и пароль - они понадобятся на следующем шаге.
Шаг 4: Подключите Shoper в ChatLab
- Войдите в ChatLab и выберите своего бота
- Перейдите на вкладку Connect (Подключение)
- Нажмите Connect (Подключить) на карточке Shoper
- Введите Shop URL (URL магазина - ваш домен Shoper, например,
myshop.shoper.pl) - Введите WebAPI Login (логин WebAPI из шага 3)
- Введите WebAPI Password (пароль WebAPI из шага 3)
- Нажмите Initialize Configuration (Инициализировать конфигурацию) - это действие загрузит доступные языки из вашего магазина
- Выберите правильный язык в поле Shop Language (Язык магазина) из выпадающего списка (он определяет, на каком языке будут возвращаться данные о товарах)
- Нажмите Connect (Подключить)
ChatLab автоматически проверит подключение, выполнив тестовый поиск товара. В случае успеха появится подтверждающее сообщение, а действия по поиску товаров и просмотру деталей заказа включатся по умолчанию.
Шаг 5: Настройте действия Shoper
После подключения вы можете активировать и настроить отдельные действия ИИ. Перейдите в раздел Settings > Actions (Настройки > Действия) и отфильтруйте список по платформе Shoper.
Доступны два действия:
- Shoper - product search - позволяет чат-боту искать товары по вашему каталогу
- Shoper - order details - позволяет чат-боту проверять информацию о заказах
Нажмите кнопку активации напротив каждого действия, чтобы включить его. Вы также можете настроить подпись действия (сообщение, отображаемое пользователям во время выполнения действия) и инструкции, определяющие, как именно ИИ применяет каждое действие.
Для поиска товаров нажмите кнопку Edit (Редактировать) и перейдите на вкладку Product Search Settings (Настройки поиска товаров). Доступны две дополнительные опции:
- Include product attachments (Включать вложения товаров) - при включении чат-бот прикрепляет файлы вложений (PDF, документы) к результатам поиска
- Products in stock only (Только товары в наличии) - при включении чат-бот возвращает только те товары, которые в данный момент есть на складе
Тестирование интеграции
После активации действий откройте виджет вашего чат-бота и попробуйте отправить запросы:
- "Покажи мне беговые кроссовки" (проверяет поиск товаров)
- "Какой статус у моего заказа 12345?" (проверяет получение деталей заказа)
Убедитесь, что ответы соответствуют данным из вашего магазина Shoper, а ссылки на товары открываются корректно.