Connecteur Magento
Fonctionne avec Magento
Connectez Magento 2 ou Adobe Commerce à FreeScout pour que les conversations affichent les commandes client correspondantes et le contexte d'achat. Un petit module Magento en lecture seule expose un résumé de support via l'API REST Magento, et le connecteur FreeScout l'affiche dans la barre latérale de la conversation. 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 Magento ajoute une barre latérale de commande aux conversations FreeScout. Lorsqu'une conversation a une adresse e-mail client, le connecteur appelle le moo-support/summary point de terminaison sur votre boutique Magento pour faire correspondre les commandes 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 deux composants à installer :
- Le Module connecteur ReplyRabbit pour Magento 2. Il ajoute deux points de terminaison REST en lecture seule (
/rest/V1/moo-support/summaryet/rest/V1/moo-support/purchased-products) derrière une permission d'administration dédiée appelée API du connecteur ReplyRabbit. Il ne modifie ni la vitrine ni le paiement. - Le Module connecteur Magento pour FreeScout. Il appelle ces endpoints via HTTPS à l'aide d'un token d'accès d'intégration Magento et 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 Magento 2.4 ou ultérieure (Magento Open Source ou Adobe Commerce) accessible via HTTPS, avec accès SSH pour exécuter les commandes CLI Magento.
- Accès administrateur Magento pour créer une intégration.
- ReplyRabbit installé et activé si vous souhaitez un contexte de propriété des produits dans les brouillons IA.
- Une licence Magento 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.
Installez le module Magento
Télécharger le module Magento
Se connecter à app.replyrabbit.app et téléchargez le ZIP du module Magento depuis la carte du connecteur Magento.Décompressez-le dans app/code
Téléversez le ZIP à la racine de votre Magento et décompressez-le. Il créeapp/code/Moogento/SupportData.Activer le module
Depuis la racine de Magento, exécutez :Sur une boutique en mode production, exécutez aussibashbin/magento module:enable Moogento_SupportData bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flushbin/magento setup:static-content:deploycomme pour toute installation de module.
Installations via Composer
moogento/m2-supportdata depuis le dépôt de paquets Moogento. L'installation ZIP ci-dessus ne nécessite aucun identifiant Composer.Créer un jeton d'intégration Magento
Le connecteur s'authentifie avec un jeton d'accès provenant d'une intégration Magento. Créez-en une limitée à l'autorisation en lecture seule du module.
Ouvrir Intégrations
Dans l'administration Magento, allez dans Système, puis Extensions, puis Intégrations, et cliquez sur Ajouter une nouvelle intégration.Nommez-la et définissez la portée de l'API
Saisissez un nom tel que « ReplyRabbit Connector » et votre mot de passe administrateur. Sur le API onglet, définissez Accès aux ressources à Personnalisé et cochez uniquement API du connecteur ReplyRabbit (sous l'arborescence d'administration de premier niveau). Enregistrez.Activez et copiez le jeton d'accès
Cliquer Activer à côté de la nouvelle intégration, puis Autoriser. Copiez le Jeton d'accès. Magento affiche le token dans les détails de l'intégration, vous pouvez donc y revenir plus tard.
Accès en lecture seule
Installez le module connecteur FreeScout
Le module connecteur Magento pour FreeScout appelle les endpoints Magento et affiche la barre latérale de commande dans les conversations. C'est un module à part avec ses propres paramètres, distinct de ReplyRabbit.
Télécharger le module connecteur
Se connecter à app.replyrabbit.app pour télécharger le ZIP du module connecteur FreeScout. Les deux téléchargements apparaissent une fois que vous avez acheté le connecteur ou que vous disposez d'un forfait ReplyRabbit Pro ou Team actif.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 Magento module depuis la liste des modules.
Configurer par boîte aux lettres
Une fois le module installé, connectez-le à votre boutique dans la page de paramètres propre au connecteur pour chaque 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 Magento, 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 Magento, et non d'une section dans les paramètres ReplyRabbit.Saisissez l'URL de base Magento
Collez l'URL de base de votre boutique Magento en HTTPS, par exemplehttps://your-store.com. Une barre oblique finale n'est pas nécessaire.Saisissez le jeton d'accès
Collez la Jeton d'accès depuis l'intégration Magento. Il est stocké chiffré, et seul un aperçu masqué est affiché après l'enregistrement.Définissez l'ID de la boutique (facultatif)
Laissez vide pour faire correspondre les commandes de toutes les boutiques. Saisissez un ID de boutique Magento pour limiter la barre latérale à une boutique ou une vue de boutique.Ajoutez votre clé de licence du connecteur
Si vous avez acheté le connecteur, saisissez sa clé de licence. Ignorez cette étape si un forfait ReplyRabbit Pro ou Team actif couvre l'installation.Enregistrer et tester
Enregistrez les paramètres. Ouvrez une conversation FreeScout où l'e-mail du client correspond à une commande Magento et confirmez que la barre latérale de la commande apparaît.
Chaque boîte aux lettres FreeScout stocke sa propre URL de base, son jeton d'accès et son ID de boutique, afin que vous puissiez connecter différentes boîtes aux lettres à différentes boutiques ou vues de boutique Magento.
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 Magento est un module payant. Vous pouvez l'obtenir de deux façons :
- Achetez le Magento Connector pour 18 EUR en licence unique pour une installation FreeScout, puis collez sa clé de licence dans les paramètres du connecteur.
- 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 |
|---|---|
| La barre latérale de commande n'apparaît pas | Confirmez que l'URL de base et le jeton d'accès dans les paramètres du connecteur sont corrects, et que le panneau de la boîte aux lettres est activé. |
| HTTP 404 depuis la boutique | Le module ReplyRabbit Connector n'est pas installé ou activé. Relancez bin/magento module:enable Moogento_SupportData et bin/magento setup:upgrade, puis videz le cache. |
| HTTP 401 ou 403 depuis la boutique | L'intégration n'est pas activée, le jeton a été régénéré, ou l'intégration ne dispose pas du API du connecteur ReplyRabbit ressource. Réactivez l'intégration et collez le jeton actuel. |
| "Connexion refusée" ou erreur de délai d'attente | Vérifiez que le serveur FreeScout peut atteindre l'URL de votre boutique via HTTPS. Les pare-feu, les listes d'autorisation IP ou le mode maintenance peuvent bloquer la requête. |
| L'URL de base est rejetée | La boutique doit être servie en HTTPS. Un simple http:// Une URL ou un hôte inaccessible est refusé. |
| 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 Magento, et que l'ID de boutique (s'il est défini) correspond à la boutique où il a commandé. |
| 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 Magento, il envoie l'adresse e-mail du client à votre propre boutique Magento via HTTPS. 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.
Le jeton d'intégration n'a besoin que du API du connecteur ReplyRabbit ressource, donc le connecteur n'écrit jamais dans votre boutique. Le jeton est stocké chiffré dans FreeScout, et les requêtes sortantes vérifient TLS et ne suivent aucune redirection.
Aucune donnée de commande Magento 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 ? Voir le Connecteur WooCommerce guide.
FAQ
Ai-je besoin d'un module Magento pour le connecteur ?
Oui. Le connecteur lit un endpoint support-summary que le module ReplyRabbit Connector ajoute à l'API REST Magento 2. Il y a deux téléchargements, le module Magento et le module connecteur Magento pour FreeScout, tous deux disponibles depuis votre compte ReplyRabbit.
Quelles versions de Magento sont prises en charge ?
Magento 2.4 et versions ultérieures, y compris Magento Open Source et Adobe Commerce, sur PHP 8.0 à 8.4. Magento 1 n'est pas pris en charge.
Combien coûte le connecteur Magento ?
Le connecteur Magento 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, collez sa clé de licence dans les paramètres du connecteur.
Quelle permission le token d'accès nécessite-t-il ?
Uniquement la ressource API ReplyRabbit Connector, qui est en lecture seule. Le connecteur n'écrit jamais dans votre boutique, donc l'intégration ne nécessite aucune autre permission d'administration.
Chaque boîte aux lettres FreeScout peut-elle se connecter à une boutique Magento différente ?
Oui. Chaque boîte aux lettres stocke sa propre URL de base, son token d'accès et son ID de boutique facultatif dans les paramètres du connecteur, de sorte que différentes boutiques ou vues de boutique peuvent se connecter à différentes boîtes aux lettres.