HomeDocumentazione

Shopify Integration

Aggiunga i chatbot AI ChatReact, i form di contatto e gli accordion FAQ al suo store Shopify con l'app ufficiale ChatReact per Shopify.

Installation

  1. Installi l'app ChatReact dallo Shopify App Store
  2. Apra l'app nel pannello di amministrazione di Shopify

Non è necessaria una connessione separata all'account — colleghi l'app ai suoi chatbot e form incollando i loro ID dalla dashboard di ChatReact.

Features

L'app per Shopify offre tre tipi di widget:

WidgetDescriptionPlacement
Chat WidgetAI chatbot con supporto live chatSite-wide o pagine specifiche tramite App Embed
Form WidgetForm di contatto con protezione anti-spamInline tramite App Block nell'Editor del Tema
FAQ WidgetVisualizzazione FAQ a fisarmonicaInline tramite App Block nell'Editor del Tema

Setting Up the Chat Widget

La configurazione del chat widget richiede due passaggi: creare un'assegnazione del widget nell'app ChatReact, quindi abilitare l'App Embed nel suo tema.

Step 1: Create a Widget Assignment

  1. Apra l'app ChatReact nel suo admin di Shopify
  2. Nella scheda Chat Widget, clicchi Add Assignment
  3. Inserisca il suo ID chatbot (trovato nella dashboard di ChatReact nella scheda Incorpora del suo chatbot)
  4. Clicchi Save Assignment

Step 2: Enable the App Embed

  1. Vada a Online Store → Themes → Edit theme
  2. Clicchi l'icona App embeds (pezzo di puzzle) nella barra laterale in basso a sinistra
  3. Attivi ChatReact Chat Widget su ON
  4. Clicchi Save

Deve abilitare l'App Embed una sola volta. Successivamente, gestirà interamente dall'app ChatReact dove il widget viene mostrato.

Il chat widget appare in ogni pagina coperta da una delle sue assegnazioni del widget.

Widget Assignments

Ogni assegnazione collega un chatbot al suo storefront. Ci sono due tipi di assegnazione:

  • Everywhere: Il widget appare su tutte le pagine (predefinito). Può opzionalmente aggiungere Exclude URLs — un percorso per riga, con supporto per i caratteri jolly * (es. /blogs/*)
  • Specific Page: Il widget appare solo sul percorso di pagina che inserisce (es. /pages/about)

Se una pagina ha una propria assegnazione Specific Page, il chatbot relativo viene mostrato lì invece del chatbot Everywhere.

Adding Form and FAQ Widgets

I widget Form e FAQ si aggiungono come App Blocks nell'Editor del Tema:

  1. Vada a Online Store → Themes → Edit theme
  2. Naviga nella pagina in cui desidera inserire il widget
  3. Clicchi Add block e cerchi "ChatReact"
  4. Scegli ChatReact Form o ChatReact FAQ
  5. Inserisca l'ID del Form o l'ID del Chatbot nelle impostazioni del blocco

Manual Embed (Liquid)

Se preferisce modificare i template direttamente, può anche aggiungere i widget a qualsiasi 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

Personalizzi l'aspetto del form nell'Editor del Tema:

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

FAQ Widget Styling

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

Managing Widgets

L'app ChatReact nel suo admin di Shopify fornisce tre schede:

  1. Chat Widget — Crei e gestisca le assegnazioni del widget che controllano in quali pagine appare il chat widget
  2. Moduli — Istruzioni passo-passo per l'embedding, lo snippet Liquid manuale e dove trovare il suo Form ID
  3. FAQ Widget — Istruzioni per l'embedding del widget FAQ e dove trovare il suo Chatbot ID

La selezione di Form e FAQ avviene nell'Editor del Tema: inserisca l'ID del Form o dell'Chatbot nelle impostazioni del blocco.

Language Support

L'app supporta tutte le 24 lingue UE:

  • Il chat widget rileva automaticamente la lingua del browser di ciascun visitatore e la confronta con le lingue supportate dal suo chatbot, ricadendo alla lingua primaria del chatbot se non ci sono corrispondenze
  • I blocchi Form e FAQ hanno ciascuno la propria impostazione Lingua nell'Editor del Tema — è impostata su Auto-detect per impostazione predefinita e può essere sovrascritta per blocco

Uninstalling

Quando disinstalla l'app ChatReact, tutte le configurazioni dei widget e i dati memorizzati vengono automaticamente rimossi dal suo store Shopify.


Next Steps