AcasăDocumentație

Shopify Integration

Adăugați chatboți AI ChatReact, formulare de contact și acordeoane FAQ în magazinul dumneavoastră Shopify cu aplicația oficială ChatReact pentru Shopify.

Installation

  1. Instalați aplicația ChatReact din Shopify App Store
  2. Deschideți aplicația în panoul de administrare Shopify

Nu este necesară o conectare separată de cont — asociați aplicația cu chatboții și formularele prin inserarea ID-urilor acestora din dashboard-ul ChatReact.

Features

Aplicația Shopify oferă trei tipuri de widgeturi:

WidgetDescriptionPlacement
Chat WidgetAI chatbot cu suport de live chatLa nivel de site sau pagini specifice prin App Embed
Form WidgetFormulare de contact cu protecție anti-spamInline prin App Block în Theme Editor
FAQ WidgetAfișare FAQ în stil acordeonInline prin App Block în Theme Editor

Setting Up the Chat Widget

Configurarea widgetului de chat se face în doi pași: creați o atribuție de widget în aplicația ChatReact, apoi activați App Embed în tema dumneavoastră.

Step 1: Create a Widget Assignment

  1. Deschideți aplicația ChatReact în panoul de administrare Shopify
  2. În fila Chat Widget, faceți clic pe Add Assignment
  3. Introduceți ID chatbot (găsit în dashboard-ul ChatReact pe fila Încorporare a chatbotului dumneavoastră)
  4. Faceți clic pe Save Assignment

Step 2: Enable the App Embed

  1. Mergeți la Online Store → Themes → Edit theme
  2. Faceți clic pe pictograma App embeds (piesă de puzzle) din bara laterală din stânga jos
  3. Activați comutatorul ChatReact Chat Widget la ON
  4. Faceți clic pe Save

Trebuie să activați App Embed o singură dată. După aceea, gestionați complet unde apare widgetul din aplicația ChatReact.

Widgetul de chat apare pe fiecare pagină acoperită de una dintre atribuțiile dumneavoastră de widget.

Widget Assignments

Fiecare atribuție leagă un chatbot de vitrina dumneavoastră. Există două tipuri de atribuții:

  • Everywhere: Widgetul apare pe toate paginile (implicit). Opțional puteți adăuga Exclude URLs — câte o cale per linie, cu wildcard-uri * suportate (de ex. /blogs/*)
  • Specific Page: Widgetul apare doar pe calea paginii pe care o introduceți (de ex. /pages/about)

Dacă o pagină are propria atribuție Specific Page, acel chatbot este afișat acolo în locul chatbotului Everywhere.

Adding Form and FAQ Widgets

Widgeturile Form și FAQ se adaugă ca App Blocks în Theme Editor:

  1. Mergeți la Online Store → Themes → Edit theme
  2. Navigați la pagina unde doriți widgetul
  3. Faceți clic pe Add block și căutați „ChatReact"
  4. Alegeți ChatReact Form sau ChatReact FAQ
  5. Introduceți Form ID sau Chatbot ID în setările blocului

Manual Embed (Liquid)

Dacă preferați să editați șabloanele direct, puteți de asemenea să adăugați widgeturile în orice șablon 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

Personalizați aspectul formularului în Theme Editor:

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

FAQ Widget Styling

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

Managing Widgets

Aplicația ChatReact din panoul dumneavoastră Shopify oferă trei file:

  1. Chat Widget — Creați și gestionați atribuțiile de widget care controlează ce pagini afișează widgetul de chat
  2. Formulare — Instrucțiuni pas cu pas pentru embedding, fragmentul Liquid manual și unde găsiți Form ID
  3. FAQ Widget — Instrucțiuni de embedding pentru widgetul FAQ și unde găsiți Chatbot ID

Selectarea formularului și FAQ se face în Theme Editor: introduceți Form ID sau Chatbot ID în setările blocului.

Language Support

Aplicația suportă toate cele 24 de limbi UE:

  • chat widget detectează automat limba browserului fiecărui vizitator și o potrivește cu limbile suportate de chatbot, revenind la limba principală a chatbotului dacă este necesar
  • Blocurile Form și FAQ au fiecare propria setare Limbă în Theme Editor — setarea implicită este Auto-detect și poate fi suprascrisă pentru fiecare bloc

Uninstalling

Când dezinstalați aplicația ChatReact, toate configurațiile widgeturilor și datele stocate sunt curățate automat din magazinul dumneavoastră Shopify.


Next Steps