Центр помощи
Интеграции чат-бота

Интеграция с WooCommerce

Последнее обновление:

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

Важно: рекомендации для сферы e-commerce

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

Что дает интеграция

Product Search (Поиск товаров) - клиенты могут искать товары в каталоге WooCommerce с помощью текстовых запросов. Чат-бот выполняет поиск по названиям и описаниям товаров, возвращая до 5 наиболее подходящих опубликованных позиций со следующими данными:

  • ID, название и описание товара
  • Цена и артикул (SKU)
  • Изображение товара и прямая ссылка на страницу товара

Product Search by SKU (Поиск товаров по артикулу) - клиенты могут находить товары по конкретному артикулу (SKU), номеру модели или коду товара. Это удобно, если покупателю уже известен точный идентификатор - например, из печатного каталога, предыдущего заказа или рекомендации. Возвращает те же поля товара, что и стандартный поиск.

Product Search in Category (Поиск товаров в категории) - более точный поиск, объединяющий ключевое слово с определенной категорией товаров. Чат-бот сначала определяет нужную категорию, а затем ищет подходящие товары внутри нее. Возвращает те же поля товара, что и стандартный поиск.

Get Categories (Получение категорий) - чат-бот может загружать список категорий товаров магазина, помогая покупателям ориентироваться в каталоге или сужать область поиска. Каждая категория включает:

  • ID, название и ярлык (slug) категории
  • Описание категории

Order Details (Сведения о заказе) - клиенты могут проверить статус заказа, указав его номер и адрес электронной почты. Оба значения сверяются с базой данных магазина WooCommerce. Чат-бот возвращает:

  • Номер заказа, общую сумму и статус (например, в обработке, выполнен, отменен)
  • Адрес доставки: имя и фамилию получателя, компанию, полный адрес (улицу, город, регион, почтовый индекс, страну)
  • Заказанные позиции с названиями, количеством, ценами за единицу и промежуточными суммами

Предварительные требования

Перед началом интеграции с WooCommerce убедитесь, что:

Шаг 1: генерация ключей API в WooCommerce

  1. Войдите в панель администратора WordPress
  2. Перейдите в WooCommerce > Settings (Настройки)
  3. Откройте вкладку Advanced (Дополнительно)
  4. Выберите раздел REST API
  5. Нажмите Add Key (Создать ключ)
  6. Введите описание (например, "ChatLab Integration")
  7. Выберите пользователя, к которому будет привязан ключ - это должен быть пользователь с ролью Administrator (Администратор) или Shop Manager (Управляющий магазином), так как другие роли (например, Клиент или Подписчик) не имеют необходимых прав для доступа к данным WooCommerce
  8. Установите права (Permissions) на значение Read (Чтение)
  9. Нажмите Generate API Key (Создать ключ API)
  10. Скопируйте значения Consumer Key и Consumer Secret - сохраните их в надежном месте, так как Consumer Secret нельзя будет просмотреть повторно

Шаг 2: подключение WooCommerce в ChatLab

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

Вкладка Connect с карточкой интеграции WooCommerce

  1. Нажмите Connect (Подключить) на карточке WooCommerce
  2. Введите URL of WooCommerce store (полный URL-адрес магазина, например https://www.mystore.com)
  3. Введите Customer Key (значение Consumer Key из шага 1)
  4. Введите Customer Secret (значение Consumer Secret из шага 1)

Форма интеграции WooCommerce с полями URL магазина, ключа и секрета

  1. Нажмите Connect

ChatLab автоматически проверит подключение и наличие необходимых прав у предоставленных учетных данных API. В случае успеха появится подтверждающее сообщение.

Параметры подключения

Форма подключения WooCommerce содержит дополнительные настройки:

  • Use order search instead of retrieve - включите эту опцию, если в вашем магазине используются плагины для нестандартной нумерации заказов. Она переключает режим получения данных на поиск, совместимый с измененными номерами заказов.
  • Use product short description - при включении результаты поиска товаров будут содержать краткое описание WooCommerce вместо полного. Полезно для магазинов с очень длинными описаниями товаров.
  • Include in-stock products only - при включении в результаты поиска попадают только товары, которые сейчас есть в наличии.

Шаг 3: настройка действий WooCommerce

После подключения можно активировать и настроить отдельные действия ИИ. Перейдите в раздел Settings > Actions (Настройки > Действия) и отфильтруйте список по платформе WooCommerce.

Действия WooCommerce в разделе Settings со списком всех доступных действий

Доступно пять действий:

  • WooCommerce - Product Search - позволяет чат-боту искать товары в каталоге по ключевым словам
  • WooCommerce - Product Search by SKU - позволяет находить товары по артикулу (SKU), номеру модели или коду товара
  • WooCommerce - Product Search in Category - позволяет выполнять поиск внутри конкретной категории товаров
  • WooCommerce - Get Categories - позволяет чат-боту выводить список категорий магазина
  • WooCommerce - Get Order - позволяет боту запрашивать данные о заказе по номеру и адресу электронной почты

Нажмите кнопку активации напротив каждого нужного действия. Вы также можете настроить отображаемый текст действия (сообщение, которое видит пользователь во время его выполнения) и инструкции, определяющие логику использования действия моделью.

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

После активации действий откройте виджет чат-бота и проверьте запросы:

  • "Покажи беговые кроссовки" (проверка поиска товаров)
  • "Я ищу товар с артикулом WH-1234" (проверка поиска по SKU)
  • "Какие категории у вас есть?" (проверка получения категорий)
  • "Покажи обувь в категории Спортивная одежда" (проверка поиска в категории)
  • "Какой статус у моего заказа #1001?" (проверка сведений о заказе)

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

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

Инструкции по добавлению виджета чата на сайт WordPress/WooCommerce приведены в руководстве: Установка чат-бота в магазине WooCommerce

Демонстрация работы

Пример работающей интеграции с WooCommerce можно посмотреть здесь: https://yourwear.chatlab.com/shop