PočetnaDokumentacija

Integracija sa Shopify

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

Instalacija

  1. Instalirajte ChatReact aplikaciju iz Shopify App Store
  2. Otvorite aplikaciju u svom Shopify administratorskom sučelju

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

Značajke

Shopify aplikacija pruža tri vrste widgeta:

WidgetOpisPoložaj
Chat WidgetAI chatbot s podrškom za live chatNa cijeloj stranici 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 administracijskom sučelju
  2. Na kartici Chat Widget kliknite Add Assignment
  3. Unesite vaš Chatbot ID (nalazi se u ChatReact nadzornoj ploči pod Settings → Embed)
  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 ChatReact Chat Widget na ON
  4. Kliknite Save

App Embed trebate omogućiti samo jednom. Nakon toga upravljate time gdje se widget prikazuje isključivo iz ChatReact aplikacije.

Chat widget se pojavljuje na svakoj stranici koju pokriva jedna od vaših dodjela widgeta.

Dodjele widgeta

Svaka dodjela povezuje chatbota s vašom trgovinom. Postoje dva tipa dodjela:

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

Ako stranica ima svoju Specific Page dodjelu, taj chatbot se prikazuje tamo umjesto Everywhere chatbota.

Dodavanje Form i FAQ widgeta

Form i FAQ widgeti dodaju se 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 ugrađivanje (Liquid)

Ako radije uređujete predloške izravno, widgete možete dodati i 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
LanguageAuto-detect (zadano) ili jedan od 24 jezika

Stiliziranje FAQ Widgeta

SettingOptions
CategoriesOpcionalne zarezom razdvojene kategorije slug-ova (npr. general,pricing) za prikaz samo odabranih FAQ kategorija
Font Size12–28px
Margin Bottom0–120px
LanguageAuto-detect (zadano) ili jedan od 24 jezika

Upravljanje widgetima

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

  1. Chat Widget — Kreirajte i upravljajte dodjelama widgeta koje kontroliraju na kojim se stranicama prikazuje chat widget
  2. Forms — Upute korak-po-korak za ugradnju, ručni Liquid isječak i mjesto gdje pronaći vaš Form ID
  3. FAQ Widget — Upute za ugradnju FAQ widgeta i mjesto gdje pronaći vaš Chatbot ID

Odabir Form i FAQ događa se u Theme Editoru: unesite Form ID ili Chatbot ID u postavkama bloka.

Podrška jezika

Aplikacija podržava svih 24 jezika EU:

  • chat widget automatski detektira jezik preglednika svakog posjetitelja i usklađuje ga s jezicima koje podržava vaš chatbot, pri čemu se koristi primarni jezik chatbota kao zamjena
  • Form i FAQ blokovi svaki imaju svoju postavku Language u Theme Editoru — zadano je Auto-detect i može se nadjačati po bloku

Deinstalacija

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


Sljedeći koraci