---
title: Jak nainstalovat agenta na Shopify
description: 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.
section: platforms
keywords: Shopify, widget na Shopify, theme.liquid, chat pro Shopify, AI agent Shopify, instalace agenta Shopify, Commerce Agents Shopify, chatbot Shopify, katalog produktů Shopify, podpora AI Shopify, automatizace prodeje Shopify, integrace AI Shopify
updated: 2026-09-06
---
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ý.

```liquid
    <!-- 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.