Installer le widget de chat sur Shopify
Ajoutez la bulle de chat intoCHAT à votre boutique Shopify en collant une balise script dans theme.liquid, puis connectez-la pour la recherche de produits.
Sur Shopify, l'application intoCHAT ajoute la bulle de chat comme intégration d'application : vous l'activez dans l'éditeur de thème, sans jamais toucher au code du thème. La bulle et la recherche de produits fonctionnent aussi sans l'application, avec les données publiques de votre boutique et sans clé API ; vous collez alors une seule balise script dans votre thème. Pour que l'agent puisse consulter les commandes, installez l'application Shopify.
L'activer avec l'application Shopify (sans code)
Si vous installez l'application Shopify, vous n'avez pas besoin de modifier votre thème :
- Dans l'onglet Share de l'agent, sous Website, cliquez sur Turn on in your theme sur la carte Your Shopify store (le même bouton se trouve sur la carte Orders de l'onglet Actions). Shopify ouvre l'éditeur de thème avec Bulle de chat intoCHAT activée sous Intégrations d'applications.
- Cliquez sur Enregistrer. La bulle apparaît sur toutes les pages de votre boutique.
Vous la trouvez aussi dans Boutique en ligne → Thèmes → Personnaliser → Intégrations d'applications. L'intégration affiche l'agent sur lequel vous avez installé l'application ; pour un autre agent, collez son ID dans le réglage ID de l'agent. Elle reste en place quand vous mettez à jour votre thème et disparaît si vous désinstallez l'application.
Sans l'application, collez plutôt le snippet, comme ci-dessous.
Copier le code
Ouvrez l'onglet Share de votre agent. Dans le bloc Shopify, cliquez sur Copy Code. C'est le même script que dans le bloc Bubble Chat, et il contient déjà l'identifiant de votre agent :
<script src="https://www.intochat.ai/api/embed.js" data-chatbot-id="YOUR_AGENT_ID"></script>
L'ajouter à votre thème
- Dans l'administration Shopify, allez dans Boutique en ligne → Thèmes.
- À côté de votre thème actuel, cliquez sur ⋯ et choisissez Modifier le code.
- Dans le dossier Layout, ouvrez
theme.liquid. - Collez le code juste au-dessus de
</body>et cliquez sur Enregistrer. - Ouvrez votre boutique. La bulle de chat apparaît dans le coin inférieur de chaque page qui utilise ce layout, avec les couleurs et la position de l'onglet Appearance.
Juste au-dessus de </body> est l'emplacement recommandé, mais le snippet fonctionne aussi dans la section <head> de theme.liquid. S'il se retrouve deux fois dans le thème, une seule bulle apparaît.
Laisser l'agent rechercher vos produits
- Ouvrez l'onglet Actions et choisissez Connect your website.
- Collez l'adresse de votre boutique. intoCHAT détecte Shopify et ajoute deux actions : Search products, qui renvoie jusqu'à cinq résultats par recherche, et Get product details, avec les variantes, les prix et le stock.
- Testez dans le Playground : demandez un produit, un prix ou si un article est en stock. Les réponses affichent des fiches produit avec image, prix et lien vers la page du produit.
Les produits sont recherchés en direct pendant que le visiteur discute : les nouveaux produits et les changements de prix apparaissent sans nouvel entraînement. Cette connexion ne lit que les données produit publiques. Elle ne voit ni les commandes, ni les paniers, ni les données clients, et l'agent ne peut pas finaliser un achat dans le chat ; il oriente plutôt l'acheteur vers la bonne page. La consultation des commandes nécessite l'application Shopify.
Si votre boutique est protégée par un mot de passe, l'agent ne voit pas ses produits. Retirez le mot de passe dans Boutique en ligne → Préférences et connectez-la de nouveau. Détails dans Connecter votre boutique.
Installer l'application Shopify
L'application Shopify intoCHAT donne à votre agent un accès en lecture aux commandes de votre boutique, pour qu'il puisse répondre à des questions comme « Où est ma commande ? ». Elle est indépendante de la bulle de chat et de la recherche de produits décrites plus haut, qui continuent de fonctionner sans elle.
- Ouvrez l'onglet Actions de votre agent et repérez la carte Orders.
- Saisissez l'adresse Shopify de votre boutique :
your-storeouyour-store.myshopify.com. Vous la trouverez dans l'administration Shopify sous Paramètres → Domaines. Votre propre domaine, commeyourstore.com, ne fonctionne pas ici. - Cliquez sur Install on Shopify. Shopify ouvre l'administration de votre boutique et liste les accès demandés par intoCHAT.
- Approuvez l'installation. Shopify vous renvoie vers l'onglet Actions, qui indique si l'installation a réussi.
Seuls le propriétaire du compte et les admins peuvent installer l'application, car elle enregistre un accès à votre boutique. Dans Shopify, vous devez avoir le droit d'installer des applications. Chaque agent se connecte à une seule boutique ; installer l'application sur une autre boutique remplace la connexion actuelle de l'agent.
C'est dans la carte Orders que vous choisissez ce que l'agent fait des commandes, par exemple recueillir des demandes de retour.
Les accès demandés par l'application
- Lecture des commandes (
read_orders) : pour consulter le statut, les articles, la livraison et le suivi d'une commande quand un acheteur pose la question dans le chat.
C'est tout. L'application ne peut ni créer, ni modifier, ni annuler, ni rembourser des commandes, et elle ne demande ni vos produits, ni votre liste de clients, ni vos paiements, ni les réglages de votre boutique. Shopify permet aux applications disposant de cet accès de lire les commandes des 60 derniers jours : l'agent ne peut donc pas consulter les commandes plus anciennes.
Payer intoCHAT via Shopify
Dès que l'application est installée sur votre compte, votre forfait est facturé par Shopify au lieu de votre carte. Dans Settings → Billing, choisissez Starter ou Pro, au mois ou à l'année : Shopify ouvre l'admin de votre boutique pour approuver le prélèvement, qui figure ensuite sur votre facture Shopify. L'essai gratuit de 7 jours de Starter fonctionne de la même façon. Pour changer de forfait, choisissez-en un autre et approuvez-le dans Shopify ; pour arrêter de payer, choisissez Free. Les prix sont en dollars américains et Shopify les convertit dans la devise de facturation de votre boutique. Un forfait que vous payez déjà par carte reste sur votre carte.
Vous pouvez aussi commencer depuis Shopify : ouvrir intoCHAT depuis l'admin Shopify vous connecte (ou vous permet de créer un compte) et installe l'application sur votre agent le plus récent, ou sur un nouvel agent pour votre boutique si vous n'en avez pas encore.
Désinstaller l'application
Dans l'administration Shopify, allez dans Paramètres → Applications, ouvrez intoCHAT et choisissez Désinstaller. Shopify en informe immédiatement intoCHAT, qui supprime la connexion à la boutique et les demandes de retour enregistrées depuis les chats de cette boutique. La bulle de chat et la recherche de produits ne sont pas concernées. Pour vous reconnecter, installez l'application depuis la carte Orders.
intoCHAT renouvelle de lui-même l'accès de l'application tant que l'agent l'utilise. Si l'agent ne consulte aucune commande pendant 90 jours, Shopify met fin à cet accès et la carte Orders vous demande de réinstaller l'application.
Comment intoCHAT traite les données de votre boutique
- Enregistré : l'adresse de votre boutique, les accès que vous avez approuvés et les jetons d'accès de l'application, chiffrés.
- Non enregistré : les commandes et les fiches clients. L'agent lit une commande chez Shopify pendant qu'il répond dans le chat et n'en garde aucune copie.
- Demandes de retour : si vous laissez l'agent les recueillir, chaque demande est enregistrée avec l'adresse e-mail de l'acheteur et le numéro de commande, puis vous est envoyée.
- Transcriptions de chat : ce que saisissent les acheteurs est conservé avec vos autres conversations dans l'onglet Activity, où vous pouvez supprimer une conversation.
Shopify transmet les demandes relatives à la vie privée aux applications installées sur votre boutique, et intoCHAT les traite ainsi :
- Un client demande ses données : intoCHAT vous envoie par e-mail, à vous, propriétaire du compte, ce qu'il détient à son sujet, pour que vous puissiez lui répondre. Shopify vous demande de répondre sous 30 jours.
- Un client demande à être effacé : intoCHAT supprime ses demandes de retour pour votre boutique.
- Les données de votre boutique sont effacées (Shopify le demande 48 heures après la désinstallation) : intoCHAT supprime tout ce qui reste pour la boutique.
Entraîner l'agent sur les contenus de la boutique
Dans l'onglet Knowledge (Connaissances), saisissez l'adresse de votre boutique et choisissez vos pages de livraison, de retours et de FAQ. Importez des guides des tailles ou des conditions sous forme de fichiers, et ajoutez des paires question-réponse pour les réponses dont la formulation doit être exacte.
Dépannage
- Pas de bulle sur la boutique. Vérifiez que vous avez modifié le thème publié et non une copie, et que le code se trouve au-dessus de
</body>danstheme.liquid. - « Chatbot not found. » dans la console du navigateur. L'identifiant de l'agent dans le code est incorrect. Copiez-le de nouveau depuis l'onglet Share.
- « Connect your website » échoue. Vérifiez que l'adresse est celle de votre vitrine publique et que la boutique n'est pas protégée par un mot de passe.
- « Install on Shopify » indique que l'adresse n'est pas valide. Utilisez l'adresse
.myshopify.comindiquée dans Paramètres → Domaines, et non votre propre domaine. - « Shopify app wasn't installed ». Le message en indique la raison. Si l'installation a pris plus de 10 minutes, ou si vous avez changé de compte intoCHAT entre-temps, recommencez depuis la carte Orders.
D'autres cas sont traités dans Dépannage. Ce que l'agent peut faire dans une boutique Shopify est décrit sur la page d'intégration Shopify.