Intégration Magento

Connectez votre boutique Magento 2 (Open Source / Adobe Commerce) à Conviro pour que votre chatbot puisse suivre les commandes, gérer les annulations et les retours, et répondre aux questions sur les produits directement dans le chat.

Il existe deux façons de vous connecter, et toutes deux débloquent les mêmes capacités de flux :

1. Avec l’extension officielle Conviro – une installation automatisée en un clic. Recommandée pour la plupart des marchands.
2. Sans aucune extension – une configuration manuelle utilisant l’API REST native de Magento plus un petit snippet du widget. À utiliser si vous ne pouvez pas (ou ne souhaitez pas) installer de modules tiers.

> Point clé : l’extension est une couche de confort, pas une obligation. Le suivi des commandes, l’annulation, les retours et la recherche de produits passent par l’API REST native de Magento sur le backend Conviro – ils fonctionnent donc dans les deux cas. L’extension automatise simplement la configuration, l’injection du widget et les webhooks d’événements.

Prérequis

• Forfait Pro ou supérieur
• Magento 2.4+ (Open Source / Community ou Adobe Commerce)
• Accès administrateur à votre boutique Magento
• Votre clé API Conviro (générez-en une dans Dashboard -> Settings -> API Keys)

Méthode A – Avec l’extension officielle (recommandée)

La voie la plus rapide. Un champ, un clic, et tout est connecté.

Installation

1. Installez le module via Composer :

composer config repositories.conviro composer https://repo.conviro.io
composer config http-basic.repo.conviro.io api <YOUR_CONVIRO_API_KEY>
composer require conviro/module-aichat
php bin/magento module:enable Conviro_AiChat
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

(Ou téléversez le ZIP de l’extension depuis le tableau de bord Conviro si vous n’utilisez pas Composer.)

1. Dans l’admin Magento, allez dans Stores -> Configuration -> Conviro -> AI Chat.
2. Collez votre clé API Conviro et cliquez sur Save Config.

Ce qui se passe automatiquement

Lorsque vous enregistrez la clé API, l’extension :

• Crée une intégration Magento nommée « Conviro AI Chat » avec des permissions REST au minimum nécessaire (Sales orders, Catalog products, Customers, Carts) et génère un jeton d’accès.
• Enregistre votre boutique auprès de Conviro (URL de la boutique + jeton) pour que les flux puissent lire vos données.
• Injecte automatiquement le widget de chat sur chaque page de la boutique – sans modification du thème.
• Envoie des webhooks d’événements (commande passée, statut de commande modifié, produit enregistré, client inscrit) pour que les données restent à jour quasi en temps réel.
• Stocke un secret de webhook signé pour que les événements entrants/sortants soient vérifiés.

C’est tout – vos flux sont en ligne.

Méthode B – Sans l’extension (configuration manuelle)

Aucune installation de module nécessaire. En ~5 minutes, vous ferez ce que l’extension fait automatiquement : créer un jeton API et coller le snippet du widget.

Étape 1 – Créer une intégration Magento (pour les flux)

1. Dans l’admin Magento, allez dans System -> Extensions -> Integrations.
2. Cliquez sur Add New Integration.
3. Donnez-lui un nom (p. ex. « Conviro ») et saisissez votre mot de passe administrateur.
4. Ouvrez l’onglet API et accordez l’accès à ces ressources :

• Sales -> Operations -> Orders (recherche de commande, statut, annulation)
• Catalog -> Inventory -> Products (recherche de produits)
• Customers -> Customer (vérification du propriétaire client/commande)
• (optionnel) Sales -> Operations -> Returns si vous utilisez le flux de retours

1. Cliquez sur Save, puis Activate l’intégration.
2. Copiez le Access Token affiché après l’activation.

Étape 2 – Connecter dans Conviro

1. Allez dans Dashboard -> Settings -> Integrations -> Magento.
2. Saisissez l’URL de votre boutique (p. ex. https://your-store.com) et collez le Access Token.
3. Cliquez sur Connect. Conviro vérifie le jeton et active les flux e-commerce.

Étape 3 – Ajouter le widget de chat

Comme aucune extension n’injecte le widget automatiquement, ajoutez le snippet vous-même. Placez-le juste avant la balise body fermante de votre thème, ou chargez-le via Google Tag Manager :

<script src="https://cdn.conviro.io/widget/widget.iife.js"></script>
<script>
  cw('init', { publicKey: 'pk_YOUR_PUBLIC_KEY' });
</script>

Dans Magento, l’endroit le plus propre est Content -> Design -> Configuration -> [votre thème] -> HTML Head / Footer, ou un bloc HTML divers. GTM fonctionne aussi et survit aux mises à jour de thème.

Ce que chaque méthode vous apporte

En résumé : tous les flux côté client fonctionnent dans les deux modes. Sans l’extension, vous renoncez seulement à la configuration en un clic, à l’injection automatique du widget et à la synchronisation par webhooks en temps réel – tout cela a des équivalents manuels simples.

Sécurité : vérification du propriétaire de la commande

Les deux méthodes incluent la même protection contre la devinette de numéros de commande. Avant de révéler tout détail de commande, le flux demande au client l’e-mail associé à la commande :

1. Le client fournit un numéro de commande.
2. Le bot demande l’e-mail utilisé lors du paiement.
3. Conviro ne révèle les détails de la commande que si l’e-mail correspond à la commande.
4. S’il ne correspond pas, le bot répond exactement comme si la commande était introuvable – ainsi un attaquant ne peut pas savoir si un numéro de commande est réel.

Cette règle est appliquée dans le backend Conviro, indépendamment de l’extension, via l’étape de vérification d’e-mail du flux de commande. Les modèles de flux e-commerce préconçus collectent déjà l’e-mail avant toute recherche.

Flux e-commerce

Utilisez les modèles préconçus sous Dashboard -> Flows -> New Flow -> Use Template -> E-Commerce :

• Order Status – rechercher le statut, l’expédition et le suivi par numéro de commande + e-mail.
• Cancel & Refund – vérifier la propriété, puis annuler une commande éligible.
• Returns & Exchanges – vérifier la propriété, capturer le motif et démarrer un RMA.
• Product Search – trouver des produits par nom/SKU et partager les détails dans le chat.

Tout cela appelle l’API REST native de Magento avec le jeton de la Méthode A ou B – aucun endpoint personnalisé requis.

Conseils

• Utilisez l’extension si possible – elle supprime toute étape manuelle et garde les données à jour via les webhooks.
• Utilisez le mode manuel sur les boutiques verrouillées, les places de marché, ou lorsqu’une politique de sécurité interdit les nouveaux modules.
• N’accordez à l’intégration que les ressources minimales réellement utilisées – vous pouvez toujours ajouter Returns plus tard.
• Commencez par le flux Order Status ; il répond à la question e-commerce n° 1 et prouve que la connexion fonctionne.
• Après connexion, testez en demandant au bot une vraie commande (avec l’e-mail correspondant) et un vrai produit/SKU.