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
- Installi l'app ChatReact dallo Shopify App Store
- 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:
| Widget | Description | Placement |
|---|---|---|
| Chat Widget | AI chatbot con supporto live chat | Site-wide o pagine specifiche tramite App Embed |
| Form Widget | Form di contatto con protezione anti-spam | Inline tramite App Block nell'Editor del Tema |
| FAQ Widget | Visualizzazione FAQ a fisarmonica | Inline 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
- Apra l'app ChatReact nel suo admin di Shopify
- Nella scheda Chat Widget, clicchi Add Assignment
- Inserisca il suo ID chatbot (trovato nella dashboard di ChatReact nella scheda Incorpora del suo chatbot)
- Clicchi Save Assignment
Step 2: Enable the App Embed
- Vada a Online Store → Themes → Edit theme
- Clicchi l'icona App embeds (pezzo di puzzle) nella barra laterale in basso a sinistra
- Attivi ChatReact Chat Widget su ON
- 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:
- Vada a Online Store → Themes → Edit theme
- Naviga nella pagina in cui desidera inserire il widget
- Clicchi Add block e cerchi "ChatReact"
- Scegli ChatReact Form o ChatReact FAQ
- 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:
| Setting | Options |
|---|---|
| Alignment | Left, Center, Right |
| Max Width | 200–1200px |
| Font Size | 12–28px |
| Margin Bottom | 0–120px |
| Lingua | Auto-detect (default) or one of 24 languages |
FAQ Widget Styling
| Setting | Options |
|---|---|
| Categorie | Optional comma-separated category slugs (e.g. general,pricing) to show only selected FAQ categories |
| Font Size | 12–28px |
| Margin Bottom | 0–120px |
| Lingua | Auto-detect (default) or one of 24 languages |
Managing Widgets
L'app ChatReact nel suo admin di Shopify fornisce tre schede:
- Chat Widget — Crei e gestisca le assegnazioni del widget che controllano in quali pagine appare il chat widget
- Moduli — Istruzioni passo-passo per l'embedding, lo snippet Liquid manuale e dove trovare il suo Form ID
- 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.