DomůDokumentace

Integrace se Shopify

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

Instalace

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

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

Funkce

Aplikace pro Shopify poskytuje tři typy widgetů:

WidgetPopisUmístění
Chat WidgetAI chatbot s podporou live chatuNa celé stránce 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 WidgetZobrazení FAQ ve stylu akordeonuInline 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 aplikaci ChatReact a poté povolíte App Embed ve svém motivu.

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

  1. Otevřete aplikaci ChatReact ve svém administrátoru Shopify
  2. Na kartě Chat Widget klikněte na Add Assignment
  3. Zadejte své Chatbot ID (najdete v dashboardu ChatReact pod Settings → Embed)
  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 (tvar puzzle) v levém dolním postranním panelu
  3. Přepněte ChatReact Chat Widget na ON
  4. Klikněte na Save

App Embed je potřeba povolit pouze jednou. Poté budete veškerou správu toho, kde se widget zobrazuje, provádět přímo z aplikace ChatReact.

Chat widget se zobrazí na každé stránce, kterou pokrývá některé z vašich přiřazení widgetu.

Přiřazení widgetů

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

  • Everywhere: Widget se zobrazuje na všech stránkách (výchozí). Volitelně můžete přidat Exclude URLs — jeden cestovní řádek na řádek, s podporou zástupných znaků * (např. /blogs/*)
  • Specific Page: Widget se zobrazuje 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 tento specifický chatbot.

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. Otevřete 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 dáváte přednost úpravám šablon přímo, můžete widgety 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:

NastaveníMožnosti
AlignmentVlevo, Na střed, Vpravo
Max Width200–1200px
Font Size12–28px
Margin Bottom0–120px
LanguageAutomatické rozpoznání (výchozí) nebo jedna z 24 jazykových možností

Stylování FAQ Widgetu

NastaveníMožnosti
CategoriesVolitelné čárkou oddělené slugy kategorií (např. general,pricing) pro zobrazení pouze vybraných FAQ kategorií
Font Size12–28px
Margin Bottom0–120px
LanguageAutomatické rozpoznání (výchozí) nebo jedna z 24 jazykových možností

Správa widgetů

Aplikace ChatReact ve vašem administrátoru Shopify nabízí 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 zobrazuje
  2. Forms — Postupné instrukce pro vložení, ruční Liquid snippet a místo, kde najít vaše Form ID
  3. FAQ Widget — Instrukce pro vložení FAQ widgetu a místo, 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á jej s jazyky podporovanými vaším chatbotem, v případě potřeby se vrátí k primárnímu jazyku chatbota
  • Form a FAQ bloky mají v Theme Editoru vlastní nastavení Language — výchozí je Auto-detect a lze jej přepsat pro každý blok zvlášť

Odinstalace

Když odinstalujete aplikaci ChatReact, všechna nastavení widgetů a uložená data jsou z vašeho obchodu na Shopify automaticky odstraněna.


Další kroky