Jak nainstalovat agenta na Shopify

Kam vložit kód do šablony Shopify, jak agent čte katalog obchodu, co dělat s košíkem a platbou a jak ověřit instalaci.

6. září 2026

Shopify už má katalog ve strojově čitelném formátu. Proto agent shromažďuje produkty přesněji než kdekoli jinde: ceny, varianty, dostupnost a fotografie pocházejí přímo z obchodu.

Krok 1. Vložte kód do šablony#

1. V administraci Shopify otevřete „Online obchod“ → „Šablony“.
2. U aktivní šablony klikněte na … → „Upravit kód“.
3. V seznamu souborů najděte layout/theme.liquid.
4. Vložte řádek kódu z účtu přímo před uzavírací značku </body>.
5. Uložte.

Alternativa bez úpravy šablony: „Online obchod“ → „Předvolby“ → „Vlastní kód“ nebo jakákoli aplikace pro vkládání skriptů. Výsledek je stejný.

    <!-- Commerce Agents -->
    <script src="https://comag.vibevox.pro/widget.js" data-slug="váš-slug" async></script>
  </body>
</html>

Přesný řádek získáte v účtu tlačítkem „Kopírovat kód“: už obsahuje adresu vašeho e-shopu.

Krok 2. Shromážděte katalog#

V nastavení zadejte adresu obchodu a spusťte analýzu. Procházeč Shopify čte strukturovaná data produktů: název, cenu, měnu, dostupnost, popis a fotografie. Varianty (velikosti, barvy) se do karty dostanou jako vlastnosti.

Opakovaná analýza aktualizuje ceny a dostupnost. Spusťte ji po větších změnách sortimentu: agent se nepřipojuje přímo k vaší databázi, ale pracuje se shromážděným katalogem.

Krok 3. Nechte platbu na obchodě#

Na Shopify není třeba zapínat platbu v chatu. Správné schéma:

1. V nastavení obchodu zadejte odkaz na košík – obvykle https://váš-doména/cart.
2. Agent vybere produkt, zobrazí kartu a tlačítkem vede kupujícího do košíku Shopify.
3. Dokončení objednávky a platba probíhají obvyklým způsobem, se všemi vašimi pravidly pro doručení a daně.

Abyste viděli, které dialogy končí nákupem, vložte fragment nákupního pixelu na stránku s poděkováním. V Shopify je to „Nastavení“ → „Pokladna“ → „Stránka stavu objednávky“ → „Další skripty“. Fragment s doplněním čísla objednávky a částky najdete v účtu, v sekci „Widget a odkaz“.

Produkt se dostane do košíku, aniž by přerušil konverzaci#

Zde se Shopify projevuje lépe než ostatní platformy. Agent zobrazuje karty produktů s fotografií, cenou a tlačítkem, ale tlačítko nevede jen na stránku – vloží produkt přímo do košíku obchodu.

Funguje to takto: v odkazu na produkt Shopify je identifikátor varianty, agent ho předá vašemu košíku přes standardní rozhraní /cart/add.js. Stránka se nepřenačítá, dialog se nepřerušuje, kupující vidí krátké potvrzení a pokračuje ve výběru. Produkt je přitom už v košíku Shopify – se všemi vašimi pravidly pro slevy, daně a doručení.

Pokud varianta v odkazu není, agent otevře kartu produktu a kupující ji přidá sám. Nic se nerozbije, je to jen o jedno kliknutí navíc.

Když je zákazník připraven, tlačítko „Přejít k pokladně“ vede do /cart, kde je už vše připraveno. Dále už je to běžná pokladna Shopify.

A zvlášť k tématu kontextu: agent čte strukturovaná data stránky, na které je chat otevřen. Kupující si prohlíží konkrétní produkt a ptá se „je k dispozici ve velikosti L?“ – agent rozumí, o čem je řeč, bez doplňujících otázek.

• Otevřete obchod v anonymním režimu, počkejte na tlačítko chatu.
• Zeptejte se na produkt podle názvu – měla by se objevit karta s cenou.
• Klikněte na „Přejít k pokladně“ – měl by se otevřít košík Shopify.
• Dokončete testovací objednávku a ujistěte se, že se nákup zaznamenal v „Žádostech“.

Chat v souladu s e-shopem#

Šablona Shopify udává tón celému obchodu a chat by z něj neměl vybočovat. V nastavení widgetu jsou tři varianty: světlá, tmavá a „jako u návštěvníka“, která se řídí nastavením zařízení kupujícího.

Pro obchody s tmavou šablonou nastavte tmavou napevno, pro světlé – světlou. Akcentní barva tlačítek zůstává v obou případech vaše.

Krok 4. Zkontrolujte#

Časté problémy#

Widget zmizel po změně šablony. Kód je uložen v souboru šablony. Změna nebo aktualizace šablony úpravu smaže – vložte kód znovu nebo použijte Custom code, který na šabloně nezávisí.

Katalog se neshromáždil celý. Procházení získává produkty z veřejných stránek. Skryté produkty z katalogu a koncepty se nezahrnují, což je správné.

Ceny v katalogu jsou zastaralé. Spusťte analýzu webu znovu, aktualizuje ceny a dostupnost u stávajících karet.

Widget koliduje s aplikací chatu. Ponechte jen jeden chat: dvě okna v jednom rohu si navzájem překážejí a matou kupujícího.

Časté dotazy#

Je nutná aplikace z Shopify App Store#

Ne. Agent se připojuje jedním řádkem kódu, instalace aplikace není nutná.

Umí agent zobrazovat varianty produktu#

Ano, varianty se do karty dostanou jako vlastnosti: velikost, barva, objem. Výběr konkrétní varianty provede kupující v košíku Shopify.

Jak je to s několika měnami#

Agent zobrazuje ceny v měně katalogu, kterou určí při procházení. Multiměnovost Shopify funguje dále, na straně košíku a platby.

Bude agent vědět o zásobách#

Dostupnost se bere v okamžiku analýzy. U produktů, které se často vyprodávají, spouštějte analýzu častěji nebo přidejte do podmínek větu, že dostupnost se upřesňuje při objednávce.

Ovlivňuje widget rychlost obchodu#

Skript se načítá asynchronně a neblokuje vykreslování. Na metriky Core Web Vitals to prakticky nemá vliv.