Jak nainstalovat agenta na WordPress a WooCommerce

Tři způsoby vložení kódu na WordPress, jak agent čte katalog WooCommerce, co dělat s kešovacími pluginy a jak propojit chat s košíkem.

6. září 2026

Na WordPress se kód vkládá třemi způsoby. Vyberte si podle toho, jak moc jste zvyklí upravovat soubory šablony.

Způsob 1: plugin pro vkládání kódu (doporučujeme)#

Nejbezpečnější varianta: úpravy se neztratí při aktualizaci šablony.

1. Nainstalujte si libovolný plugin pro vkládání skriptů: WPCode, Insert Headers and Footers, Code Snippets.
2. Otevřete nastavení pluginu a najděte pole pro kód v patičce – obvykle se nazývá Footer nebo Body (before closing tag).
3. Vložte řádek z administrace a uložte.

Způsob 2: soubor šablony#

1. Vzhled → Editor souborů šablony.
2. Otevřete footer.php.
3. Vložte kód před </body>.
4. Aktualizujte soubor.

Důležité: upravujte podřízenou šablonu. Při aktualizaci nadřazené šablony se soubor přepíše i s vaším kódem.

Způsob 3: přes functions.php#

Pro ty, kdo jsou zvyklí na kód. V functions.php podřízené šablony:

add_action('wp_footer', function () {
`echo '<script src="https://comag.vibevox.pro/widget.js" data-slug="váš-slug" async></script>';`
});

Přesný řádek skriptu získáte v administraci, tlačítkem „Zkopírovat kód“.

Katalog z WooCommerce#

Zadejte adresu webu v nastavení a spusťte analýzu. Procházeč čte produkty WooCommerce prostřednictvím strukturovaných dat stránek: název, cena, dostupnost, popis, fotografie, kategorie.

Co je dobré vědět:

• Variabilní produkty se dostanou do karty s cenovým rozsahem a charakteristikami.
• Skryté a koncepty se nenačítají – a tak to má být.
• Produkty pouze pro přihlášené agent neuvidí: prochází web jako běžný návštěvník.
• Pokud máte export produktů v CSV, můžete jej nahrát v sekci „Katalog“ – někdy je to rychlejší a přesnější než procházení.

Košík a platba#

Na WooCommerce se platba v chatu obvykle nezapíná: obchod má vlastní pokladnu s dopravou, daněmi a kupóny.

V nastavení zadejte odkaz na košík, nejčastěji https://vasedomena/cart nebo /kosik. Agent tam zákazníka dovede.

Abyste viděli, které dialogy se promění v objednávky, přidejte fragment nákupního pixelu na stránku „Děkujeme za objednávku“. V WooCommerce je to šablona checkout/thankyou.php nebo stejný plugin pro vkládání kódu s podmínkou pro stránku objednávky.

Tlačítko v chatu přidá produkt do košíku WooCommerce#

Karty produktů v odpovědích agenta nejsou jen obrázky pro parádu. Každá má odkaz na stránku produktu ve vašem obchodě a agent umí využít standardní mechanismus WooCommerce pro přidání do košíku: adresou typu ?add-to-cart=123.

Zákazník klikne na tlačítko v chatu, produkt se ocitne v košíku, dále funguje vaše pokladna se všemi pluginy pro dopravu, kupóny a daně. Žádné integrace ani klíče k tomu nejsou potřeba: mechanismus je do WooCommerce zabudován od narození.

Pokud odkaz vede na stránku variabilního produktu, agent ji otevře – vybrat velikost a barvu si zákazník musí sám, a to je správné: dosazovat za něj variantu je riskantní.

Ještě jedna věc, kterou je dobré vědět: agent vidí stránku, na které je chat otevřen. Čte si označení produktu – název, SKU, cenu – a odpovídá v kontextu. Návštěvník je na kartě produktu a píše „a je to levnější?“ – agent chápe, s čím srovnávat, a nabídne alternativu z vašeho katalogu, nikoli abstraktní radu.

Hlavní důvod, proč se „widget neobjevil“ na WordPressu, je cache. Po vložení kódu:

1. Vymažte cache pluginu: WP Rocket, W3 Total Cache, LiteSpeed nebo co používáte.
2. Vymažte cache CDN, pokud používáte Cloudflare.
3. Zkontrolujte web v anonymním režimu.

Pokud je v pluginu zapnuto „slučování a odložené načítání skriptů“, přidejte náš skript do výjimek: slučování externích skriptů někdy naruší načítání.

Světlý a tmavý motiv#

Widget umí obojí. V nastavení se vybírá světlý motiv, tmavý nebo „jako u návštěvníka“ – poslední jmenovaný se řídí systémovým nastavením zařízení a je nastaven jako výchozí.

To je praktické, pokud vaše šablona WordPressu má přepínač denního a nočního režimu: nechte „jako u návštěvníka“ a chat se bude shodovat s tím, co si uživatel již vybral.

Cache pluginy#

Kontrola#

• Tlačítko chatu se objeví v pravém dolním rohu na jakékoli stránce webu.
• Dotaz na produkt zobrazí kartu s cenou.
• Tlačítko pro dokončení objednávky vede do košíku WooCommerce.
• Na mobilu tlačítko nepřekrývá menu a košík.

Časté dotazy#

Je potřeba samostatný plugin Commerce Agents#

Ne. Stačí řádek kódu, samostatný plugin není potřeba a neinstaluje se.

Widget se neobjevil, co zkontrolovat jako první#

Cache: plugin pro cachování a CDN. Poté – že je kód vložen do patičky, nikoli do libovolného widgetu postranního panelu, a že šablona skutečně vypisuje wp_footer().

Bude agent vědět o slevách a kupónech#

O kupónech ne: ty se uplatňují v košíku WooCommerce. Ceny agent zobrazuje ty, které byly při procházení, včetně ceny se slevou, pokud se zobrazuje na stránce produktu.

Zpomalí to web#

Skript je asynchronní, váží málo a neblokuje vykreslování stránky. Na PageSpeed je vliv minimální.

Lze zobrazovat widget pouze v obchodě, nikoli na blogu#

Ano, pokud kód vložíte přes plugin s podmínkami zobrazení nebo do functions.php s kontrolou is_woocommerce(). V jednoduchém případě agent na všech stránkách nepřekáží: odpovídá i na otázky o doručení z blogu.