Integrácia so Shopify: AI Search, vyhľadávanie v obchode naživo a stav objednávky

Prepojte svoj ChatLab chatbot s obchodom Shopify, aby zákazníci mohli hľadať produkty a overovať stav svojich objednávok priamo v chate. Produkty sa vyhľadávajú pomocou funkcie AI Search, ktorá prehľadáva váš indexovaný katalóg Shopify podľa významu, alebo prostredníctvom live vyhľadávania v obchode, ktoré odosiela dopyty priamo do API obchodu.

Príklad konverzácie

Tento príklad znázorňuje skúsenosť zákazníka. Dostupné akcie a vrátené informácie závisia od tejto integrácie a vašej konfigurácie.

Skôr než začnete

Najprv vytvorte alebo vyberte chatbota. Potrebujete oprávnenie na správu jeho integrácií a prístup k nastaveniam pripojenia v externom účte. Ak dlaždica Connect (Pripojiť) zobrazuje výzvu na upgrade alebo kontaktovanie podpory, skontrolujte, či vaše predplatné túto integráciu zahŕňa. Prístupové údaje k API uchovávajte v tajnosti; nikdy ich nevkladajte do embed kódu na webovej stránke.

Dôležité: osvedčené postupy pre e-commerce

Po dokončení nižšie uvedenej integrácie si prečítajte komplexného sprievodcu optimalizáciou chatbota pre e-commerce: Ako nastaviť ChatLab pre váš e-commerce obchod

Ako chatbot vyhľadáva produkty v Shopify: AI Search a živé vyhľadávanie v obchode

Existujú dva spôsoby, ako chatbot ChatLab vyhľadáva produkty v obchode Shopify. Chatbot používa buď jeden, alebo druhý, nikdy nie oba naraz.

AI Search (odporúčané) - ChatLab si udržiava vlastný index vášho Shopify katalógu a chatbot v ňom vyhľadáva podľa významu.

• Zákazníci sa pýtajú bežným jazykom, napríklad „červené šaty do 300". Cenové rozpätie sa uplatňuje ako striktný filter a presne sa priraďujú aj kódy produktov (SKU, EAN).
• Cena, skladová dostupnosť a varianty sa načítavajú naživo zo Shopify priamo v momente odpovede, takže zákazníci vidia aktuálne údaje aj medzi obnoveniami indexu.
• Výsledky sa zobrazujú ako produktové karty v chate, maximálne 5 v jednej odpovedi.
• Indexovanie sa spustí automaticky po prepojení obchodu. Katalóg nespotrebúva trénovacie znaky.
• Potrebný plán: zahŕňa ho každý plán E-commerce (Free 100 produktov, Start 2 000, Grow 5 000, Scale 20 000). V pláne Universal si pridajte doplnok Integrácie e-commerce ($30 mesačne) a balíček produktov pre AI Search ($29 mesačne, 5 000 produktov) priradený k chatbotovi.

Živé vyhľadávanie v obchode - chatbot odovzdá frázu zákazníka do vyhľadávania Shopify prostredníctvom API obchodu a odpovie tým, čo obchod vráti.

• Nič sa neindexuje a nič netreba synchronizovať. Údaje sú vždy aktuálne.
• Ide o vyhľadávanie podľa kľúčových slov: nájde to, čo by pre danú frázu našlo vlastné vyhľadávanie vo vašom obchode. Nerozumie opisom potrieb, synonymám ani preklepom tak, ako AI Search.
• Potrebný plán: plán Universal s doplnkom Integrácie e-commerce ($30 mesačne). Produktový balíček nie je potrebný.

Keď je funkcia AI Search zapnutá, nahrádza živé vyhľadávanie v obchode. Stav objednávky funguje pri oboch spôsoboch rovnako. Tretia možnosť, trénovanie na naskenovaných stránkach obchodu, je dostupná v každom pláne a je určená pre informačný obsah, ako sú doprava a vrátenie tovaru, nie pre produkty. Úplné porovnanie nájdete v článku AI Search: ako váš chatbot vyhľadáva produkty a limity produktov v článku Plány a limity E-commerce.

Čo integrácia poskytuje

Live vyhľadávanie v obchode (vyhľadávanie produktov podľa frázy) - Chatbot odošle frázu zákazníka do vyhľadávania v Shopify. Prehľadáva názvy produktov, popisy, typy, tagy a dodávateľov, pričom vracia zodpovedajúce aktívne produkty s týmito údajmi:

• Názov produktu, popis a typ
• Dodávateľ a tagy
• Cena alebo cenové rozpätie (pre produkty s viacerými variantmi)
• Dostupné varianty s SKU, pôvodnou cenou (compare-at price), skladovým množstvom a stavom dostupnosti
• Obrázok produktu a priamy odkaz do vášho obchodu

Vyhľadávanie produktov môžete nakonfigurovať tak, aby zobrazovalo iba produkty na sklade. Ak je táto možnosť zapnutá, vypredané položky sú z výsledkov vylúčené. Dodatočná možnosť vám umožňuje zahrnúť aj produkty dostupné na predobjednávku, a to aj vtedy, keď je filter skladovej dostupnosti aktívny. Podrobnosti nájdete v časti Krok 4.

Podrobnosti o objednávke (Order Details) - V predvolenom nastavení zákazníci zadávajú číslo objednávky a zodpovedajúcu e-mailovú adresu. Voliteľné režimy umožňujú vyhľadávanie iba podľa ID objednávky alebo nedávnych objednávok iba podľa e-mailu. Ide o dátové zhody, nie o overenie totožnosti návštevníka. Chatbot vracia:

• Označenie objednávky, dátum, celkovú sumu a menu
• Objednané položky s názvami, množstvami, cenami, SKU, názvom variantu a dodávateľom
• Stav vybavenia a informácie o sledovaní zásielky (číslo, prepravná spoločnosť, URL)
• Dodaciu adresu a fakturačnú adresu
• Spôsob dopravy a cenu doručenia
• Kontaktné údaje zákazníka (e-mail, meno, telefónne číslo)
• Dôvod a dátum zrušenia (pri zrušených objednávkach)

Krok 1: Vytvorte si prihlasovacie údaje k Shopify API

Dôležité pre agentúry a partnerov Shopify: Vytvorte a nainštalujte aplikáciu v organizácii, ktorá obchod vlastní. Prepojenie cez Client ID a Secret v ChatLabe využíva autorizáciu Shopify client credentials grant, ktorá nepodporuje aplikácie vlastnené inou organizáciou. Ak sa vám zobrazí hlásenie "The app cannot access this store", pred výmenou prihlasovacích údajov skontrolujte organizáciu a inštaláciu aplikácie. Pozrite si požiadavky Shopify pre client credentials.

1. Prihláste sa do administrácie Shopify
2. Prejdite na Settings > Apps (Nastavenia > Aplikácie)
3. Kliknite na Develop apps (Vývoj aplikácií)
4. Na stránke App Development (Vývoj aplikácií) kliknite na Build apps in Dev Dashboard (Vytvárať aplikácie na vývojárskom paneli) - otvorí sa adresa dev.shopify.com/dashboard
5. Kliknite na Create app (Vytvoriť aplikáciu) a zadajte názov (napr. "ChatLab Integration")

6. Po vytvorení prejdite do sekcie Access (Prístup) a kliknite na Select scopes (Vybrať rozsahy)

7. V časti s rozsahmi prístupu Admin API nájdite a povoľte tieto oprávnenia:
   • read_products
   • read_orders
8. Kliknite na Done (Hotovo)

9. Kliknutím na tlačidlo Release (Zverejniť) aplikáciu zverejnite
10. Prejdite do App settings (Nastavenia aplikácie) a skopírujte si Client ID (ID klienta) a Secret (Tajný kľúč) - bezpečne si ich uložte, budete ich potrebovať na prepojenie s ChatLabom

11. Prejdite do sekcie Home (Domov) a kliknite na možnosť inštalácie aplikácie do vášho obchodu

12. Vyberte svoj obchod a inštaláciu potvrďte kliknutím na Install (Inštalovať)

Krok 2: Nájdite subdoménu svojho obchodu

Nájdite doménu myshopify.com svojho obchodu v časti Settings > Domains (Nastavenia > Domény) v Shopify a potom zadajte iba časť pred .myshopify.com. Pre pizza-delicious.myshopify.com zadajte pizza-delicious, nie svoju vlastnú doménu obchodu ani URL adresu ovládacieho panela admin.shopify.com. Pozrite si sprievodcu doménami Shopify.

Krok 3: Pripojte Shopify v ChatLabe

1. Prihláste sa do ChatLabu a vyberte svojho bota
2. Prejdite na kartu Connect (Prepojenie)

3. Kliknite na Connect (Pripojiť) na dlaždici Shopify
4. Zadajte svoje Client ID (z Kroku 1)
5. Zadajte svoj Secret (z Kroku 1)
6. Zadajte svoju Shopify subdoménu (z Kroku 2)

7. Kliknite na Connect (Pripojiť)

ChatLab automaticky otestuje pripojenie overením, či majú vaše prístupové údaje API požadované rozsahy oprávnení (access scopes). Ak je test úspešný, zobrazí sa potvrdzujúca správa.

Krok 4: Konfigurácia akcií Shopify (Shopify Actions)

Po pripojení môžete povoliť a prispôsobiť jednotlivé akcie umelej inteligencie. Prejdite do Settings > Actions (Nastavenia > Akcie) a filtrujte podľa platformy Shopify.

Medzi štandardné akcie patria:

• Shopify - product search (Shopify - vyhľadávanie produktov) - umožňuje chatbotovi prehľadávať váš katalóg produktov
• Shopify - order details (Shopify - podrobnosti o objednávke) - umožňuje chatbotovi vyhľadávať informácie o objednávkach

Nastavenie prepojenia štandardné akcie automaticky povolí. Skontrolujte ich stav a vypnite všetky, ktoré nechcete, aby zákazníci používali. Akciu otvoríte kliknutím na ňu a upravíte ju pomocou tlačidla Enable (Povoliť) alebo Update (Aktualizovať) v jej dialógovom okne. Môžete tiež prispôsobiť štítok akcie (správu zobrazenú používateľom počas vykonávania akcie) a inštrukcie, ktoré určujú, ako má AI danú akciu používať.

Vyhľadávanie produktov - nastavenia zásob (Inventory Settings)

Akcia vyhľadávania produktov obsahuje možnosti filtrovania zásob na karte Product Search Settings (Nastavenia vyhľadávania produktov):

• Products in stock only (Iba produkty na sklade) - ak je táto možnosť povolená, chatbot vracia iba produkty, ktoré sú momentálne na sklade. Vypredané produkty sú z výsledkov vyhľadávania vylúčené.
• Show products available for pre-order (Zobraziť produkty dostupné na predobjednávku) - táto možnosť sa zobrazí, keď je povolené nastavenie „Products in stock only“. Keď je aktívna, produkty, ktoré nie sú na sklade, ale v službe Shopify majú nastavené pokračovanie predaja (predobjednávka), sa vo výsledkoch vyhľadávania naďalej zobrazia s označením, že sú dostupné na predobjednávku.

Ochrana osobných údajov pri vyhľadávaní objednávok

V časti Order Lookup Configuration (Konfigurácia vyhľadávania objednávok) v akcii pre objednávky sú možnosti Allow order lookup without email verification (Povoliť vyhľadanie objednávky bez overenia e-mailu) aj Allow order lookup by email address only (Povoliť vyhľadanie objednávky iba na základe e-mailovej adresy) predvolene vypnuté. Režim vyhľadávania iba pomocou e-mailu predvolene vracia 1 nedávnu objednávku, pričom tento počet možno nastaviť v rozsahu od 1 do 3. Povolením vyhľadávania iba na základe ID sa režim vyhľadávania iba pomocou e-mailu zakáže. Každý, kto pozná zvolený identifikačný údaj na vyhľadanie, môže získať informácie o objednávke, preto si pred povolením ktorejkoľvek z týchto možností skontrolujte nastavenia riadenia prístupu a maskovanie osobných údajov (PII).

AI Search pre Shopify: katalóg, reindexácia a nastavenia

V pláne E-commerce alebo v pláne Universal s priradeným balíkom produktov AI Search k chatbotovi je funkcia AI Search zapnutá a nahrádza priame vyhľadávanie v obchode. Indexovanie sa spustí automaticky po prepojení obchodu.

• Skontrolujte katalóg - otvorte Training > E-commerce catalog (Tréning > E-commerce katalóg) a skontrolujte záložky Products (Produkty) a Categories (Kategórie). V sekcii Shop > Products (Obchod > Produkty) nájdete panel Product catalog (Katalóg produktov) a kartu AI Search packs on this chatbot (Balíky AI Search na tomto chatbotovi).
• Naplánujte reindexáciu - použite Schedule auto-retrain (Naplánovať automatické pretrénovanie) v Training > E-commerce catalog (Tréning > E-commerce katalóg). Reindexácia môže prebiehať pokojne aj denne a je dostupná v každom pláne E-commerce a s každým balíkom produktov. Možnosť Train now (Trénovať teraz) alebo Retrain (Pretrénovať) ju spustí na požiadanie. Aktualizácie sú inkrementálne: nezmenené produkty sa preskočia a odstránené produkty sa vymažú z indexu.
• Skontrolujte akciu - v ponuke Settings > Actions (Nastavenia > Akcie) otvorte Shopify - AI product search. Ponúka možnosti Include product card (Zahrnúť produktovú kartu), Products in stock only (Iba produkty na sklade) a Number of products to return (Počet vrátených produktov).
• Zobrazte produktové karty - zapnite Enable Offer Cards (Povoliť Offer Cards) v Settings > Model & Advanced (Nastavenia > Model a rozšírené). Pozrite si Offer Cards.

Keď je katalóg väčší než limit produktov, indexovanie sa zastaví na tomto limite a majiteľ chatbota dostane e-mail. Možnosti akcie priameho vyhľadávania v obchode popísané vyššie nemusia platiť pre AI Search.

Testovanie integrácie

Po aktivácii akcií otvorte Overview (Prehľad) a vyskúšajte:

• „Ukážte mi bežecké topánky“ (otestuje vyhľadávanie produktov)
• „Aký je stav mojej objednávky #1001?“ (otestuje podrobnosti objednávky; zadajte zodpovedajúci e-mail k objednávke, ku ktorej máte oprávnenie na prístup)

Overte, či odpovede zodpovedajú údajom z vášho obchodu Shopify a či sa odkazy na produkty správne otvárajú.

Nainštalujte chatbota do svojho obchodu Shopify

Ak chcete pridať chat widget do svojho obchodu Shopify:

1. V ChatLab prejdite na kartu Deploy (Nasadenie) pre svojho bota
2. Vyberte kartu platformy Shopify
3. Vyberte možnosť Widget a skopírujte úryvok kódu
4. V administrácii Shopify prejdite na Online Store > Themes (Internetový obchod > Témy)
5. Kliknite na ponuku s tromi bodkami pri svojej aktívnej téme a vyberte Edit code (Upraviť kód)
6. V sekcii Layout (Rozloženie) otvorte súbor theme.liquid
7. Vložte úryvok kódu do sekcie <head>
8. Kliknite na Save (Uložiť)

Otvorte publikovaný obchod a overte, či sa widget načíta. Prepojenie cez API a inštalácia do obchodu sú oddelené; povolené akcie skontrolujte v časti Settings > Actions (Nastavenia > Akcie).

Súvisiace články

• AI Search: ako váš chatbot vyhľadáva produkty
• Plány pre e-commerce a limity
• Sprievodca nastavením e-commerce
• Pridanie chatbota na váš web