Strona głównaDokumentacja

Shopify Integration

Dodaj chatboty AI ChatReact, formularze kontaktowe i akordeony FAQ do swojego sklepu Shopify za pomocą oficjalnej aplikacji ChatReact dla Shopify.

Installation

  1. Zainstaluj aplikację ChatReact ze Shopify App Store
  2. Otwórz aplikację w panelu administracyjnym Shopify

Nie jest wymagane oddzielne połączenie konta — powiąż aplikację ze swoimi chatbotami i formularzami, wklejając ich identyfikatory z pulpitu ChatReact.

Features

Aplikacja Shopify udostępnia trzy typy widżetów:

WidgetDescriptionPlacement
Chat WidgetAI chatbot z obsługą live chatNa całej witrynie lub na wybranych stronach poprzez App Embed
Form WidgetFormularze kontaktowe z ochroną przed spamemWstawiane inline poprzez App Block w Theme Editor
FAQ WidgetWyświetlanie FAQ w stylu akordeonuWstawiane inline poprzez App Block w Theme Editor

Setting Up the Chat Widget

Konfiguracja widżetu czatu wymaga dwóch kroków: utworzenia przypisania widżetu w aplikacji ChatReact, a następnie włączenia App Embed w motywie.

Step 1: Create a Widget Assignment

  1. Otwórz aplikację ChatReact w panelu administracyjnym Shopify
  2. Na karcie Chat Widget kliknij Add Assignment
  3. Wprowadź swój ID chatbota (znajdziesz go na karcie Osadź chatbota w panelu ChatReact)
  4. Kliknij Save Assignment

Step 2: Enable the App Embed

  1. Przejdź do Online Store → Themes → Edit theme
  2. Kliknij ikonę App embeds (klocka puzzli) w dolno-lewym pasku bocznym
  3. Przełącz ChatReact Chat Widget na ON
  4. Kliknij Save

App Embed trzeba włączyć tylko raz. Potem zarządzasz tym, gdzie widżet się pojawia, całkowicie z poziomu aplikacji ChatReact.

Widżet czatu pojawia się na każdej stronie objętej jednym z Twoich przypisań widżetu.

Widget Assignments

Każde przypisanie łączy chatbota z Twoim sklepem. Są dwa typy przypisań:

  • Everywhere: Widżet pojawia się na wszystkich stronach (domyślnie). Opcjonalnie można dodać Exclude URLs — jedna ścieżka na linię, z obsługą wildcardów * (np. /blogs/*)
  • Specific Page: Widżet pojawia się tylko na wprowadzonej ścieżce strony (np. /pages/about)

Jeżeli strona ma własne przypisanie Specific Page, to właśnie tam zostanie wyświetlony ten chatbot zamiast chatbota ustawionego dla Everywhere.

Adding Form and FAQ Widgets

Widżety formularza i FAQ dodaje się jako App Blocks w Theme Editor:

  1. Przejdź do Online Store → Themes → Edit theme
  2. Przejdź do strony, na której chcesz umieścić widżet
  3. Kliknij Add block i wyszukaj "ChatReact"
  4. Wybierz ChatReact Form lub ChatReact FAQ
  5. Wprowadź Form ID lub Chatbot ID w ustawieniach bloku

Manual Embed (Liquid)

Jeśli wolisz edytować szablony bezpośrednio, możesz także dodać widżety do dowolnego szablonu Liquid:

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

Form Widget Styling

Dostosuj wygląd formularza w Theme Editor:

SettingOptions
AlignmentLeft, Center, Right
Max Width200–1200px
Font Size12–28px
Margin Bottom0–120px
JęzykAuto-detect (default) or one of 24 languages

FAQ Widget Styling

SettingOptions
KategorieOptional comma-separated category slugs (e.g. general,pricing) to show only selected FAQ categories
Font Size12–28px
Margin Bottom0–120px
JęzykAuto-detect (default) or one of 24 languages

Managing Widgets

Aplikacja ChatReact w panelu administracyjnym Shopify udostępnia trzy karty:

  1. Chat Widget — Twórz i zarządzaj przypisaniami widżetów, które kontrolują, na których stronach wyświetlany jest widżet czatu
  2. Formularze — Instrukcje krok po kroku dotyczące osadzania, ręczny fragment Liquid oraz miejsce, gdzie znaleźć Form ID
  3. FAQ Widget — Instrukcje osadzania widżetu FAQ oraz miejsce, gdzie znaleźć Chatbot ID

Wybór formularza i FAQ odbywa się w Theme Editor: wpisz Form ID lub Chatbot ID w ustawieniach bloku.

Language Support

Aplikacja obsługuje wszystkie 24 języki UE:

  • chat widget automatycznie wykrywa język przeglądarki każdego odwiedzającego i dopasowuje go do obsługiwanych języków chatbota, w razie potrzeby wracając do języka podstawowego chatbota
  • Form and FAQ blocks mają własne ustawienie Język w Theme Editor — domyślnie ustawione na Auto-detect i można je nadpisać dla każdego bloku

Uninstalling

Po odinstalowaniu aplikacji ChatReact wszystkie konfiguracje widżetów oraz przechowywane dane są automatycznie usuwane z Twojego sklepu Shopify.


Next Steps