Помощен център
Интеграции на чатбота

Интеграция с PrestaShop: AI Search, търсене в реално време в магазина и статус на поръчка

Последна актуализация:

Свържете своя чатбот ChatLab с магазина си в PrestaShop, за да могат клиентите да намират продукти и да проверяват поръчките си директно в чата. Продуктите се намират чрез AI Search, което търси по смисъл във вашия индексиран каталог на PrestaShop, или чрез търсене в реално време в магазина, което изпраща заявки към API на магазина.

Примерен разговор

Вижте го в разговор

Проверете поръчка

Изисква свързан магазин и активирано действие за поръчки. Наличните полета зависят от интеграцията. Съвпадението на имейл адрес не е доказателство за самоличност.

Пример от ChatLabПримерен разговор

Посетител: Къде е поръчката ми?

Пуснете примера или го прочетете по-долу. Не се използват реални клиентски данни.
1 / 5

Клиентът пита за съществуваща поръчка.

Възпроизвеждането спира на пауза, когато примерът излезе от екрана. Това е симулация, а не чат на живо. Бутоните на уиджета във възпроизвеждането не са интерактивни.
Прочетете целия пример
  1. Клиентът пита за съществуваща поръчка.

    Посетител: Къде е поръчката ми?

  2. Стандартното търсене изисква и двата идентификатора.

    Асистент: Моля, посочете номера на поръчката си и имейл адреса, използван при плащането.

  3. Използвайте измислени данни в този пример.

    Посетител: 41982, anna@example.com

  4. Действието прави справка в свързания магазин.

    Проверка на поръчка 41982...

  5. Предоставяйте само информацията, върната от магазина.

    Асистент: Поръчка 41982 е отбелязана като изпратена. Куриерът е DPD. Моля, проверете страницата за проследяване за актуална информация за доставката.

Примерът илюстрира преживяването на клиентите. Наличните действия и върнатата информация зависят от тази интеграция и Вашата конфигурация.

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

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

Как чатботът намира продукти в PrestaShop: AI Search и търсене в магазина на живо

Има два начина, по които чатботът на ChatLab намира продукти в магазин на PrestaShop. Чатботът използва единия или другия, никога и двата едновременно.

AI Search (препоръчително) - ChatLab поддържа собствен индекс на Вашия каталог в PrestaShop и чатботът търси в него по смисъл.

  • Клиентите питат на свободен език, например "червена рокля под 300". Ценовият диапазон се прилага като стриктен филтър, като се разпознават и точни продуктови кодове (SKU, EAN).
  • Цената, наличността и вариантите се четат на живо от PrestaShop в момента на отговора, така че клиентите виждат актуални данни дори между опресняванията на индекса.
  • Резултатите се показват като продуктови карти в чата, до 5 на отговор.
  • Индексирането започва автоматично при свързване на магазина. Каталогът не изразходва символи за обучение.
  • Необходим план: всеки план от серията E-commerce го включва (Free 100 продукта, Start 2 000, Grow 5 000, Scale 20 000). При план Universal добавете добавката E-commerce integrations ($30 на месец) плюс продуктов пакет за AI Search ($29 на месец, 5 000 продукта), присвоен на чатбота.

Търсене в магазина на живо - чатботът препраща фразата на клиента към търсачката на PrestaShop чрез API на магазина и отговаря с върнатите от магазина резултати.

  • Нищо не се индексира и не е необходимо да се синхронизира. Данните са винаги на живо.
  • Това е търсене по ключови думи: намира точно това, което търсачката на Вашия магазин би открила за тази фраза. То не разбира описания на нужди, синоними или печатни грешки по начина, по който го прави AI Search.
  • Необходим план: план Universal с добавката E-commerce integrations ($30 на месец). Не се изисква продуктов пакет.

Когато функцията AI Search е включена, тя замества търсенето в магазина на живо. Статусът на поръчката работи по един и същи начин и при двата варианта. Трета опция, обучение чрез сканирани страници на магазина, е налична във всеки план и е предназначена за информационно съдържание като доставка и връщане, а не за продукти. За пълно сравнение вижте AI Search: how your chatbot finds products, а за продуктовите лимити вижте E-commerce plans and limits.

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

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

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

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

Подробности за поръчката - По подразбиране клиентите предоставят ID на поръчката и имейл адреса, свързан с нея. И двете се съпоставят със записите в магазина; това не е доказателство за собственост на имейл адреса. Допълнителната настройка Allow order lookup without email verification (Разрешаване на търсене на поръчки без проверка на имейл) позволява търсене само по ID на поръчката. Оставете я изключена, освен ако Вашата среда не разполага с подходящ контрол на достъпа. Чатботът връща:

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

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

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

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

Препоръчително: Свързване с модула

За нова инсталация използвайте насочваната настройка на модула за PrestaShop. Опцията Connect my store (Свързване на магазина ми) Ви позволява да влезете в ChatLab и да изберете Вашия чатбот. Описаните по-долу ръчни стъпки с уеб услуга (webservice) са алтернатива; не създавайте втора връзка, ако модулът вече е свързал магазина.

Стъпка 1: Активиране на Webservice в PrestaShop

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

Административно меню на PrestaShop, показващо Advanced Parameters и опцията Webservice|width=16

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

Раздел Configuration с превключвател Enable PrestaShop's webservice и бутон Save|width=60

Стъпка 2: Създаване на Webservice ключ

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

Страница Webservice с бутон Add new webservice key|width=60

  1. Кликнете върху Generate (Генериране), за да създадете нов ключ
  2. Въведете описание (напр. "ChatLab Integration")
  3. Уверете се, че ключът е Enabled (Активиран)
  4. В раздела с разрешения за ресурси предоставете достъп 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
    • shops
    • stock_availables
    • tags
    • tax_rule_groups
    • tax_rules
    • taxes

Конфигурация на Webservice ключ с бутон Generate, описание и разрешения View GET|width=60

  1. Кликнете върху Save (Запазване)
  2. Копирайте генерирания webservice ключ - ще Ви трябва в следващата стъпка

Стъпка 3: Намерете формата на URL адресите на Вашите продукти

  1. В административния панел (back office) на PrestaShop отидете на Configure > Shop Parameters > Traffic & SEO (Конфигуриране > Параметри на магазина > Трафик и SEO)

Административно меню на PrestaShop, показващо опциите Shop Parameters и Traffic & SEO|width=15

  1. Превъртете надолу до раздела Schema of URLs (Схема на URL адресите)
  2. Копирайте стойността от полето Route to products (Път към продуктите) (напр. {category:/}{id}{-:id_product_attribute}-{rewrite}{-:tags}.html)

Раздел Schema of URLs, показващ полето Route to products

Стъпка 4: Свържете PrestaShop в ChatLab

  1. Влезте в ChatLab и изберете Вашия бот
  2. Отидете в раздела Connect (Свързване)

Раздел Connect с плочката за интеграция с PrestaShop

  1. Кликнете върху Connect на плочката на PrestaShop
  2. Въведете Вашия Webservice key (ключ за уеб услуга от Стъпка 2)
  3. Въведете Вашия Shop url (пълния URL адрес на Вашия магазин, напр. https://www.mystore.com)
  4. Въведете Вашия Product url format (формат на URL адреса на продуктите от Стъпка 3)

Формуляр за интеграция с PrestaShop с полета за webservice key, shop URL, product URL format и език по подразбиране|width=60

  1. Кликнете върху Initialize Configuration - това извлича наличните езици и магазини от Вашия магазин
  2. Изберете правилния Default language (език по подразбиране) и при подкана - съответния Prestashop store (магазин на PrestaShop)
  3. Кликнете върху Connect

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

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

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

Действия за PrestaShop в Settings, показващи търсене на продукти и данни за поръчки

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

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

При първоначалното свързване стандартните действия се активират автоматично. Прегледайте статуса им и деактивирайте тези, които не желаете клиентите да използват. Отворете дадено действие, за да го редактирате, след което използвайте Enable (Активиране) или Update (Обновяване) в диалоговия прозорец. Можете също да персонализирате етикета на действието (съобщението, което се показва на потребителите, докато действието се изпълнява) и инструкциите, които определят как 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 трябва да има права за преглед (GET) до ресурсите combinations и configurations
  • Продуктите трябва да имат зададена available_date за своите комбинации в PrestaShop

Цени с включен данък (ДДС)

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

Изисквания:

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

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

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

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

Изисквания:

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

AI Search за PrestaShop: каталог, преиндексиране и настройки

При план E-commerce или при план Universal, когато към чатбота е назначен продуктов пакет AI Search, AI Search е активен и заменя търсенето в реално време в магазина. Индексирането започва автоматично при свързване на магазина.

  • Проверете каталога - отворете Training > E-commerce catalog (Обучение > Каталог за e-commerce) и прегледайте разделите Products (Продукти) и Categories (Категории). В Shop > Products (Магазин > Продукти) се показват панелът Product catalog (Продуктов каталог) и картата AI Search packs on this chatbot (Пакети AI Search в този чатбот).
  • Планирайте преиндексиране - използвайте Schedule auto-retrain (График за автоматично повторно обучение) в Training > E-commerce catalog. Преиндексирането може да се изпълнява ежедневно и е налично във всеки план E-commerce и с всеки продуктов пакет. Бутоните Train now (Обучи сега) или Retrain (Повторно обучение) го стартират при поискване. Обновяванията са инкрементални: непроменените продукти се пропускат, а премахнатите се изтриват от индекса.
  • Прегледайте действието - в Settings > Actions (Настройки > Действия) отворете Prestashop - AI product search. Опциите му са Include product card (Включи карта на продукта), Products in stock only (Само налични продукти) и Number of products to return (Брой върнати продукти).
  • Показвайте продуктови карти - включете Enable Offer Cards в Settings > Model & Advanced (Настройки > Модел и разширени). Вижте Offer Cards.

Когато каталогът надвишава лимита за продукти, индексирането спира при достигане на лимита и собственикът на чатбота получава имейл. Опциите за действието за търсене в реално време в магазина, описани по-горе, не се прилагат задължително за AI Search.

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

След като активирате действията, отворете Overview (Преглед) и опитайте:

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

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

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

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

Свързани статии