Connecteur Shopify
Fonctionne avec Shopify
Connectez Shopify à FreeScout pour que les conversations affichent les commandes client correspondantes et le contexte d'achat. Vous créez une application personnalisée en lecture seule dans votre admin Shopify et collez son jeton d'accès dans FreeScout, sans compte Partner ni examen d'application. ReplyRabbit alimente également la couche IA avec le contexte de propriété des produits afin que les brouillons puissent référencer ce qu'un client a acheté.
Vous cherchez la vue d'ensemble ?
Aperçu
Le connecteur Shopify ajoute une barre latérale de commande aux conversations FreeScout. Lorsqu'une conversation a une adresse e-mail client, le connecteur interroge l'API GraphQL Admin de Shopify sur votre boutique pour trouver les commandes correspondantes et les affiche à côté de la conversation.
La barre latérale affiche un panneau client, l'historique complet des commandes, les lignes d'article par commande avec quantités et prix, les totaux financiers, la valeur vie client (CLV), le panier moyen (AOV) et les droits de possession de produit qui alimentent le contexte de l'IA ReplyRabbit pour des brouillons plus pertinents.
Il y a un composant à installer : le Module connecteur Shopify pour FreeScout. Il lit l'API GraphQL Admin de Shopify via HTTPS à l'aide d'un token d'accès Admin API provenant d'une application personnalisée, puis affiche la barre latérale des commandes. Il dispose de sa propre page de paramètres par boîte aux lettres dans FreeScout.
La barre latérale des commandes fonctionne seule. Les droits de propriété des produits qui alimentent les brouillons IA sont la partie qui utilise ReplyRabbit.
Prérequis
Avant de commencer, assurez-vous de disposer de :
- Une installation FreeScout fonctionnelle.
- Une boutique Shopify sur un
your-store.myshopify.comdomaine (ou un domaine personnalisé qui pointe vers l'un d'eux), avec des autorisations du personnel pour développer des applications. - ReplyRabbit installé et activé si vous souhaitez un contexte de propriété des produits dans les brouillons IA.
- Une licence Shopify Connector (18 EUR en une fois, pour une installation FreeScout), ou un forfait ReplyRabbit Pro ou Team actif, qui l'inclut.
Si ReplyRabbit n'est pas encore installé, commencez par Comment installer le module ReplyRabbit, puis terminez Comment configurer ReplyRabbit.
Créer une application personnalisée dans Shopify
Le connecteur s'authentifie avec un jeton d'accès Admin API provenant d'une application personnalisée hébergée dans votre propre boutique.
Ouvrir Développer des applications
Dans l'administration Shopify, allez dans Paramètres, puis Applications et canaux de vente, puis Développer des applications. Si cela vous est demandé, autorisez le développement d'applications personnalisées.Créer l'application
Cliquer Créer une application, nommez-le "ReplyRabbit Connector" et créez-le.Définissez les portées de l'API Admin
Ouvrir Configurer les portées de l'Admin API et cochezread_customers,read_orders, etread_products. Cochezread_all_orderségalement si vous souhaitez un historique de commandes de plus de 60 jours. Enregistrez.Installez et copiez le jeton
Cliquer Installer l'application, puis Révéler le token une fois et copiez le Jeton d'accès API administrateur (il commence parshpat_). Shopify ne l'affiche qu'une seule fois, alors conservez-le en lieu sûr.
Accès en lecture seule
Installez le module connecteur FreeScout
Télécharger le module connecteur
Téléchargez le module connecteur FreeScout au format ZIP depuis le Tableau de bord ReplyRabbit. Le téléchargement apparaît une fois que vous avez acheté le connecteur ou que vous disposez d'une offre ReplyRabbit Pro ou Team active.Téléverser dans FreeScout
Dans FreeScout, allez dans Modules, cliquez sur le bouton de téléversement, choisissez le ZIP et installez-le.Activez le module
Activez le Intégration Shopify module depuis la liste des modules.
Configurer par boîte aux lettres
Ouvrez les paramètres du connecteur
Dans FreeScout, ouvrez la boîte aux lettres qui doit afficher les données de commande Shopify, ouvrez le menu des paramètres de la boîte aux lettres et choisissez Connecteur de boutique. Il s'agit de la page de paramètres du connecteur Shopify, et non d'une section dans les paramètres ReplyRabbit.Saisissez le domaine de la boutique et le jeton d'accès
Saisissez le domaine de votre boutique, par exempleyour-store.myshopify.com, et collez le token d'accès Admin API. Enregistrez. Le connecteur vérifie le token et les portées auprès de votre boutique avant de le stocker ; le token est stocké chiffré et n'est plus jamais affiché.Ajoutez votre clé de licence du connecteur
Si vous avez acheté le connecteur, définissezSHOPIFYINTEGRATION_LICENSE_KEYdans votre FreeScout.envà sa clé de licence. Ignorez cette étape si un forfait ReplyRabbit Pro ou Team actif couvre l'installation.Tester
Ouvrez une conversation FreeScout où l'e-mail du client correspond à une commande Shopify et confirmez que la barre latérale de la commande apparaît.
Chaque boîte aux lettres FreeScout stocke son propre domaine de boutique et son jeton d'accès, afin que vous puissiez connecter différentes boîtes aux lettres à différentes boutiques.
Ce que le connecteur affiche
- Un panneau client pour la personne sur la conversation.
- Historique complet des commandes avec numéro de commande, date, statut et total.
- Lignes d'articles par commande avec quantités et prix.
- Totaux financiers (sous-total, remise, livraison, taxe, remboursements).
- Valeur vie client (CLV) et panier moyen (AOV).
- Droit d'accès lié à la propriété de produit pour les brouillons IA.
Comment obtenir le connecteur
Le connecteur Shopify est un module payant. Vous pouvez l'obtenir de deux façons :
- Achetez le Shopify Connector pour 18 EUR en licence unique pour une installation FreeScout, puis définissez sa clé de licence comme
SHOPIFYINTEGRATION_LICENSE_KEYdans le FreeScout.env. - Utilisez un plan ReplyRabbit Pro ou Team actif, qui inclut le connecteur sans coût supplémentaire.
Achetez la licence ou téléchargez le connecteur depuis votre Tableau de bord ReplyRabbit. Consultez le page de tarifs pour les options de plan ReplyRabbit. Si un plan ReplyRabbit Pro ou Team actif couvre l'installation, le connecteur fonctionne une fois configuré, sans clé de licence séparée nécessaire.
Dépannage
| Symptôme | Ce qu'il faut vérifier |
|---|---|
| "Shopify a rejeté la connexion" lors de l'enregistrement | Le jeton a été mal saisi, révoqué, ou appartient à une autre boutique. Révélez un nouveau jeton en réinstallant l'application personnalisée et collez-le à nouveau. |
| "Portées Admin API manquantes" lors de l'enregistrement | Ouvrez l'application personnalisée, ajoutez les portées manquantes sous Configurer les portées de l'Admin API, enregistrez et réinstallez l'application. La réinstallation émet un nouveau token. |
| Le domaine de la boutique est rejeté | Utilisez le your-store.myshopify.com domaine, ou un domaine personnalisé qui pointe vers celui-ci. Les hôtes privés et les adresses IP sont refusés. |
| La barre latérale de commande n'apparaît pas | Confirmez que le panneau de la boîte aux lettres est activé et que la connexion apparaît comme connectée dans la page des paramètres. |
| Les commandes sont vides pour un client connu | Confirmez que l'e-mail du client sur la conversation FreeScout correspond à l'e-mail de ses commandes Shopify. |
| Seules les commandes des 60 derniers jours s'affichent | Ajoutez le read_all_orders portée à l'application personnalisée, réinstallez-la et collez le nouveau jeton. |
| Les lignes d'articles, les données financières ou la CLV ne s'affichent pas | Confirmez que la clé de licence du connecteur est enregistrée, ou qu'une offre ReplyRabbit Pro ou Team active couvre l'installation. |
| Le contexte de propriété de produit n'apparaît pas dans les brouillons | Confirmez que le connecteur est sous licence, que ReplyRabbit est installé, que le connecteur renvoie des commandes et que la fonctionnalité de contexte IA est activée pour la boîte aux lettres. |
Pour des problèmes plus larges, voir Dépannage de ReplyRabbit.
Confidentialité et traitement des données
Lorsque le connecteur interroge Shopify, il envoie l'adresse e-mail du client à l'API GraphQL Admin de Shopify via HTTPS en utilisant le jeton de votre application personnalisée. Les données de commande renvoyées par votre boutique alimentent la barre latérale FreeScout et, avec ReplyRabbit, construisent le contexte IA pour les brouillons.
L'application personnalisée dispose uniquement de portées en lecture, le connecteur n'écrit donc jamais dans votre boutique. Le jeton d'accès est stocké chiffré dans FreeScout, et les requêtes sortantes vérifient TLS et ne suivent aucune redirection.
Aucune donnée de commande Shopify n'est envoyée à des tiers, sauf via le fournisseur IA sélectionné pour la boîte aux lettres, et uniquement lorsque la fonctionnalité de contexte IA l'utilise. Si votre politique exige que les données de commande restent entièrement sur vos propres serveurs, utilisez un fournisseur IA local (comme Ollama) pour la boîte aux lettres.
Étapes suivantes
- Terminer Comment configurer ReplyRabbit si la boîte aux lettres a encore besoin des paramètres de fournisseur, de contexte ou de style.
- Aussi sur WooCommerce ou Magento ? Voir le Connecteur WooCommerce et Connecteur Magento guides.
FAQ
Comment le connecteur Shopify se connecte-t-il à ma boutique ?
Avec une application personnalisée que vous créez dans l'administration Shopify (Paramètres, Applications et canaux de vente, Développer des applications). Accordez-lui les portées read_customers, read_orders et read_products, installez-la, puis collez son jeton d'accès à l'API Admin avec le domaine de votre boutique dans les paramètres du connecteur FreeScout. Le connecteur vérifie le jeton auprès de votre boutique avant de l'enregistrer.
Ai-je besoin d'un compte Shopify Partner ou d'une fiche App Store ?
Non. Une application personnalisée est créée dans l'administration de votre propre boutique et ne nécessite aucun compte Partner, aucune revue d'application et aucune inscription publique.
Combien coûte le connecteur Shopify ?
Le connecteur Shopify est inclus avec un forfait ReplyRabbit Pro ou Équipe actif. Sinon, il coûte 18 EUR en licence unique pour une installation FreeScout. Si vous l'achetez, définissez sa clé de licence comme SHOPIFYINTEGRATION_LICENSE_KEY dans votre .env FreeScout.
Pourquoi ne vois-je que les commandes des 60 derniers jours ?
Shopify limite les applications à 60 jours d'historique de commandes, sauf si l'application dispose de la portée read_all_orders. Cochez read_all_orders lors de la configuration de l'application personnalisée pour voir l'historique complet.
Chaque boîte aux lettres FreeScout peut-elle se connecter à une boutique Shopify différente ?
Oui. Chaque boîte aux lettres stocke son propre domaine de boutique et son token d'accès dans les paramètres du connecteur, de sorte que différentes boutiques peuvent se connecter à différentes boîtes aux lettres.