Shopify Integration
Dodaj chatboty AI ChatReact, formularze kontaktowe i akordeony FAQ do swojego sklepu Shopify za pomocą oficjalnej aplikacji ChatReact dla Shopify.
Installation
- Zainstaluj aplikację ChatReact ze Shopify App Store
- 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:
| Widget | Description | Placement |
|---|---|---|
| Chat Widget | AI chatbot z obsługą live chat | Na całej witrynie lub na wybranych stronach poprzez App Embed |
| Form Widget | Formularze kontaktowe z ochroną przed spamem | Wstawiane inline poprzez App Block w Theme Editor |
| FAQ Widget | Wyświetlanie FAQ w stylu akordeonu | Wstawiane 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
- Otwórz aplikację ChatReact w panelu administracyjnym Shopify
- Na karcie Chat Widget kliknij Add Assignment
- Wprowadź swój ID chatbota (znajdziesz go na karcie Osadź chatbota w panelu ChatReact)
- Kliknij Save Assignment
Step 2: Enable the App Embed
- Przejdź do Online Store → Themes → Edit theme
- Kliknij ikonę App embeds (klocka puzzli) w dolno-lewym pasku bocznym
- Przełącz ChatReact Chat Widget na ON
- 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:
- Przejdź do Online Store → Themes → Edit theme
- Przejdź do strony, na której chcesz umieścić widżet
- Kliknij Add block i wyszukaj "ChatReact"
- Wybierz ChatReact Form lub ChatReact FAQ
- 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:
| Setting | Options |
|---|---|
| Alignment | Left, Center, Right |
| Max Width | 200–1200px |
| Font Size | 12–28px |
| Margin Bottom | 0–120px |
| Język | Auto-detect (default) or one of 24 languages |
FAQ Widget Styling
| Setting | Options |
|---|---|
| Kategorie | Optional comma-separated category slugs (e.g. general,pricing) to show only selected FAQ categories |
| Font Size | 12–28px |
| Margin Bottom | 0–120px |
| Język | Auto-detect (default) or one of 24 languages |
Managing Widgets
Aplikacja ChatReact w panelu administracyjnym Shopify udostępnia trzy karty:
- Chat Widget — Twórz i zarządzaj przypisaniami widżetów, które kontrolują, na których stronach wyświetlany jest widżet czatu
- Formularze — Instrukcje krok po kroku dotyczące osadzania, ręczny fragment Liquid oraz miejsce, gdzie znaleźć Form ID
- 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.