--- title: Az ügynök telepítése Shopify-ra description: A kód beillesztése a Shopify témába, az ügynök hogyan olvassa be az áruház katalógusát, a kosár és a fizetés kezelése, valamint a telepítés ellenőrzése. section: platforms keywords: Shopify, Shopify ügynök telepítése, Shopify widget, chat Shopify-ra, AI ügynök Shopify, theme.liquid, Shopify katalógus, mesterséges intelligencia chatbot, e-kereskedelem AI, online bolt ügynök, Shopify integráció, Commerce Agents Shopify updated: 2026-09-06 --- A Shopify már rendelkezik géppel olvasható katalógussal, ezért az ügynök pontosabban gyűjti az adatokat, mint bárhol máshol: az árak, variációk, készlet és fotók magából az üzletből származnak. ## 1. lépés: Illessze be a kódot a témába 1. A Shopify admin felületén nyissa meg az **Online Store → Themes** menüpontot. 2. Az aktív téma mellett kattintson a **… → Edit code** gombra. 3. A fájllistában keresse meg a `layout/theme.liquid` fájlt. 4. Illessze be a kezelőfelületről származó kódsort közvetlenül a záró `` tag elé. 5. Mentse el. Alternatív megoldás a téma szerkesztése nélkül: **Online Store → Preferences → Custom code** vagy bármely szkriptbeillesztő alkalmazás. Az eredmény ugyanaz. ```liquid ``` A pontos kódsort a kezelőfelületen a „Kód másolása” gombbal veheti át: abban már szerepel az üzlete címe. ## 2. lépés: Gyűjtse össze a katalógust A beállításokban adja meg az üzlet címét, majd indítsa el az elemzést. A Shopify feltérképezője beolvassa a termékek strukturált adatait: név, ár, valuta, készlet, leírás és fényképek. A variációk (méretek, színek) jellemzőkként kerülnek a termékkártyára. Az ismételt elemzés frissíti az árakat és a készletet. Futtassa nagyobb választékváltozások után: az ügynök nem kapcsolódik közvetlenül az adatbázisához, hanem a gyűjtött katalógussal dolgozik. ## 3. lépés: Hagyja a fizetést az üzletre Shopify esetén nem szükséges a fizetést bekapcsolni a chaten belül. A helyes séma: 1. Az üzlet beállításaiban adja meg a kosár linkjét – általában `https://az-ön-domainje/cart`. 2. Az ügynök kiválasztja a terméket, megjeleníti a kártyát, és egy gombnyomásra a Shopify kosarába vezeti a vásárlót. 3. A megrendelés és a fizetés a megszokott módon történik, az összes szállítási és adózási szabályával együtt. Ahhoz, hogy lássa, melyik párbeszédek végződnek vásárlással, illessze be a vásárlási pixel kódrészletét a köszönőoldalra. Shopify esetén ez a **Settings → Checkout → Order status page → Additional scripts**. A rendelési szám és összeg behelyettesítésével ellátott kódrészlet a kezelőfelületen található, a „Widget és link” részben. ## A termék a kosárba kerül, a beszélgetés megszakítása nélkül Itt a Shopify jobban teljesít, mint más platformok. Az ügynök termékkártyákat jelenít meg fényképpel, árral és gombbal, de a gomb nem csak egy oldalra vezet – hanem a terméket az üzlet kosarába helyezi. Ez így működik: a Shopify terméklinkjében van egy variánsazonosító, amit az ügynök a saját kosarába továbbít a standard `/cart/add.js` interfészen keresztül. Az oldal nem töltődik újra, a párbeszéd nem szakad meg, a vásárló rövid megerősítést lát, és folytatja a választást. A termék eközben már a Shopify kosarában van – az összes kedvezményre, adóra és szállításra vonatkozó szabályával együtt. Ha a linkben nincs variáns, az ügynök megnyitja a termékkártyát, és a vásárló maga adja hozzá. Semmi sem romlik el, csak egy kattintással több. Amikor az illető készen áll, a „Tovább a fizetéshez” gomb a `/cart` oldalra vezet, ahol már minden össze van gyűjtve. Ezután – a szokásos Shopify pénztár. És külön a kontextusról: az ügynök beolvassa annak az oldalnak a strukturált adatait, amelyen a chat megnyílt. A vásárló egy konkrét terméket néz, és megkérdezi: „van L méretben?” – az ügynök megérti, miről van szó, anélkül, hogy visszakérdezne. - Nyissa meg az üzletet inkognitó módban, várja meg a chat gombot. - Kérdezzen rá egy termékre a neve alapján – meg kell jelennie egy termékkártyának az árral. - Kattintson a „Tovább a fizetéshez” gombra – meg kell nyílnia a Shopify kosarának. - Adjon le egy tesztrendelést, és győződjön meg róla, hogy a vásárlás megjelent a „Megrendelések” között. ## Chat az üzlet stílusában A Shopify téma adja meg az egész üzlet hangulatát, és a chatnek nem szabad kilógnia ebből. A widget beállításaiban három lehetőség van: világos, sötét és „mint a látogatóé”, amely a vásárló eszközének beállításait követi. Sötét témájú üzletekhez állítsa be fixen a sötétet, világosakhoz a világosat. A gombok kiemelő színe mindkét esetben az öné marad. ## 4. lépés: Ellenőrizze ## Gyakori problémák **A widget eltűnt a téma cseréje után.** A kód a téma fájljában él. A téma cseréje vagy frissítése törli a módosítást – illessze be újra a kódot, vagy használja a Custom code funkciót, amely független a témától. **A katalógus nem gyűlt össze teljesen.** A feltérképező a nyilvános oldalakról veszi a termékeket. A katalógusból elrejtett és a piszkozatok nem kerülnek bele, ez így helyes. **A katalógus árai elavultak.** Futtassa újra a webhely elemzését, ez frissíti az árakat és a készletet a meglévő termékkártyák alapján. **A widget ütközik egy chat alkalmazással.** Csak egy chatet hagyjon: két ablak ugyanabban a sarokban zavarja egymást és összezavarja a vásárlót. ## Gyakori kérdések ### Szükséges-e alkalmazás a Shopify App Store-ból Nem. Az ügynök egyetlen kódsorral csatlakozik, alkalmazás telepítése nem szükséges. ### Képes-e az ügynök termékvariációkat megjeleníteni Igen, a variációk jellemzőkként kerülnek a termékkártyára: méret, szín, űrtartalom. A konkrét variáns kiválasztását a vásárló a Shopify kosarában végzi el. ### Mi a teendő több valuta esetén Az ügynök a katalógus valutájában mutatja az árakat, amelyet a feltérképezés során határoz meg. A Shopify többvalutás funkciója tovább működik, a kosár és a fizetés oldalán. ### Tudni fog-e az ügynök a készletről A készlet az elemzés pillanatában kerül rögzítésre. A gyakran kifogyó termékek esetében futtassa gyakrabban az elemzést, vagy adjon hozzá a feltételekhez egy sort arról, hogy a készlet a megrendeléskor pontosítandó. ### Befolyásolja-e a widget az üzlet sebességét A szkript aszinkron módon töltődik be, és nem blokkolja a renderelést. A Core Web Vitals metrikákra gyakorlatilag nincs hatása.