Integrace se Shoperem: AI Search, vyhledávání v obchodě v reálném čase a stav objednávky

Propojte svého chatbota ChatLab s obchodem Shoper, aby zákazníci mohli vyhledávat produkty a kontrolovat své objednávky přímo v chatu. Produkty se vyhledávají pomocí AI Search, který prohledává váš indexovaný katalog Shoper podle významu, nebo prostřednictvím živého vyhledávání v obchodě, které se dotazuje přímo do API obchodu.

Příklad konverzace

Příklad ukazuje zkušenost zákazníka. Dostupné akce a vrácené informace závisí na této integraci a vaší konfiguraci.

Důležité: Osvědčené postupy pro e-commerce

Po dokončení níže uvedené integrace si přečtěte komplexního průvodce optimalizací chatbota pro e-commerce: Jak nastavit ChatLab pro váš e-commerce obchod

Jak chatbot vyhledává produkty na Shoperu: AI Search a živé vyhledávání v obchodě

Existují dva způsoby, jak chatbot ChatLab vyhledává produkty v obchodě na platformě Shoper. Chatbot používá buď jeden, nebo druhý, nikdy oba současně.

AI Search (doporučeno) - ChatLab udržuje vlastní index vašeho katalogu na Shoperu a chatbot v něm vyhledává podle významu.

• Zákazníci se ptají běžným jazykem, například „červené šaty do 300“. Cenové rozpětí se použije jako striktní filtr a přesně se shodují i produktové kódy (SKU, EAN).
• Cena, skladová dostupnost a varianty se načítají živě ze Shoperu v okamžiku odpovědi, takže zákazníci vidí aktuální údaje i mezi jednotlivými obnoveními indexu.
• Výsledky se v chatu zobrazují jako produktové karty, maximálně 5 na jednu odpověď.
• Indexování začíná automaticky po propojení obchodu. Katalog nespotřebovává trénovací znaky.
• Potřebný tarif: zahrnuje jej každý plán E-commerce (Free 100 produktů, Start 2 000, Grow 5 000, Scale 20 000). U plánu Universal je potřeba přidat doplněk E-commerce integrace (30 $ měsíčně) a balíček produktů AI Search (29 $ měsíčně, 5 000 produktů) přiřazený k chatbotovi.

Živé vyhledávání v obchodě (live store search) - chatbot předá dotaz zákazníka vyhledávání v Shoperu přes API obchodu a odpoví tím, co obchod vrátí.

• Nic se neindexuje a nic není třeba synchronizovat. Data jsou vždy živá.
• Jde o vyhledávání podle klíčových slov: najde přesně to, co by pro danou frázi našlo interní vyhledávání vašeho obchodu. Nerozumí popisu potřeb, synonymům ani překlepům tak jako AI Search.
• Potřebný tarif: plán Universal s doplňkem E-commerce integrace (30 $ měsíčně). Není potřeba žádný produktový balíček.

Když je zapnuté vyhledávání AI Search, nahrazuje živé vyhledávání v obchodě. Zjišťování stavu objednávky funguje u obou variant stejně. Třetí možnost, trénování na naskenovaných stránkách obchodu, je k dispozici v jakémkoli plánu a je určena pro informační obsah, jako je doprava a vrácení zboží, nikoli pro samotné produkty. Kompletní srovnání najdete v článku AI Search: jak váš chatbot vyhledává produkty a limity produktů v článku Plány a limity E-commerce.

Co integrace nabízí

Vyhledávání v obchodě v reálném čase (vyhledávání produktů podle fráze) - Chatbot odešle frázi zákazníka do vyhledávání Shoper. Vyhledává v názvech produktů pomocí přibližné shody (fuzzy matching) a vrátí až 10 odpovídajících produktů s následujícími údaji:

• Název a popis produktu
• Cena a SKU
• Přímý odkaz na stránku produktu ve vašem obchodě
• Obrázek produktu
• Stav skladu
• Volitelně: přílohy produktu (PDF, dokumenty)

Můžete také zapnout filtr skladové dostupnosti, aby se vracely pouze produkty, které jsou aktuálně dostupné.

Podrobnosti objednávky - Zákazníci si mohou zkontrolovat stav objednávky zadáním ID objednávky a e-mailové adresy spojené s objednávkou. Obě hodnoty se ověřují vůči záznamům ve vašem obchodě Shoper. Chatbot vrátí:

• ID objednávky, datum a aktuální stav
• Celkovou částku objednávky a měnu
• Objednané položky s názvy, počtem kusů a cenami
• Doručovací adresu (ulice, město, PSČ, země, telefon)
• Fakturační adresu
• Poznámky k objednávce

Dva způsoby propojení vašeho obchodu

Existují dva způsoby, jak propojit Shoper s ChatLab:

• Metoda 1: Aplikace ChatLab ze Shoper App Store (doporučeno) - instalace jedním kliknutím. Aplikace vytvoří propojení, aktivuje vyhledávání produktů i podrobnosti o objednávkách a přidá chat widget do vašeho e-shopu. Není třeba kopírovat žádné API klíče.
• Metoda 2: Ruční nastavení - v Shoperu vytvoříte administrátora WebAPI a zadáte jeho přihlašovací údaje do ChatLab. Tuto možnost využijte pouze v případě, že nemůžete nainstalovat aplikaci nebo chcete obchod propojit s chatbotem, kterého spravujete specifickým způsobem.

Vyberte si jednu metodu. Nevytvářejte druhé propojení pomocí Metody 2, pokud aplikace již obchod propojila.

Metoda 1: Instalace aplikace ChatLab ze Shoper App Store

Bezplatná aplikace ChatLab v Shoper App Store představuje nejrychlejší způsob, jak začít. Nepotřebujete existující účet ChatLab ani chatbot - obojí se vytvoří automaticky během instalace.

1. V administraci Shoper přejděte do Doplňky a integrace > Aplikace (Add-ons and integrations > Applications), najděte ChatLab - AI Chatbot for Customer Support and Sales a aplikaci nainstalujte
2. Otevřete aplikaci ChatLab v administraci Shoper - panel ChatLab se otevře v novém okně
3. Nastavte si heslo (nový účet) nebo se přihlaste ke svému existujícímu účtu ChatLab
4. Pokud jste začali v průvodci nastavením chatbota, potvrďte propojení obchodu s tímto chatbotem; v opačném případě se na vašem účtu vytvoří nový chatbot pro daný obchod
5. Vyberte si tarif nebo zůstaňte u bezplatného tarifu - přejít na vyšší tarif můžete kdykoli později v sekci Účet > Předplatné (Account > Subscription)

To je vše. Obchod je propojen, akce pro vyhledávání produktů a zjišťování stavu objednávek jsou aktivní a chatbot se na vašem webu zobrazí ihned po dokončení propojení. Pokračujte níže částí Nastavení akcí pro Shoper pro kontrolu akcí, nebo otevřete Deploy > Shoper v ChatLabu, kde najdete stejný postup instalace.

Metoda 2: Ruční nastavení

Tuto metodu použijte, pokud nemůžete nainstalovat aplikaci. Než začnete, ujistěte se, že:

• Vaše předplatné ChatLab zahrnuje integraci se Shoperem
• Máte přístup do administrace svého obchodu Shoper
• Váš chatbot je již v ChatLabu vytvořen

Ruční nastavení propojí pouze data obchodu. Chatovací widget je potřeba přidat do vašeho obchodu zvlášť, viz Instalace chatbota do obchodu Shoper na konci tohoto článku.

Krok 1: Vytvoření skupiny administrátorů

1. V administraci obchodu Shoper přejděte do Settings > Store administrators (Nastavení > Administrátoři obchodu)

2. Klikněte na MORE (Další) > Add administrators group (Přidat skupinu administrátorů)

3. Zadejte název skupiny (např. „ChatLab Integration“), vyberte typ přístupu (Access type): 'access to webapi' a uložte

Krok 2: Nastavení oprávnění skupiny

1. Otevřete nově vytvořenou skupinu a přejděte do nastavení oprávnění
2. Udělte přístup Read (Čtení) k následujícím zdrojům:
   • Sales (Prodej) - čtení
   • Catalog (Katalog) - čtení
   • Configuration (Konfigurace) - čtení

Krok 3: Přidání administrátora API

1. Přejděte do sekce Administrators (Administrátoři) a klikněte na Add administrator (Přidat administrátora)

2. Vyplňte přihlašovací jméno a heslo a přiřaďte administrátora ke skupině vytvořené v Kroku 1

3. Uložte administrátora. Poznamenejte si přihlašovací jméno a heslo - budete je potřebovat v dalším kroku.

Krok 4: Propojení Shoperu v ChatLabu

1. Přihlaste se do ChatLabu a vyberte svého bota
2. Přejděte na záložku Connect (Propojení)

3. Klikněte na Connect na dlaždici Shoper
4. Zadejte své Shop URL (vaše doména Shoperu, např. myshop.shoper.pl)
5. Zadejte svůj WebAPI Login (z Kroku 3)
6. Zadejte své WebAPI Password (z Kroku 3)

7. Klikněte na Initialize Configuration - tím se z vašeho obchodu načtou dostupné jazyky
8. Z rozbalovací nabídky vyberte správný jazyk obchodu (Shop Language) (tím určíte, jaká jazyková verze produktových dat se bude načítat)
9. Klikněte na Connect

ChatLab automaticky otestuje připojení provedením zkušebního vyhledávání produktů. Pokud proběhne úspěšně, zobrazí se potvrzovací zpráva a akce pro vyhledávání produktů i podrobnosti objednávek budou ve výchozím stavu povoleny.

Konfigurace akcí pro Shoper

Po propojení libovolnou metodou můžete aktivovat a přizpůsobit jednotlivé akce AI. Přejděte do Settings > Actions (Nastavení > Akce) a vyfiltrujte platformu Shoper.

Mezi standardní akce patří:

• Shoper - product search - umožňuje chatbotu prohledávat váš produktový katalog
• Shoper - order details - umožňuje chatbotu vyhledávat informace o objednávkách

Nastavení propojení tyto standardní akce automaticky aktivuje. Zkontrolujte jejich stav a vypněte ty, které zákazníci nemají používat. Kliknutím na akci otevřete její úpravy a v dialogovém okně použijte možnost Enable (Aktivovat) nebo Update (Aktualizovat). Můžete také upravit popisek akce (zprávu zobrazenou uživatelům během provádění akce) a instrukce, které určují, jak má AI danou akci používat.

U vyhledávání produktů klikněte na tlačítko Edit (Upravit) a přejděte na záložku Product Search Settings (Nastavení vyhledávání produktů). K dispozici jsou dvě doplňující možnosti:

• Include product attachments (Zahrnout přílohy produktů) - po zapnutí chatbot zahrne do výsledků vyhledávání i soubory příloh k produktům (PDF, dokumenty)
• Products in stock only (Pouze produkty skladem) - po zapnutí chatbot vrací pouze produkty, které jsou aktuálně skladem

AI Search pro Shoper: katalog, přeindexování a nastavení

V tarifu E-commerce nebo v tarifu Universal, pokud je k chatbotovi přiřazen produktový balíček AI Search, je AI Search aktivní a nahrazuje vyhledávání v obchodě v reálném čase. Indexování se spustí automaticky po propojení obchodu.

• Zkontrolujte katalog - otevřete Training > E-commerce catalog (Trénování > Katalog e-commerce) a projděte záložky Products (Produkty) a Categories (Kategorie). V sekci Shop > Products (Obchod > Produkty) se zobrazuje panel Product catalog (Katalog produktů) a karta AI Search packs on this chatbot (Balíčky AI Search na tomto chatbotovi).
• Naplánujte přeindexování - použijte možnost Schedule auto-retrain (Naplánovat automatické přetrénování) v sekci Training > E-commerce catalog. Přeindexování může probíhat i denně a je k dispozici v každém tarifu E-commerce i s každým produktovým balíčkem. Možnost Train now (Trénovat nyní) nebo Retrain (Přetrénovat) jej spustí na vyžádání. Aktualizace jsou inkrementální: nezměněné produkty se přeskočí a odstraněné produkty se z indexu smažou.
• Zkontrolujte akci - v nabídce Settings > Actions (Nastavení > Akce) otevřete Shoper - AI product search. Mezi její volby patří Include product card (Zahrnout produktovou kartu), Products in stock only (Pouze produkty skladem) a Number of products to return (Počet vrácených produktů).
• Zobrazujte produktové karty - v nabídce Settings > Model & Advanced (Nastavení > Model a pokročilé) zapněte Enable Offer Cards. Podívejte se na Offer Cards.

Pokud je katalog větší než limit produktů, indexování se na tomto limitu zastaví a majitel chatbota obdrží e-mail. Volby výše popsané akce vyhledávání v obchodě v reálném čase se na AI Search nemusí vztahovat.

Testování vaší integrace

Po aktivaci akcí otevřete Overview (Přehled) a vyzkoušejte:

• „Ukaž mi běžecké boty“ (otestuje vyhledávání produktů)
• „Jaký je stav mé objednávky 12345?“ (otestuje podrobnosti objednávky; zadejte odpovídající e-mail pro objednávku, ke které máte oprávnění přistupovat)

Ověřte, že odpovědi odpovídají datům z vašeho obchodu na platformě Shoper a že se odkazy na produkty správně otevírají.

Instalace chatbota do vašeho obchodu Shoper

Pokud jste použili Metodu 1 (aplikaci), chatovací widget už ve vašem obchodě je a není potřeba nic dalšího přidávat. Pokud jste použili Metodu 2 (ruční nastavení), otevřete v ChatLabu Deploy > Shoper (Nasazení > Shoper), přepněte na Manual Installation (Ruční instalace), zkopírujte kód a vložte jej v administraci Shoperu v sekci Add-ons and integrations > Custom integrations (Doplňky a integrace > Vlastní integrace) do pole Page header (Záhlaví stránky). Podrobnosti najdete v článku Adding chatbot to your website.

Související články

• AI Search: jak váš chatbot vyhledává produkty
• E-commerce plány a limity
• Průvodce nastavením e-commerce
• Přidání chatbota na váš web