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

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

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

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

Важно: Най-добри практики за E-Commerce

След като завършите интеграцията по-долу, прочетете изчерпателното ръководство за оптимизиране на Вашия чатбот за електронна търговия: How to set up ChatLab for your E-commerce store

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

Търсене на продукти - Клиентите могат да търсят във Вашия каталог в Shoper, като въведат фраза. Чатботът търси в имената на продуктите чрез размито съвпадение (fuzzy matching), като връща до 10 съответстващи продукта с:

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

Можете също така да активирате филтъра за наличност, за да се връщат само продукти, които в момента са налични.

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

  • ID на поръчката, дата и текущ статус
  • Обща сума на поръчката и валута
  • Поръчани артикули с техните имена, количества и цени
  • Адрес за доставка (улица, град, пощенски код, държава, телефон)
  • Адрес за фактуриране
  • Бележки към поръчката

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

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

  • Имате абонамент за ChatLab на план STANDARD или PREMIUM
  • Имате достъп до Вашия административен панел в Shoper
  • Вашият чатбот вече е създаден в ChatLab

Стъпка 1: Създаване на група администратори

  1. Във Вашия административен панел в Shoper отидете на Settings > Store administrators (Настройки > Администратори на магазина)

Административен панел на Shoper, показващ страницата Administrators Groups

  1. Кликнете върху MORE (Повече) > Add administrators group (Добавяне на група администратори)

Бутон за добавяне на група на страницата Administrators Groups

  1. Въведете име на групата (напр. "ChatLab Integration"), изберете Access type: 'access to webapi' (Тип достъп: 'достъп до webapi') и запазете

Формуляр за добавяне на група администратори

Стъпка 2: Конфигуриране на правата на групата

  1. Отворете новосъздадената група и отидете в настройките за права за достъп
  2. Предоставете права за Read (Четене) за следните ресурси:
    • Sales (Продажби) - четене
    • Catalog (Каталог) - четене
    • Configuration (Конфигурация) - четене

Конфигурация на правата на групата, показваща необходимите права за четене

Стъпка 3: Добавяне на API администратор

  1. Отидете на Administrators (Администратори) и кликнете върху Add administrator (Добавяне на администратор)

Страница Administrators с бутон Add administrator

  1. Попълнете потребителското име и паролата и назначете администратора към групата, създадена в Стъпка 1

Формуляр за добавяне на администратор с потребителско име, парола и избор на група

  1. Запазете администратора. Запишете си потребителското име и паролата - ще Ви трябват в следващата стъпка.

Стъпка 4: Свързване на Shoper в ChatLab

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

Раздел Connect, показващ плочката за интеграция с Shoper

  1. Кликнете върху Connect (Свързване) на плочката на Shoper
  2. Въведете Вашия Shop URL (Вашият Shoper домейн, напр. myshop.shoper.pl)
  3. Въведете Вашия WebAPI Login (от Стъпка 3)
  4. Въведете Вашата WebAPI Password (от Стъпка 3)

Формуляр за интеграция с Shoper с полета за URL на магазина, потребителско име и парола

  1. Кликнете върху Initialize Configuration (Инициализиране на конфигурацията) - това извлича наличните езици от Вашия магазин
  2. Изберете правилния език в падащото меню Shop Language (Език на магазина) - това определя коя езикова версия на данните за продуктите се връща
  3. Кликнете върху Connect (Свързване)

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

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

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

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

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

  • Shoper - product search - позволява на чатбота да търси във Вашия продуктов каталог
  • Shoper - order details - позволява на чатбота да прави справка за информация относно поръчки

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

За търсене на продукти кликнете върху бутона Edit (Редактиране) и отидете в раздела Product Search Settings (Настройки за търсене на продукти). Налични са две допълнителни опции:

  • Include product attachments (Включване на прикачени файлове към продуктите) - когато е активирано, чатботът включва прикачените файлове към продуктите (PDF файлове, документи) в резултатите от търсенето
  • Products in stock only (Само продукти на склад) - когато е активирано, чатботът връща само продукти, които в момента са налични

Product Search Settings, показващи опциите за прикачени файлове и филтър за наличност

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

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

  • "Покажи ми обувки за бягане" (тества търсенето на продукти)
  • "Какъв е статусът на моята поръчка 12345?" (тества информацията за поръчката)

Проверете дали отговорите съответстват на данните от Вашия магазин в Shoper и дали връзките към продуктите се отварят правилно.