Integrazione con Shopify
Aggiunga i chatbot AI di ChatReact, moduli di contatto e FAQ ad accordion al suo negozio Shopify con l'app ufficiale ChatReact per Shopify.
Installazione
- Installi l'app ChatReact dallo Shopify App Store
- Apra l'appnel pannello di amministrazione di Shopify
Non è necessaria una connessione account separata — colleghi l'app ai suoi chatbot e moduli incollandone gli ID dalla dashboard di ChatReact.
Funzionalità
L'app Shopify fornisce tre tipi di widget:
| Widget | Descrizione | Posizionamento |
|---|---|---|
| Chat Widget | Chatbot AI con supporto live chat | Su tutto il sito o pagine specifiche tramite App Embed |
| Form Widget | Moduli di contatto con protezione antispam | Inline tramite App Block nell'Editor del Tema |
| FAQ Widget | Visualizzazione FAQ a fisarmonica | Inline tramite App Block nell'Editor del Tema |
Configurazione del 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.
Passo 1: Creare un'assegnazione del widget
- Apra l'app ChatReact nel suo pannello di amministrazione Shopify
- Nella scheda Chat Widget, clicchi su Add Assignment
- Inserisca il suo Chatbot ID (trovabile nella dashboard di ChatReact sotto Settings → Embed)
- Clicchi su Save Assignment
Passo 2: Abilitare l'App Embed
- Vada su 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. Dopo di ciò, gestirà dove appare il widget interamente dall'app ChatReact.
Il chat widget appare su ogni pagina coperta da una delle sue assegnazioni del widget.
Assegnazioni dei widget
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 wildcard
*(es./blogs/*) - Specific Page: il widget appare solo sul percorso di pagina che inserisce (es.
/pages/about)
Se una pagina ha la propria assegnazione Specific Page, quel chatbot viene mostrato lì invece del chatbot Everywhere.
Aggiunta dei widget Form e FAQ
I widget Form e FAQ vengono aggiunti come App Blocks nell'Editor del Tema:
- Vada su Online Store → Themes → Edit theme
- Navighi alla pagina dove desidera il widget
- Clicchi Add block e cerchi "ChatReact"
- Scegliere ChatReact Form o ChatReact FAQ
- Inserisca il Form ID o il Chatbot ID nelle impostazioni del blocco
Embed manuale (Liquid)
Se preferisce modificare direttamente i template, 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>
Styling del Form Widget
Personalizzi l'aspetto del modulo nell'Editor del Tema:
| Setting | Options |
|---|---|
| Alignment | Left, Center, Right |
| Max Width | 200–1200px |
| Font Size | 12–28px |
| Margin Bottom | 0–120px |
| Language | Auto-detect (default) or one of 24 languages |
Styling del FAQ Widget
| Setting | Options |
|---|---|
| Categories | Opzionali, slug delle categorie separati da virgola (es. general,pricing) per mostrare solo le categorie FAQ selezionate |
| Font Size | 12–28px |
| Margin Bottom | 0–120px |
| Language | Auto-detect (default) or one of 24 languages |
Gestione dei widget
L'app ChatReact nel suo pannello di amministrazione Shopify fornisce tre schede:
- Chat Widget — Crei e gestisca le assegnazioni dei widget che controllano quali pagine mostrano il chat widget
- Forms — Istruzioni passo passo per l'embed, lo snippet manuale Liquid e dove trovare il suo Form ID
- FAQ Widget — Istruzioni per l'embed del widget FAQ e dove trovare il suo Chatbot ID
La selezione di Form e FAQ avviene nell'Editor del Tema: inserisca il Form ID o il Chatbot ID nelle impostazioni del blocco.
Supporto linguistico
L'app supporta tutte e 24 le lingue UE:
- Il chat widget rileva automaticamente la lingua del browser di ogni visitatore e la confronta con le lingue supportate dal suo chatbot, tornando alla lingua primaria del chatbot se nessuna corrisponde
- I blocchi Form e FAQ hanno ciascuno la propria impostazione Language nell'Editor del Tema — predefinita su Auto-detect e può essere sovrascritta per blocco
Disinstallazione
Quando disinstalla l'app ChatReact, tutte le configurazioni dei widget e i dati memorizzati vengono automaticamente rimossi dal suo negozio Shopify.