DomovDokumentácia

Shopify Integration

Pridajte ChatReact AI chatboty, kontaktné formuláre a FAQ akordeóny do vášho obchodu Shopify pomocou oficiálnej aplikácie ChatReact pre Shopify.

Inštalácia

  1. Nainštalujte aplikáciu ChatReact z Shopify App Store
  2. Otvorte aplikáciu v administrácii Shopify

Nie je potrebné žiadne samostatné prepojenie účtu — aplikáciu prepojíte s vašimi chatbotmi a formulármi vložením ich ID z dashboardu ChatReact.

Funkcie

Aplikácia pre Shopify poskytuje tri typy widgetov:

WidgetPopisUmiestnenie
Chat WidgetAI chatbot s podporou live chatuNa celej stránke alebo na konkrétnych stránkach cez App Embed
Form WidgetKontaktné formuláre s ochranou proti spamuInline cez App Block v Theme Editore
FAQ WidgetFAQ zobrazené ako akordeónInline cez App Block v Theme Editore

Nastavenie Chat Widgetu

Nastavenie chat widgetu prebieha v dvoch krokoch: vytvorte priradenie widgetu v aplikácii ChatReact, potom povoľte App Embed vo vašej téme.

Krok 1: Vytvorenie priradenia widgetu

  1. Otvorte aplikáciu ChatReact vo vašej administrácii Shopify
  2. Na karte Chat Widget kliknite na Add Assignment
  3. Zadajte svoje ID chatbota (nájdete ho v dashboarde ChatReact na karte Vloženie vášho chatbota)
  4. Kliknite na Save Assignment

Krok 2: Povoľte App Embed

  1. Prejdite na Online Store → Themes → Edit theme
  2. Kliknite na ikonu App embeds (puzzle kus) v ľavom dolnom bočnom paneli
  3. Prepínač ChatReact Chat Widget prepnite na ON
  4. Kliknite na Save

App Embed potrebujete povoliť len raz. Potom už úplne cez aplikáciu ChatReact spravujete, kde sa widget zobrazuje.

Chat widget sa zobrazí na každej stránke, ktorú pokrýva niektoré z vašich priradení widgetu.

Priradenia widgetov

Každé priradenie prepojí chatbota s vaším storefrontom. Existujú dva typy priradení:

  • Everywhere: Widget sa zobrazuje na všetkých stránkach (predvolené). Voliteľne môžete pridať Exclude URLs — jedna cesta na riadok, s podporou zástupných znakov * (napr. /blogs/*)
  • Specific Page: Widget sa zobrazuje len na stránke, ktorú zadáte (napr. /pages/about)

Ak má stránka svoje vlastné priradenie Specific Page, tam sa zobrazí ten chatbot namiesto Everywhere chatbota.

Pridanie Form a FAQ widgetov

Form a FAQ widgety sa pridávajú ako App Blocks v Theme Editore:

  1. Prejdite na Online Store → Themes → Edit theme
  2. Navigujte na stránku, kde chcete widget umiestniť
  3. Kliknite na Add block a vyhľadajte "ChatReact"
  4. Vyberte ChatReact Form alebo ChatReact FAQ
  5. Zadajte Form ID alebo Chatbot ID v nastaveniach bloku

Manuálne vloženie (Liquid)

Ak preferujete priamu úpravu šablón, môžete widgety pridať aj do ľubovoľnej Liquid šablóny:

<!-- 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>

Štýlovanie Form Widgetu

Prispôsobte vzhľad formulára v Theme Editore:

SettingOptions
AlignmentVľavo, Centrum, Vpravo
Max Width200–1200px
Font Size12–28px
Margin Bottom0–120px
JazykAuto-detect (predvolené) alebo jedna z 24 jazykových možností

Štýlovanie FAQ Widgetu

SettingOptions
KategórieVoliteľné čiarkou oddelené slugs kategórií (napr. general,pricing) na zobrazenie iba vybraných FAQ kategórií
Font Size12–28px
Margin Bottom0–120px
JazykAuto-detect (predvolené) alebo jedna z 24 jazykových možností

Správa widgetov

Aplikácia ChatReact vo vašej administrácii Shopify poskytuje tri karty:

  1. Chat Widget — Vytváranie a správa priradení widgetov, ktoré určujú, na ktorých stránkach sa chat widget zobrazuje
  2. Formuláre — Krok za krokom pokyny na vloženie, manuálny Liquid snippet a kde nájsť vaše Form ID
  3. FAQ Widget — Pokyny na vloženie FAQ widgetu a kde nájsť vaše Chatbot ID

Výber formulára a FAQ prebieha v Theme Editore: zadajte Form ID alebo Chatbot ID v nastaveniach bloku.

Podpora jazykov

Aplikácia podporuje všetkých 24 jazykov EÚ:

  • chat widget automaticky detekuje jazyk prehliadača každého návštevníka a porovná ho s podporovanými jazykmi vášho chatbota, v prípade potreby použije primárny jazyk chatbota
  • Form a FAQ bloky majú každá svoje Jazyk nastavenie v Theme Editore — predvolene Auto-detect a dá sa prepísať pre každý blok

Odinštalovanie

Po odinštalovaní aplikácie ChatReact sú všetky konfigurácie widgetov a uložené údaje automaticky odstránené z vášho obchodu Shopify.


Ďalšie kroky