DomovDokumentácia

Integrácia so Shopify

Pridajte AI chatboty ChatReact, kontaktné formuláre a FAQ akordeóny do vášho obchodu na 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 vo vašom administračnom paneli 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 celom webe alebo na konkrétnych stránkach cez App Embed
Form WidgetKontaktné formuláre s ochranou proti spamuInline cez App Block v Theme Editor
FAQ WidgetZobrazenie FAQ v akordeónovom štýleInline cez App Block v Theme Editor

Nastavenie Chat Widgetu

Nastavenie chat widgetu prebieha v dvoch krokoch: vytvoríte priradenie widgetu v aplikácii ChatReact a potom povolíte App Embed vo vašej téme.

Krok 1: Vytvorenie priradenia widgetu

  1. Otvorte aplikáciu ChatReact vo vašom Shopify admin
  2. Na karte Chat Widget kliknite na Add Assignment
  3. Zadajte Chatbot ID (nájdete v dashboarde ChatReact pod Settings → Embed)
  4. Kliknite na Save Assignment

Krok 2: Povolenie App Embed

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

Povoliť App Embed stačí len raz. Následne spravujete, kde sa widget zobrazuje, výlučne z aplikácie ChatReact.

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

Priradenia widgetov

Každé priradenie prepojí chatbota s vaším obchodom. 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, podporované sú zástupné znaky * (napr. /blogs/*)
  • Specific Page: Widget sa zobrazuje iba na zadanom ceste stránky (napr. /pages/about)

Ak má stránka vlastné priradenie Specific Page, tam sa zobrazí tento 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 priame úpravy šablón, môžete widgety pridať 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:

NastavenieMožnosti
AlignmentLeft, Center, Right
Max Width200–1200px
Font Size12–28px
Margin Bottom0–120px
LanguageAuto-detect (predvolené) alebo jedna zo 24 jazykov

Štýlovanie FAQ Widgetu

NastavenieMožnosti
CategoriesVoliteľné, čiarkou oddelené slugy kategórií (napr. general,pricing) na zobrazenie iba vybraných FAQ kategórií
Font Size12–28px
Margin Bottom0–120px
LanguageAuto-detect (predvolené) alebo jedna zo 24 jazykov

Správa widgetov

Aplikácia ChatReact vo vašom Shopify admin poskytuje tri karty:

  1. Chat Widget — Vytváranie a správa priradení widgetov, ktoré kontrolujú, na ktorých stránkach sa zobrazuje chat widget
  2. Forms — Postupné inštrukcie na vkladanie, manuálny Liquid snippet a miesto, kde nájdete vaše Form ID
  3. FAQ Widget — Inštrukcie na vloženie FAQ widgetu a miesto, kde nájdete 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šetky 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 sa použije primárny jazyk chatbota
  • Form a FAQ bloky majú vlastné nastavenie Language v Theme Editore — predvolene je nastavené na Auto-detect a je možné ho prepísať pre každý blok

Odinštalovanie

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


Ďalšie kroky