DomovDokumentacija

Shopify Integration

Dodajte ChatReact AI klepetalnike, kontaktne obrazce in FAQ akordeone v vašo Shopify trgovino z uradno aplikacijo ChatReact za Shopify.

Installation

  1. Namestite aplikacijo ChatReact iz Shopify App Store
  2. Odprite aplikacijo v vašem Shopify administratorskem vmesniku

Povezava ločenega računa ni potrebna — aplikacijo povežete s svojimi klepetalniki in obrazci tako, da prilepite njihove ID-je iz ChatReact nadzorne plošče.

Features

Aplikacija za Shopify ponuja tri vrste vtičnikov (widgetov):

WidgetDescriptionPlacement
Chat WidgetAI klepetalnik z možnostjo live chataPo vsej strani ali na določenih straneh preko App Embed
Form WidgetKontaktni obrazci z zaščito pred spamomInline preko App Block v Theme Editorju
FAQ WidgetPrikaz pogostih vprašanj v akordeon sloguInline preko App Block v Theme Editorju

Setting Up the Chat Widget

Nastavitev chat vtičnika poteka v dveh korakih: ustvarite dodelitev vtičnika v aplikaciji ChatReact, nato omogočite App Embed v vaši temi.

Step 1: Create a Widget Assignment

  1. Odprite aplikacijo ChatReact v vašem Shopify adminu
  2. Na zavihku Chat Widget kliknite Add Assignment
  3. Vnesite vaš Chatbot ID (najdete ga na ChatReact nadzorni plošči pod Settings → Embed)
  4. Kliknite Save Assignment

Step 2: Enable the App Embed

  1. Pojdite na Online Store → Themes → Edit theme
  2. V spodnjem levem stranskem meniju kliknite ikono App embeds (puzzle kocka)
  3. Preklopite ChatReact Chat Widget na ON
  4. Kliknite Save

Omogočiti morate App Embed le enkrat. Po tem upravljate, kje se vtičnik prikazuje, izključno iz aplikacije ChatReact.

Chat vtičnik se prikaže na vseh straneh, ki jih zajema ena od vaših dodelitev vtičnika.

Widget Assignments

Vsaka dodelitev povezuje klepetalnik z vašo trgovino. Obstajata dva tipa dodelitev:

  • Everywhere: Vtičnik se prikaže na vseh straneh (privzeto). Po želji lahko dodate Exclude URLs — ena pot na vrstico, z možnostjo uporabe nadomestnega znaka * (npr. /blogs/*)
  • Specific Page: Vtičnik se prikaže samo na vneseni poti strani (npr. /pages/about)

Če ima stran svojo Specific Page dodelitev, se tam prikaže ta klepetalnik namesto Everywhere klepetalnika.

Adding Form and FAQ Widgets

Forme in FAQ vtičnike dodate kot App Blocks v Theme Editorju:

  1. Pojdite na Online Store → Themes → Edit theme
  2. Pomaknite se na stran, kjer želite vtičnik
  3. Kliknite Add block in poiščite "ChatReact"
  4. Izberite ChatReact Form ali ChatReact FAQ
  5. V nastavitvah bloka vnesite Form ID ali Chatbot ID

Manual Embed (Liquid)

Če raje urejate predloge neposredno, lahko vtičnike dodate tudi v katerokoli Liquid predlogo:

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

Prilagodite izgled obrazca v Theme Editorju:

SettingOptions
AlignmentLeft, Center, Right
Max Width200–1200px
Font Size12–28px
Margin Bottom0–120px
LanguageAuto-detect (privzeto) ali ena izmed 24 jezikov

FAQ Widget Styling

SettingOptions
CategoriesNeobvezne kategorije ločene z vejico (npr. general,pricing) za prikaz le izbranih kategorij FAQ
Font Size12–28px
Margin Bottom0–120px
LanguageAuto-detect (privzeto) ali ena izmed 24 jezikov

Managing Widgets

Aplikacija ChatReact v vašem Shopify adminu ponuja tri zavihke:

  1. Chat Widget — Ustvarjanje in upravljanje dodelitev vtičnikov, ki določajo, na katerih straneh se prikaže chat vtičnik
  2. Forms — Navodila po korakih za vgradnjo, ročni Liquid odrezek in kjer najdete svoj Form ID
  3. FAQ Widget — Navodila za vgradnjo FAQ vtičnika in kjer najdete vaš Chatbot ID

Izbira obrazcev in FAQ se opravi v Theme Editorju: v nastavitvah bloka vnesite Form ID ali Chatbot ID.

Language Support

Aplikacija podpira vseh 24 jezikov EU:

  • chat widget samodejno zazna jezik brskalnika vsakega obiskovalca in ga primerja z jeziki, ki jih podpira vaš klepetalnik; če se ne ujame, uporabi primarni jezik klepetalnika
  • Form in FAQ bloki imajo v Theme Editorju svojo lastno nastavitev Language — privzeto je Auto-detect, kar lahko za vsak blok posebej preglasite

Uninstalling

Ob odstranitvi aplikacije ChatReact se vse konfiguracije vtičnikov in shranjeni podatki avtomatsko odstranijo iz vaše Shopify trgovine.


Next Steps