AccueilDocumentation

Shopify Integration

Ajoutez les chatbots IA ChatReact, les formulaires de contact et les accordéons FAQ à votre boutique Shopify avec l'application officielle ChatReact pour Shopify.

Installation

  1. Installez l'application ChatReact depuis le Shopify App Store
  2. Ouvrez l'application dans votre panneau d'administration Shopify

Aucune connexion de compte séparée n'est nécessaire — vous liez l'application à vos chatbots et formulaires en collant leurs identifiants depuis le tableau de bord ChatReact.

Fonctionnalités

L'application Shopify fournit trois types de widgets :

WidgetDescriptionPlacement
Chat WidgetChatbot IA avec support de chat en directSur l'ensemble du site ou sur des pages spécifiques via App Embed
Form WidgetFormulaires de contact avec protection anti-spamInline via App Block dans le Theme Editor
FAQ WidgetAffichage FAQ en accordéonInline via App Block dans le Theme Editor

Configuration du Chat Widget

La configuration du chat widget se fait en deux étapes : créez une affectation de widget dans l'application ChatReact, puis activez l'App Embed dans votre thème.

Étape 1 : Créer une affectation de widget

  1. Ouvrez l'application ChatReact dans votre administration Shopify
  2. Dans l'onglet Chat Widget, cliquez sur Add Assignment
  3. Entrez votre ID du chatbot (trouvée dans le tableau de bord ChatReact onglet Intégration de votre chatbot)
  4. Cliquez sur Save Assignment

Étape 2 : Activer l'App Embed

  1. Allez dans Online Store → Themes → Edit theme
  2. Cliquez sur l'icône App embeds (pièce de puzzle) dans la barre latérale en bas à gauche
  3. Basculez ChatReact Chat Widget sur ON
  4. Cliquez Enregistrer

Vous n'avez besoin d'activer l'App Embed qu'une seule fois. Après cela, vous gérez entièrement l'emplacement du widget depuis l'application ChatReact.

Le chat widget apparaît sur chaque page couverte par l'une de vos affectations de widget.

Affectations de widget

Chaque affectation lie un chatbot à votre vitrine. Il existe deux types d'affectation :

  • Everywhere : le widget apparaît sur toutes les pages (par défaut). Vous pouvez éventuellement ajouter des Exclude URLs — un chemin par ligne, avec des jokers * pris en charge (par ex. /blogs/*)
  • Specific Page : le widget n'apparaît que sur le chemin de la page que vous saisissez (par ex. /pages/about)

Si une page dispose de sa propre affectation Specific Page, ce chatbot y est affiché au lieu du chatbot Everywhere.

Ajout des widgets Form et FAQ

Les widgets Form et FAQ sont ajoutés en tant que App Blocks dans le Theme Editor :

  1. Allez dans Online Store → Themes → Edit theme
  2. Naviguez vers la page où vous souhaitez placer le widget
  3. Cliquez sur Add block et recherchez « ChatReact »
  4. Choisissez ChatReact Form ou ChatReact FAQ
  5. Saisissez l'ID du formulaire ou l'ID du chatbot dans les paramètres du bloc

Intégration manuelle (Liquid)

Si vous préférez modifier directement les modèles, vous pouvez également ajouter les widgets à tout 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>

Style du Form Widget

Personnalisez l'apparence du formulaire dans le Theme Editor :

SettingOptions
AlignmentLeft, Center, Right
Max Width200–1200px
Font Size12–28px
Margin Bottom0–120px
LangueDétection automatique (par défaut) ou une des 24 langues

Style du FAQ Widget

SettingOptions
CatégoriesSlugs de catégories optionnels séparés par des virgules (par ex. general,pricing) pour n'afficher que les catégories FAQ sélectionnées
Font Size12–28px
Margin Bottom0–120px
LangueDétection automatique (par défaut) ou une des 24 langues

Gestion des widgets

L'application ChatReact dans votre administration Shopify propose trois onglets :

  1. Chat Widget — Créez et gérez les affectations de widget qui contrôlent les pages affichant le chat widget
  2. Formulaires — Instructions d'intégration pas à pas, le snippet Liquid manuel, et où trouver votre Form ID
  3. FAQ Widget — Instructions d'intégration pour le widget FAQ et où trouver votre Chatbot ID

La sélection des Form et FAQ se fait dans le Theme Editor : saisissez l'ID du formulaire ou l'ID du chatbot dans les paramètres du bloc.

Support linguistique

L'application prend en charge les 24 langues de l'UE :

  • Le chat widget détecte automatiquement la langue du navigateur de chaque visiteur et la compare aux langues prises en charge par votre chatbot, avec repli sur la langue principale du chatbot
  • Les blocs Form et FAQ disposent chacun de leur propre paramètre Langue dans le Theme Editor — il est réglé par défaut sur Auto-detect et peut être remplacé par bloc

Désinstallation

Lorsque vous désinstallez l'application ChatReact, toutes les configurations de widgets et les données stockées sont automatiquement supprimées de votre boutique Shopify.


Étapes suivantes