KezdőlapDokumentáció

Shopify Integration

Adjon ChatReact AI chatbotokat, kapcsolatfelvételi űrlapokat és GYIK akordeonokat Shopify áruházához az hivatalos ChatReact Shopify alkalmazással.

Installation

  1. Telepítse a ChatReact alkalmazást a Shopify App Store-ból
  2. Nyissa meg az alkalmazást a Shopify admin paneljén

Nincs szükség külön fiókkapcsolatra — az alkalmazást a ChatReact irányítópultjáról bemásolt azonosítókkal (ID) köti össze a chatbotokkal és űrlapokkal.

Features

A Shopify alkalmazás három widgettípust biztosít:

WidgetDescriptionPlacement
Chat WidgetAI chatbot élő chat támogatássalSite-wide or specific pages via App Embed
Form WidgetKapcsolatfelvételi űrlapok spamvédelemmelInline via App Block in Theme Editor
FAQ WidgetAkordeon stílusú GYIK megjelenítésInline via App Block in Theme Editor

Setting Up the Chat Widget

A chat widget beállítása két lépésből áll: hozzon létre egy widget-hozzárendelést a ChatReact alkalmazásban, majd engedélyezze az App Embedet a témában.

Step 1: Create a Widget Assignment

  1. Nyissa meg a ChatReact alkalmazást a Shopify adminban
  2. A Chat Widget lapon kattintson az Add Assignment gombra
  3. Adja meg a Chatbot azonosító értékét (a ChatReact irányítópultján, a chatbot Beágyazás lapján található)
  4. Kattintson a Save Assignment gombra

Step 2: Enable the App Embed

  1. Menjen a Online Store → Themes → Edit theme menüponthoz
  2. Kattintson az App embeds ikonra (kirakós darab) a bal alsó oldalsávban
  3. Kapcsolja a ChatReact Chat Widget opciót ON állásba
  4. Kattintson Save

Az App Embedet csak egyszer kell engedélyeznie. Ezután teljes egészében a ChatReact alkalmazásban kezelheti, hogy hol jelenjen meg a widget.

A chat widget minden olyan oldalon megjelenik, amelyet valamelyik widget-hozzárendelés lefed.

Widget Assignments

Minden hozzárendelés egy chatbotot kapcsol az áruházhoz. Két hozzárendeléstípus létezik:

  • Everywhere: A widget minden oldalon megjelenik (alapértelmezett). Opcionálisan hozzáadhat Exclude URLs listaelemeket — egy útvonal soronként, * helyettesítő karakterek támogatásával (pl. /blogs/*)
  • Specific Page: A widget csak azon az oldalon jelenik meg, amelynek az útvonalát megadja (pl. /pages/about)

Ha egy oldalhoz külön Specific Page hozzárendelés tartozik, ott az a chatbot jelenik meg az Everywhere chatbot helyett.

Adding Form and FAQ Widgets

A Form és FAQ widgeteket App Blocks-ként adhatja hozzá a Theme Editorban:

  1. Menjen a Online Store → Themes → Edit theme ponthoz
  2. Navigáljon ahhoz az oldalhoz, ahol meg szeretné jeleníteni a widgetet
  3. Kattintson az Add block gombra és keressen rá a „ChatReact” kifejezésre
  4. Válassza a ChatReact Form vagy a ChatReact FAQ opciót
  5. Adja meg az űrlapazonítót (Form ID) vagy a chatbotazonítót (Chatbot ID) a blokk beállításaiban

Manual Embed (Liquid)

Ha inkább közvetlenül a sablonokat szerkeszti, a widgeteket bármely Liquid sablonhoz hozzáadhatja:

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

Testreszabhatja az űrlap megjelenését a Theme Editorban:

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

FAQ Widget Styling

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

Managing Widgets

A ChatReact alkalmazás a Shopify adminban három fület biztosít:

  1. Chat Widget — Hozza létre és kezelje azokat a widget-hozzárendeléseket, amelyek szabályozzák, hogy mely oldalak mutassák a chat widgetet
  2. Űrlapok — Lépésről lépésre szóló beágyazási útmutatók, a kézi Liquid kódrészlet és az, hogy hol találja a Form ID-t
  3. FAQ Widget — A GYIK widget beágyazási útmutatója és hogy hol találja a Chatbot ID-t

A Form és FAQ kiválasztása a Theme Editorban történik: adja meg az űrlapazonítót vagy a chatbotazonítót a blokk beállításaiban.

Language Support

Az alkalmazás az összes 24 EU nyelvet támogatja:

  • A chat widget automatikusan felismeri a látogató böngészőjének nyelvét és összeveti azt a chatbot által támogatott nyelvekkel, szükség esetén a chatbot elsődleges nyelvére esik vissza
  • A Form és FAQ blokkoknak külön Nyelv beállítása van a Theme Editorban — alapértelmezés szerint Auto-detect, és blokk szinten felülírható

Uninstalling

Az ChatReact alkalmazás eltávolításakor az összes widgetkonfiguráció és tárolt adat automatikusan törlődik az Ön Shopify áruházából.


Next Steps