Az ügynök telepítése Shopify-ra

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.

2026. szeptember 6.

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ó </body> 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.

    <!-- Commerce Agents -->
<script src="https://comag.vibevox.pro/widget.js" data-slug="az-Ön-slugja" async></script>
  </body>
</html>

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.