Paġna ewlenijaDokumentazzjoni

Shopify Integration

Żid chatbots AI ta’ ChatReact, formoli ta’ kuntatt, u akkordeons FAQ ma' ħanut Shopify tiegħek bl-App uffiċjali ChatReact għal Shopify.

Installation

  1. Installa l-app ChatReact mill-Shopify App Store
  2. Iftaħ l-app fil-panel amministrattiv ta' Shopify tiegħek

Ma hemm bżonn l-ebda konnessjoni separata tal-kont — torbot l-app mal-chatbots u l-formoli tiegħek billi tippjega l-IDs tagħhom mill-dashboard ta' ChatReact.

Features

L-app ta' Shopify tipprovdi tliet tipi ta' widget:

WidgetDescriptionPlacement
Chat WidgetAI chatbot b'appoġġ ta' live chatFuq iż-żona kollha tal-websajt jew paġni speċifiċi permezz ta' App Embed
Form WidgetFormoli ta' kuntatt b'protezzjoni kontra spamInline permezz ta' App Block fil-Theme Editor
FAQ WidgetWirja FAQ b'stil akkordeonInline permezz ta' App Block fil-Theme Editor

Setting Up the Chat Widget

Is-settjar tal-chat widget jieħu żewġ passi: oħloq assenjament tal-widget fl-app ChatReact, imbagħad iġġib l-App Embed fl-attiv fl-theme tiegħek.

Step 1: Create a Widget Assignment

  1. Iftaħ l-app ChatReact fil-admin ta' Shopify tiegħek
  2. Fit-tab Chat Widget, ikklikkja Add Assignment
  3. Daħħal il-ID tal-chatbot tiegħek (misjuba fid-dashboard ta' ChatReact fit-tab Embed tal-chatbot tiegħek)
  4. Ikklikkja Save Assignment

Step 2: Enable the App Embed

  1. Mur f'Online Store → Themes → Edit theme
  2. Ikklikkja l-ikona App embeds (bi tqassim puzzle) fil-sidebar fuq in-naħa tax-xellug ta' isfel
  3. Agħżel ChatReact Chat Widget biex ikun ON
  4. Ikklikkja Save

Għandek bżonn tgħaffeġ l-App Embed darba biss. Wara dan, timmaniġġja fejn jidher il-widget kompletament mill-app ChatReact.

Il-chat widget jidher fuq kull paġna koperta minn wieħed mill-assenjamenti tal-widget tiegħek.

Widget Assignments

Kull assenjament jgħaqqad chatbot mas-sit tal-bejgħ tiegħek. Hemm żewġ tipi ta' assenjamenti:

  • Everywhere: Il-widget jidher fuq il-paġni kollha (default). Tista' b'mod fakultattiv iżżid Exclude URLs — wieħed path għal kull linja, bil-wildcards * magħrufa (eż. /blogs/*)
  • Specific Page: Il-widget jidher biss fuq il-path tal-paġna li tidħol (eż. /pages/about)

Jekk paġna għandha assenjament Specific Page tagħha, dak il-chatbot juri hemmhekk minflok il-chatbot tal-Everywhere.

Adding Form and FAQ Widgets

Il-form u l-FAQ widgets jiġu miżjuda bħala App Blocks fil-Theme Editor:

  1. Mur f'Online Store → Themes → Edit theme
  2. Naviga għall-paġna fejn trid il-widget
  3. Ikklikkja Add block u fittex "ChatReact"
  4. Agħżel ChatReact Form jew ChatReact FAQ
  5. Daħħal il-Form ID jew il-Chatbot ID fl-issettjar tal-block

Manual Embed (Liquid)

Jekk tippreferi teditja t-templejts direttament, tista' wkoll iżżid il-widgets ma' kwalunkwe template 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

Aġġusta l-apparenza tal-form fil-Theme Editor:

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

FAQ Widget Styling

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

Managing Widgets

L-app ChatReact fil-admin ta' Shopify tiegħek tipprovdi tliet tabs:

  1. Chat Widget — Oħloq u immaniġġja l-assenjamenti tal-widget li jikkontrollaw liema paġni juru l-chat widget
  2. Formoli — Istruzzjonijiet pass b'pass għall-embed, is-snippet Liquid manuali, u fejn issib il-Form ID tiegħek
  3. FAQ Widget — Istruzzjonijiet tal-embed għall-FAQ widget u fejn issib il-Chatbot ID tiegħek

Is-selezjoni tal-form u tal-FAQ tkun fil-Theme Editor: daħħal il-Form ID jew il-Chatbot ID fl-issettjar tal-block.

Language Support

L-app tappoġġja l-24 lingwa tal-UE:

  • Il-chat widget jiddetekta awtomatikament il-lingwa tal-browser ta' kull viżitatur u jaqbelha mal-lingwi appoġġjati mill-chatbot tiegħek, u jħalli fall-back għall-lingwa primarja tal-chatbot
  • Il-Form and FAQ blocks għandhom is-setting Lingwa tagħhom fil-Theme Editor — default huwa Auto-detect u jista' jiġi mħassar kull blok

Uninstalling

Meta tneħħi l-app ChatReact, il-konfigurazzjonijiet kollha tal-widget u d-dejta maħżuna jiġu nnettejati awtomatikament mis-shopify store tiegħek.


Next Steps