Comment créer un chatbot IA FlowHunt pour Shopify

Ce guide vous accompagne pour connecter FlowHunt à votre boutique Shopify, ajouter un flux de chatbot Shopify préconçu, le publier et intégrer le chatbot sur votre vitrine.

Prérequis

• Une boutique Shopify avec accès administrateur
• Un compte FlowHunt avec accès à un espace de travail : https://app.flowhunt.io/
• Important : Utilisez la même adresse e-mail pour votre compte FlowHunt et votre compte administrateur Shopify.

1) Intégrer Shopify avec FlowHunt (via Shopify App Store)

1. Ouvrez le Shopify App Store et recherchez « FlowHunt ».
2. Cliquez sur Installer et, si besoin, sélectionnez la boutique concernée.
3. Vérifiez les permissions demandées puis cliquez sur Installer l’application / Autoriser.

Après l’installation, vous serez redirigé vers Shopify et/ou FlowHunt. La connexion est créée via le processus d’installation du marketplace.

2) Installer l’application FlowHunt sur votre boutique Shopify

1. Sur l’écran d’autorisation Shopify, vérifiez les permissions demandées.
2. Cliquez sur Installer l’application pour terminer l’installation.

3) Vérifier que l’intégration Shopify est activée

Après l’installation réussie, retournez dans FlowHunt → Intégrations. Vous devriez voir Shopify marqué comme Connecté/Activé.

Si ce n’est pas le cas, cliquez à nouveau sur Connecter et suivez le processus d’autorisation.

4) Ajouter un chatbot Shopify depuis la Flow Library

1. Dans FlowHunt, rendez-vous dans la Flow Library.
2. Recherchez « Chatbot Shopify ».
3. Ouvrez le modèle et cliquez sur Ajouter à l’espace de travail.

Cela ajoutera un flux de chatbot Shopify prêt à l’emploi à votre espace de travail.

5) Personnaliser le chatbot pour votre marque

Ouvrez le flux que vous venez d’ajouter et ajustez :

• Système de prompt et ton : Définissez la voix et la ligne éditoriale de votre marque.
• Sources de connaissances : Connectez votre catalogue produits, FAQ, politiques ou autres documents.
• Outils et actions : Activez éventuellement la recherche de commandes, le suivi de statut ou la mise à jour CRM si votre offre et configuration le permettent.
• UI/branding : Configurez le nom du widget, le message d’accueil et tous les libellés visibles plus tard dans la section Chatbots.

Lorsque c’est terminé, enregistrez vos modifications.

6) Publier le flux

Cliquez sur Publier sur le flux pour qu’il soit disponible à l’utilisation par un chatbot sur votre site/vitrine.

7) Créer un nouveau Code d’Intégration (Chatbot)

1. Allez dans Chatbots sur FlowHunt.
2. Cliquez sur Nouveau code d’intégration.
3. Sélectionnez le flux publié que vous avez créé ci-dessus.
4. Configurez les options du widget (thème, position, comportement à l’ouverture, langue, liste blanche de domaines, etc.).
5. Enregistrez. FlowHunt générera un extrait de script (votre code d’intégration).

Gardez cet extrait sous la main — vous le collerez dans votre thème Shopify à l’étape suivante.

8) Intégrer le chatbot sur votre vitrine Shopify

Vous pouvez ajouter le code d’intégration de deux manières. Choisissez l’option qui correspond le mieux à vos besoins.

Option A — Ajouter dans theme.liquid (site complet)

Cette méthode ajoute le chatbot à chaque page de votre boutique. Suivez ces étapes détaillées :

Étape 1 : Accédez à l’admin Shopify puis à Boutique en ligne > Thèmes

Étape 2 : Cliquez sur le bouton Personnaliser à côté de votre thème actif
Étape 3 : Cliquez sur les 3 points (⋯) en haut à gauche puis sélectionnez Modifier le code

Étape 4 : Repérez votre fichier theme.liquid dans le dossier Layout (/layout/theme.liquid)

Étape 5 : Ajoutez le code d’intégration juste avant la balise de fermeture </body>
Étape 6 : Enregistrez vos modifications avec Ctrl + S (ou Cmd + S sur Mac)

Après avoir enregistré, visitez votre vitrine et rafraîchissez la page. Le chatbot devrait apparaître sur toutes les pages.

Remarques importantes :

• Coller avant </body> garantit le chargement du widget sur chaque page
• Gardez l’extrait FlowHunt intact et sans modification
• Le chatbot apparaîtra sur toutes les pages de votre boutique

Option B — Ajouter via une section Liquid personnalisée (pages spécifiques)

Cette méthode vous permet d’afficher le chatbot uniquement sur des pages ou modèles spécifiques. Parfait si vous souhaitez le chatbot seulement sur les pages produits ou certaines landing pages.

Étape 1 : Rendez-vous dans Boutique en ligne > Thèmes puis cliquez sur Personnaliser à côté de votre thème actif

Étape 2 : Naviguez vers le modèle où vous souhaitez ajouter le chatbot (ex : pages produits, collections, ou page spécifique)

Étape 3 : Cliquez sur Ajouter une section ou Ajouter un bloc (selon votre thème)
Étape 4 : Cherchez et sélectionnez Liquid personnalisé parmi les options disponibles
Étape 5 : Collez votre code d’intégration FlowHunt dans la zone de contenu Liquid personnalisé

Étape 6 : Cliquez sur Enregistrer puis sur Aperçu pour tester le chatbot sur ce modèle spécifique

Remarques importantes :

• Cette méthode vous donne un contrôle précis sur l’affichage du chatbot
• Il faudra répéter ces étapes pour chaque modèle où vous souhaitez le chatbot
• Idéal pour tester le chatbot sur des pages spécifiques avant un déploiement global
• Le chatbot n’apparaîtra que sur les modèles configurés

Vérification et test

• Ouvrez votre vitrine dans une fenêtre de navigation privée/incognito pour éviter les fichiers en cache.
• Posez des questions courantes (livraison, retours, disponibilité produit) pour valider le flux.
• Consultez les journaux de conversation dans FlowHunt (activez Verbose si besoin) pour voir quels documents ou outils ont été utilisés.

Dépannage

• Chatbot non affiché : vérifiez que le code d’intégration est bien inclus sur la page, que votre thème est publié et que le domaine est autorisé dans les paramètres Chatbots.
• Widgets dupliqués : supprimez tout extrait en double et gardez un seul code d’intégration actif.
• Réponses manquantes : vérifiez les sources de connaissances et les paramètres du Document Retriever dans votre flux, puis republiez.
• Erreur de permissions Shopify : reconnectez Shopify depuis FlowHunt → Intégrations et réinstallez si besoin.