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

Свържете своя ChatLab чатбот с магазина си в PrestaShop, за да предоставите на клиентите достъп в реално време до информация за продуктите и проследяване на поръчките директно в чата.

Важно: Най-добри практики за електронна търговия (E-Commerce)

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

Какво предоставя интеграцията

Търсене на продукти - Клиентите могат да търсят в каталога ви на PrestaShop, като въведат фраза. Чатботът търси в заглавията и описанията на продуктите, като връща първите 5 съвпадащи продукта с:

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

Търсене на продукти по референтен номер (SKU) - Клиентите могат да търсят продукти, използвайки точни референтни кодове. Чатботът търси сред множество видове идентификатори - референтен номер/SKU, EAN-13 баркод, ISBN и MPN - както за продуктите, така и за техните варианти (комбинации). Това е полезно, когато клиентите разполагат с конкретен продуктов код от каталог, фактура или опаковка.

Детайли за поръчка - Клиентите могат да проверят статуса на поръчката си, като предоставят ID на поръчката и имейл адреса, свързан с нея. И двете стойности се проверяват спрямо записите във вашия магазин PrestaShop. Чатботът връща:

• Референтен номер на поръчката, дата и текущ статус (напр. в процес на обработка, завършена, анулирана)
• Обща сума на поръчката
• Име на получателя, фирма, пълен адрес за доставка (улица, град, пощенски код) и телефонен номер
• Име на куриера и номера за проследяване (поддържат се множество номера за проследяване)
• Поръчани артикули с техните имена, количества и единични цени

Предварителни изисквания

Преди да започнете интеграцията с PrestaShop, уверете се, че:

• Вашият чатбот вече е добавен към магазина ви в PrestaShop - вижте Инсталиране на чатбот в магазин PrestaShop
• Имате достъп до административния панел на PrestaShop (back office)

Стъпка 1: Активирайте уеб услугата (Webservice) в PrestaShop

1. Влезте в административния панел (back office) на PrestaShop
2. Отидете на Configure > Advanced Parameters > Webservice (Конфигуриране > Разширени параметри > Webservice)

3. Превъртете надолу до раздела Configuration (Конфигурация)
4. Задайте Enable PrestaShop's webservice (Активиране на уеб услугата на PrestaShop) на Yes (Да)
5. Кликнете върху Save (Запази)

Стъпка 2: Създайте ключ за уеб услуга (Webservice Key)

1. На същата страница Webservice кликнете върху Add new webservice key (Добавяне на нов ключ за webservice)

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. Копирайте генерирания webservice ключ - ще ви потрябва в следващата стъпка

Стъпка 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 (URL адрес на магазина - пълният адрес на вашия магазин, напр. https://www.mystore.com)
6. Въведете вашия Product url format (Формат на URL на продукт) (от Стъпка 3)

7. Кликнете върху Initialize Configuration (Инициализиране на конфигурацията) - това извлича наличните езици от вашия магазин
8. Изберете правилния Default language (Език по подразбиране) от падащото меню
9. Кликнете върху Connect (Свързване)

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

Стъпка 5: Конфигурирайте действията за PrestaShop

След свързването можете да активирате и персонализирате отделни AI действия. Отидете на Settings > Actions (Настройки > Действия) и филтрирайте по платформата PrestaShop.

Налични са следните действия:

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

Кликнете върху бутона за активиране на всяко действие, за да го включите. Можете също така да персонализирате етикета на действието (съобщението, което се показва на потребителите, докато действието се изпълнява) и инструкциите, които определят как AI използва всяко действие.

Когато действието "Search by reference" е активирано, стандартното търсене на продукти също така автоматично ще преминава към търсене по референтен код, ако не бъдат намерени резултати по име. Това означава, че клиентите могат да въведат SKU или баркод в обичайна заявка за търсене и пак да получат точни резултати.

Показване на продукти с дата за презареждане (Предварителна поръчка)

Когато опцията "Products in stock only" е активирана в настройките на действието Product Search, можете допълнително да активирате "Show products with restock date". Това позволява на чатбота да включва изчерпани продукти, за които в PrestaShop е зададена очаквана дата на презареждане. Вместо да скрива тези продукти напълно, чатботът информира клиента за датата на презареждане и че продуктът е наличен за предварителна поръчка.

Изисквания:

• В PrestaShop трябва да е активирана опцията "Allow ordering of out-of-stock products" (Разрешаване на поръчка на изчерпани продукти) (Shop Parameters > Product Settings)
• Ключът за webservice трябва да има достъп View (GET) до ресурсите combinations и configurations
• Продуктите трябва да имат зададена стойност за available_date на своите комбинации в PrestaShop

Цени с включен данък

Активирайте превключвателя "Apply tax (VAT) to prices" в настройките на действието Product Search, за да показвате цените с включен данък. Когато е активирано, чатботът изчислява цените, като използва данъчните правила от вашия магазин PrestaShop въз основа на държавата по подразбиране на магазина. Това гарантира, че цените, които клиентите виждат в чата, съвпадат с тези на витрината на магазина ви.

Изисквания:

• Ключът за webservice трябва да има достъп View (GET) до ресурсите taxes, tax_rules, tax_rule_groups и configurations

Специфични цени (Отстъпки и промоции)

Активирайте превключвателя "Apply specific prices (discounts/promotions)" в настройките на действието Product Search, за да показвате намалени цени от правилата за специфични цени в PrestaShop. Когато за даден продукт има активна отстъпка, чатботът показва както намалената цена, така и първоначалната цена, така че клиентите да могат да видят спестената сума.

Това обхваща универсалните правила за специфични цени - промоции и разпродажби, които важат за всички клиенти при минимално количество от 1 брой. Поддържат се и промоции с ограничен срок; чатботът прилага само отстъпки, които са активни в момента въз основа на техните начални и крайни дати.

Изисквания:

• Ключът за webservice трябва да има достъп View (GET) до ресурсите specific_prices и specific_price_rules

Тестване на вашата интеграция

След като активирате действията, отворете уиджета на вашия чатбот и опитайте:

• "Покажи ми обувки за бягане" (тества търсенето на продукти)
• "Търся продукт ABC-12345" (тества търсенето по референтен номер/SKU)
• "Какъв е статусът на моята поръчка 12345?" (тества детайлите за поръчка)

Уверете се, че отговорите съответстват на данните от вашия магазин PrestaShop, че връзките към продуктите се отварят правилно и че цените включват данък и отстъпки, когато тези опции са активирани.

Инсталиране на чатбот във вашия магазин PrestaShop

За да добавите уиджета за чат към витрината на вашия PrestaShop магазин, вижте подробното ръководство: Инсталиране на чатбот в магазин PrestaShop