PočetnaDokumentacija

Shopify Integration

Dodajte ChatReact AI chatbote, kontakt obrasce i FAQ akordeone u svoju Shopify trgovinu pomoću službene ChatReact Shopify aplikacije.

Instalacija

  1. Instalirajte ChatReact aplikaciju iz Shopify App Storea
  2. Otvorite aplikaciju u svom Shopify administratorskom panelu

Nije potrebna zasebna veza računa — povežete aplikaciju s vašim chatbotovima i obrascima lijepljenjem njihovih ID-eva iz ChatReact nadzorne ploče.

Značajke

Shopify aplikacija nudi tri tipa widgeta:

WidgetOpisPozicioniranje
Chat WidgetAI chatbot s podrškom za live chatNa cijelom sajtu ili na određenim stranicama putem App Embed
Form WidgetKontakt obrasci sa zaštitom od spamaInline putem App Block u Theme Editoru
FAQ WidgetFAQ prikaz u obliku akordeonaInline putem App Block u Theme Editoru

Postavljanje Chat Widgeta

Postavljanje chat widgeta zahtijeva dva koraka: kreirajte dodjelu widgeta u ChatReact aplikaciji, zatim omogućite App Embed u vašoj temi.

Korak 1: Kreirajte dodjelu widgeta

  1. Otvorite ChatReact aplikaciju u svom Shopify adminu
  2. Na kartici Chat Widget, kliknite Add Assignment
  3. Unesite svoj ID chatbota (pronađen na ChatReact nadzornoj ploči na kartici Ugradnja vašeg chatbota)
  4. Kliknite Save Assignment

Korak 2: Omogućite App Embed

  1. Idite na Online Store → Themes → Edit theme
  2. Kliknite ikonu App embeds (komad slagalice) u donjem lijevom bočnom izborniku
  3. Prebaci na ON pored ChatReact Chat Widget
  4. Kliknite Save

Potrebno je omogućiti App Embed samo jednom. Nakon toga upravljate pojavom widgeta isključivo iz ChatReact aplikacije.

Chat widget će se pojavljivati na svakoj stranici obuhvaćenoj jednom od vaših dodjela widgeta.

Widget Assignments

Svaka dodjela povezuje chatbota s vašom trgovinom. Postoje dvije vrste dodjela:

  • Everywhere: Widget se pojavljuje na svim stranicama (zadano). Opcionalno možete dodati Exclude URLs — jedan put po retku, s podrškom za * džokere (npr. /blogs/*)
  • Specific Page: Widget se pojavljuje samo na putanji stranice koju unesete (npr. /pages/about)

Ako stranica ima vlastitu Specific Page dodjelu, tada se na toj stranici prikazuje taj chatbot umjesto Everywhere chatbota.

Dodavanje Form i FAQ widgeta

Form i FAQ widgeti se dodaju kao App Blocks u Theme Editoru:

  1. Idite na Online Store → Themes → Edit theme
  2. Navigirajte do stranice na kojoj želite widget
  3. Kliknite Add block i potražite "ChatReact"
  4. Odaberite ChatReact Form ili ChatReact FAQ
  5. Unesite Form ID ili Chatbot ID u postavkama bloka

Ručno umetanje (Liquid)

Ako radije uređujete predloške izravno, također možete dodati widgete u bilo koji Liquid predložak:

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

Stiliziranje Form Widgeta

Prilagodite izgled obrasca u Theme Editoru:

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

Stiliziranje FAQ Widgeta

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

Upravljanje widgetima

ChatReact aplikacija u vašem Shopify adminu pruža tri kartice:

  1. Chat Widget — Kreirajte i upravljajte dodjelama widgeta koje kontroliraju koje stranice prikazuju chat widget
  2. Obrasci — Korak-po-korak upute za ugradnju, manualni Liquid snippet i gdje pronaći svoj Form ID
  3. FAQ Widget — Upute za ugradnju FAQ widgeta i gdje pronaći svoj Chatbot ID

Odabir Form i FAQ-a vrši se u Theme Editoru: unesite Form ID ili Chatbot ID u postavkama bloka.

Podrška za jezike

Aplikacija podržava svih 24 jezika EU:

  • chat widget automatski detektira jezik preglednika svakog posjetitelja i usklađuje ga s jezicima koje vaš chatbot podržava, a u suprotnom se vraća na primarni jezik chatbota
  • Form i FAQ blokovi svaki imaju svoju Jezik postavku u Theme Editoru — zadano je Auto-detect i može se nadjačati za svaki blok posebno

Deinstalacija

Kada deinstalirate ChatReact aplikaciju, sve konfiguracije widgeta i pohranjeni podaci automatski se uklanjaju iz vaše Shopify trgovine.


Sljedeći koraci