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

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

Важно: рекомендации для электронной коммерции

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

Возможности интеграции

Поиск товаров - клиенты могут искать товары в каталоге PrestaShop по ключевым фразам. Чат-бот выполняет поиск по названиям и описаниям товаров и возвращает до 5 наиболее подходящих позиций:

• ID товара, название и описание
• Цена (при необходимости с учетом налогов и скидок)
• Прямая ссылка на страницу товара в вашем магазине
• Изображение товара

Поиск товаров по артикулу (SKU) - клиенты могут находить товары по точным кодам. Чат-бот ищет по нескольким типам идентификаторов: артикул/SKU, штрихкод EAN-13, ISBN и MPN - как среди основных товаров, так и среди их вариантов (комбинаций). Это удобно, если у клиента есть конкретный код из каталога, накладной или с упаковки.

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

• Номер заказа, дату оформления и текущий статус (например, в обработке, выполнен, отменен)
• Общую сумму заказа
• Имя получателя, название компании, полный адрес доставки (улица, город, почтовый индекс) и номер телефона
• Название службы доставки и трек-номера (поддерживается несколько трек-номеров)
• Список заказанных позиций с названиями, количеством и ценами за единицу

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

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

• Ваш чат-бот уже добавлен в магазин PrestaShop - см. Установка чат-бота в магазине PrestaShop
• У вас есть доступ к панели администратора PrestaShop (бэк-офису)

Шаг 1. Включите веб-службу (Webservice) в PrestaShop

1. Войдите в панель управления PrestaShop
2. Перейдите в раздел Configure > Advanced Parameters > Webservice (Настроить > Расширенные параметры > Веб-служба)

3. Прокрутите страницу вниз до блока Configuration (Конфигурация)
4. Установите параметр Enable PrestaShop's webservice (Включить веб-службу PrestaShop) в положение Yes (Да)
5. Нажмите Save (Сохранить)

Шаг 2. Создайте ключ веб-службы

1. На той же странице Webservice нажмите Add new webservice key (Добавить новый ключ веб-службы)

2. Нажмите Generate (Сгенерировать), чтобы создать новый ключ
3. Введите описание (например, «ChatLab Integration»)
4. Убедитесь, что для ключа установлен статус Enabled (Включен)
5. В списке прав доступа к ресурсам предоставьте разрешения View (GET) (Просмотр) для следующих ресурсов:
   • addresses
   • attachments
   • carriers
   • categories
   • combinations
   • configurations
   • customers
   • languages
   • order_carriers
   • order_details
   • order_states
   • orders
   • product_customization_fields
   • product_feature_values
   • product_features
   • product_option_values
   • product_options
   • products
   • search
   • specific_price_rules
   • specific_prices
   • states
   • states
   • stock_availables
   • tags
   • tax_rule_groups
   • tax_rules
   • taxes

6. Нажмите Save
7. Скопируйте сгенерированный ключ веб-службы - он понадобится на следующем шаге

Шаг 3. Узнайте формат URL товаров

1. В бэк-офисе PrestaShop перейдите в Configure > Shop Parameters > Traffic & SEO (Настроить > Параметры магазина > Трафик и SEO)

2. Прокрутите вниз до блока Schema of URLs (Схема URL)
3. Скопируйте значение из поля Route to products (Шаблон маршрута к товарам), например: {category:/}{id}{-:id_product_attribute}-{rewrite}{-:tags}.html

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

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

3. Нажмите Connect на карточке PrestaShop
4. Введите Webservice key (ключ веб-службы из шага 2)
5. Введите Shop url (полный адрес вашего магазина, например, https://www.mystore.com)
6. Введите Product url format (формат URL товаров из шага 3)

7. Нажмите Initialize Configuration (Инициализировать конфигурацию) - система загрузит доступные языки из вашего магазина
8. Выберите нужный Default language (язык по умолчанию) из выпадающего списка
9. Нажмите Connect

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

Шаг 5. Настройте действия PrestaShop

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

Доступны следующие действия:

• Prestashop - product search - позволяет чат-боту искать товары в каталоге по названию
• Prestashop - search by reference - позволяет находить товары по кодам артикула/SKU, EAN-13, ISBN или MPN
• Prestashop - order details - позволяет чат-боту проверять информацию о заказах
• Prestashop - get product variants - позволяет получать подробную информацию о вариантах товара (размеры, цвета)

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

Если действие «Search by reference» включено, обычный поиск товаров автоматически переключается на поиск по коду, если по названию ничего не найдено. Благодаря этому покупатели могут ввести SKU или штрихкод в стандартное поле поиска и получить точный результат.

Отображение товаров с датой поступления (предзаказ)

Если в параметрах действия «Product Search» включена опция «Products in stock only», вы можете дополнительно активировать «Show products with restock date». Это позволяет чат-боту выводить отсутствующие на складе товары, для которых в PrestaShop указана ожидаемая дата поставки. Вместо того чтобы полностью скрывать такие товары, чат-бот сообщит клиенту дату поступления и возможность оформить предзаказ.

Требования:

• В PrestaShop должна быть включена опция «Разрешить заказ товаров, которых нет в наличии» (Параметры магазина > Настройки товаров)
• Ключ веб-службы должен иметь права View (GET) к ресурсам combinations и configurations
• Для комбинаций товаров в PrestaShop должна быть задана дата доступности (available_date)

Цены с учетом налогов

Включите переключатель «Apply tax (VAT) to prices» в параметрах действия «Product Search», чтобы показывать цены с учетом налогов. В этом случае чат-бот рассчитывает стоимость по налоговым правилам магазина для страны по умолчанию. Это гарантирует, что цены в чате будут совпадать со стоимостью на витрине.

Требования:

• Ключ веб-службы должен иметь права View (GET) к ресурсам taxes, tax_rules, tax_rule_groups и configurations

Специальные цены (скидки и акции)

Включите переключатель «Apply specific prices (discounts/promotions)» в параметрах действия «Product Search», чтобы отображать сниженные цены по правилам специальных цен PrestaShop. Когда для товара действует скидка, чат-бот показывает как новую цену, так и исходную, чтобы покупатель видел выгоду.

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

Требования:

• Ключ веб-службы должен иметь права View (GET) к ресурсам specific_prices и specific_price_rules

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

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

• «Покажи беговые кроссовки» (проверка поиска товаров)
• «Я ищу товар ABC-12345» (проверка поиска по артикулу/SKU)
• «Какой статус у моего заказа 12345?» (проверка информации о заказе)

Убедитесь, что ответы соответствуют данным в вашем магазине PrestaShop, ссылки на товары открываются корректно, а цены отображаются с учетом налогов и действующих скидок (если эти параметры были включены).

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

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