DomůDokumentace

Shopify Integration

Přidejte ChatReact AI chatboty, kontaktní formuláře a FAQ akordeony do svého Shopify obchodu s oficiální ChatReact Shopify App.

Instalace

  1. Nainstalujte ChatReact aplikaci z Shopify App Store
  2. Otevřete aplikaci ve svém Shopify administrátorském panelu

Není potřeba žádné samostatné připojení účtu — aplikaci propojíte s vašimi chatboty a formuláři vložením jejich ID z ChatReact dashboardu.

Funkce

Shopify aplikace poskytuje tři typy widgetů:

WidgetPopisUmístění
Chat WidgetAI chatbot s podporou live chatuNa celém webu nebo na konkrétních stránkách přes App Embed
Form WidgetKontaktní formuláře s ochranou proti spamuInline přes App Block v Theme Editoru
FAQ WidgetFAQ zobrazené jako akordeonInline přes App Block v Theme Editoru

Nastavení Chat Widgetu

Nastavení chat widgetu probíhá ve dvou krocích: vytvořte přiřazení widgetu v ChatReact aplikaci a poté povolte App Embed ve vašem motivu.

Krok 1: Vytvořte přiřazení widgetu

  1. Otevřete ChatReact aplikaci ve svém Shopify administraci
  2. Na kartě Chat Widget klikněte na Add Assignment
  3. Zadejte své ID chatbota (najdete v ChatReact dashboardu na kartě Vložení vašeho chatbota)
  4. Klikněte na Save Assignment

Krok 2: Povolte App Embed

  1. Přejděte na Online Store → Themes → Edit theme
  2. Klikněte na ikonu App embeds (puzzle) v levém dolním postranním panelu
  3. Přepněte ChatReact Chat Widget do polohy ON
  4. Klikněte na Save

Stačí povolit App Embed jednou. Poté plně spravujete, kde se widget zobrazuje, přímo z ChatReact aplikace.

Chat widget se zobrazí na každé stránce pokryté jedním z vašich přiřazení widgetu.

Přiřazení widgetů

Každé přiřazení propojí chatbota s vaším obchodem. Existují dva typy přiřazení:

  • Everywhere: Widget se zobrazí na všech stránkách (výchozí). Volitelně můžete přidat Exclude URLs — jedna cesta na řádek, s podporou * zástupných znaků (např. /blogs/*)
  • Specific Page: Widget se zobrazí pouze na zadané cestě stránky (např. /pages/about)

Pokud má stránka vlastní přiřazení Specific Page, zobrazí se tam místo Everywhere chatbota ten specifický.

Přidání Form a FAQ widgetů

Form a FAQ widgety se přidávají jako App Blocks v Theme Editoru:

  1. Přejděte na Online Store → Themes → Edit theme
  2. Navigujte na stránku, kam chcete widget umístit
  3. Klikněte na Add block a vyhledejte "ChatReact"
  4. Vyberte ChatReact Form nebo ChatReact FAQ
  5. Zadejte Form ID nebo Chatbot ID v nastavení bloku

Ruční vložení (Liquid)

Pokud preferujete úpravy šablon přímo, můžete widgety také přidat do libovolné Liquid šablony:

<!-- Form widget -->
<div id="chatreact-form"></div>
<script src="https://www.chatreact.ai/embed/form.js"
  data-form-id="YOUR_FORM_ID"
  data-container="chatreact-form"
  async></script>
<!-- FAQ widget -->
<div id="chatreact-faq"></div>
<script src="https://www.chatreact.ai/embed/faq-widget.js"
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-container="chatreact-faq"
  async></script>

Stylování Form Widgetu

Přizpůsobte vzhled formuláře v Theme Editoru:

SettingOptions
AlignmentLeft, Center, Right
Max Width200–1200px
Font Size12–28px
Margin Bottom0–120px
JazykAuto-detect (výchozí) nebo jedna z 24 jazykových mutací

Stylování FAQ Widgetu

SettingOptions
KategorieVolitelné čárkou oddělené slugy kategorií (např. general,pricing) pro zobrazení pouze vybraných kategorií FAQ
Font Size12–28px
Margin Bottom0–120px
JazykAuto-detect (výchozí) nebo jedna z 24 jazykových mutací

Správa widgetů

ChatReact aplikace ve vaší Shopify administraci poskytuje tři karty:

  1. Chat Widget — Vytvářejte a spravujte přiřazení widgetů, která určují, na kterých stránkách se chat widget zobrazí
  2. Formuláře — Krok za krokem instrukce pro embedování, ruční Liquid snippet a kde najít svoje Form ID
  3. FAQ Widget — Instrukce pro embedování FAQ widgetu a kde najít vaše Chatbot ID

Výběr Form a FAQ se provádí v Theme Editoru: zadejte Form ID nebo Chatbot ID v nastavení bloku.

Podpora jazyků

Aplikace podporuje všech 24 jazyků EU:

  • chat widget automaticky detekuje jazyk prohlížeče každého návštěvníka a porovná ho s jazyky podporovanými vaším chatbotem; pokud není shoda, použije se primární jazyk chatbota
  • Form a FAQ bloky mají každé své vlastní Jazyk nastavení v Theme Editoru — výchozí je Auto-detect a lze jej přepsat pro každý blok zvlášť

Odinstalace

Po odinstalování ChatReact aplikace budou všechna konfigurace widgetů a uložená data automaticky odstraněna z vašeho Shopify obchodu.


Další kroky