--- title: Comment installer un agent sur Shopify description: Où insérer le code dans le thème Shopify, comment l'agent lit le catalogue de la boutique, que faire avec le panier et le paiement, et comment vérifier l'installation. section: platforms keywords: Shopify, widget Shopify, theme.liquid, chat Shopify, agent IA Shopify, installation agent Shopify, intégration Shopify, catalogue produits Shopify, chatbot e-commerce Shopify, support client IA Shopify updated: 2026-09-06 --- Shopify dispose déjà d'un catalogue lisible par machine, ce qui permet à l'agent de collecter les informations sur les produits avec une précision inégalée : les prix, les variantes, la disponibilité et les photos proviennent directement de la boutique. ## Шаг 1. Insérez le code dans le thème 1. Dans l'interface d'administration Shopify, ouvrez **Boutique en ligne → Thèmes**. 2. Pour le thème actif, cliquez sur **… → Modifier le code**. 3. Dans la liste des fichiers, recherchez `layout/theme.liquid`. 4. Insérez la ligne de code de votre espace client juste avant la balise de fermeture ``. 5. Enregistrez. Alternative sans modification du thème : **Boutique en ligne → Préférences → Code personnalisé** ou toute application d'insertion de scripts. Le résultat est identique. ```liquid ``` Récupérez la ligne exacte dans votre espace client via le bouton « Copier le code » : elle inclut déjà l'adresse de votre boutique. ## Шаг 2. Collectez le catalogue Dans les paramètres, indiquez l'adresse de votre boutique et lancez l'analyse. Le robot d'exploration Shopify lit les données structurées des produits : nom, prix, devise, disponibilité, description et photos. Les variantes (tailles, couleurs) apparaissent sur la fiche produit comme des caractéristiques. Une nouvelle analyse met à jour les prix et la disponibilité. Lancez-la après des modifications majeures de votre assortiment : l'agent ne se connecte pas directement à votre base de données, il travaille avec le catalogue collecté. ## Шаг 3. Laissez le paiement à la boutique Sur Shopify, il n'est pas nécessaire d'activer le paiement dans le chat. Voici le processus correct : 1. Dans les paramètres de la boutique, indiquez le lien vers le panier — généralement `https://votre-domaine/cart`. 2. L'agent sélectionne le produit, affiche la fiche et, via un bouton, dirige l'acheteur vers le panier Shopify. 3. La commande et le paiement suivent le parcours habituel, avec toutes vos règles de livraison et de taxes. Pour suivre les conversations qui aboutissent à un achat, insérez un fragment du pixel d'achat sur la page de remerciement. Sur Shopify, cela se trouve dans **Paramètres → Paiement → Page de statut de commande → Scripts supplémentaires**. Le fragment, avec l'insertion du numéro de commande et du montant, est disponible dans votre espace client, sous la section « Widget et lien ». ## Le produit est ajouté au panier sans interrompre la conversation C'est là que Shopify se distingue des autres plateformes. L'agent affiche des fiches produits avec photo, prix et un bouton. Ce bouton ne se contente pas de rediriger vers une page, il ajoute directement le produit au panier de la boutique. Voici comment cela fonctionne : le lien du produit Shopify contient un identifiant de variante. L'agent le transmet à votre panier via l'interface standard `/cart/add.js`. La page ne se recharge pas, le dialogue n'est pas interrompu, l'acheteur voit une brève confirmation et continue ses achats. Le produit est déjà dans le panier Shopify — avec toutes vos règles de réductions, taxes et livraison. Si le lien ne contient pas de variante, l'agent ouvre la fiche produit, et l'acheteur l'ajoute lui-même. Rien ne se casse, cela demande juste un clic supplémentaire. Lorsque la personne est prête, le bouton « Passer à la commande » mène à `/cart`, où tout est déjà rassemblé. Ensuite, c'est la caisse habituelle de Shopify. Et un point important sur le contexte : l'agent lit les données structurées de la page où le chat est ouvert. L'acheteur consulte un produit spécifique et demande « est-ce disponible en taille L ? » — l'agent comprend de quoi il s'agit, sans avoir besoin de demander des précisions. - Ouvrez la boutique en mode incognito, attendez l'apparition du bouton de chat. - Demandez un produit par son nom — une fiche produit avec le prix devrait apparaître. - Cliquez sur « Passer à la commande » — le panier Shopify devrait s'ouvrir. - Passez une commande test et assurez-vous que l'achat est bien enregistré dans les « Demandes ». ## Un chat en harmonie avec votre boutique Le thème Shopify donne le ton à toute la boutique, et le chat ne doit pas détonner. Dans les paramètres du widget, trois options sont disponibles : clair, sombre et « comme le visiteur », qui s'adapte aux réglages de l'appareil de l'acheteur. Pour les boutiques avec un thème sombre, définissez le mode sombre de manière fixe ; pour les thèmes clairs, choisissez le mode clair. La couleur d'accentuation des boutons reste la vôtre dans les deux cas. ## Шаг 4. Vérifiez ## Problèmes fréquents **Le widget a disparu après un changement de thème.** Le code réside dans le fichier du thème. Un changement ou une mise à jour du thème efface cette modification — insérez le code à nouveau ou utilisez le Code personnalisé, qui ne dépend pas du thème. **Le catalogue n'a pas été entièrement collecté.** L'exploration récupère les produits des pages publiques. Les produits masqués du catalogue et les brouillons ne sont pas inclus, ce qui est normal. **Les prix du catalogue sont obsolètes.** Relancez l'analyse du site, elle mettra à jour les prix et la disponibilité des fiches existantes. **Le widget entre en conflit avec une application de chat.** Ne conservez qu'un seul chat : deux fenêtres dans le même coin se gênent mutuellement et peuvent dérouter l'acheteur. ## Questions fréquentes ### Faut-il une application du Shopify App Store Non. L'agent se connecte avec une seule ligne de code, aucune installation d'application n'est requise. ### L'agent peut-il afficher les variantes de produits Oui, les variantes apparaissent sur la fiche produit comme des caractéristiques : taille, couleur, volume. L'acheteur sélectionne la variante spécifique dans le panier Shopify. ### Comment gérer plusieurs devises L'agent affiche les prix dans la devise du catalogue, qu'il détermine lors de l'exploration. La gestion multidevise de Shopify prend le relais ensuite, côté panier et paiement. ### L'agent connaîtra-t-il les stocks La disponibilité est relevée au moment de l'analyse. Pour les produits qui s'épuisent rapidement, lancez l'analyse plus fréquemment ou ajoutez une mention dans les conditions stipulant que la disponibilité est confirmée lors de la commande. ### Le widget affecte-t-il la vitesse de la boutique Le script se charge de manière asynchrone et ne bloque pas le rendu. Cela n'a pratiquement aucun impact sur les métriques Core Web Vitals.