Guide d’intégration Magento
Tajo se connecte à Adobe Commerce (Magento 2) via la Commerce REST API. Il n’y a aucune extension Tajo à installer dans le code de votre boutique Magento, la connexion repose sur un jeton d’intégration, ce qui laisse intacte la chaîne de déploiement de votre boutique.
Magento est aujourd’hui une connexion mise en place pendant l’onboarding : contrairement à Shopify et WooCommerce, elle n’est pas encore en libre-service, et votre équipe Tajo câble la synchronisation dans le cadre de l’onboarding. Le statut d’implémentation du connecteur indique où elle en est. La préparation côté boutique décrite ci-dessous est tout ce que Magento attend de vous, et elle fonctionne avec un Magento standard, sans modification de code.
Prérequis
- Adobe Commerce / Magento Open Source 2.4+
- Un accès administrateur pour créer un jeton d’intégration
- HTTPS sur votre boutique (requis pour l’authentification par jeton)
- Compte Tajo avec un abonnement actif
Étape 1 : créer un jeton d’intégration Magento
- Dans l’administration Magento, allez dans Système → Extensions → Intégrations → Ajouter une nouvelle intégration.
- Nommez-la
Tajo, saisissez votre mot de passe administrateur puis, sous API, accordez l’accès en lecture aux ressources Customers, Sales et Catalog. - Enregistrez, puis activez l’intégration et copiez le jeton d’accès.
Tajo s’authentifie avec Authorization: Bearer <access token> auprès de l’URL REST de base de votre boutique (https://yourstore.com/rest/V1/).
Étape 2 : confiez la connexion à votre équipe Tajo
Communiquez à votre contact d’onboarding Tajo :
| Champ | Valeur |
|---|---|
| URL de la boutique | https://yourstore.com |
| Jeton d’accès | Le jeton d’intégration créé à l’étape 1 |
La connexion est validée par une requête en lecture seule avant le démarrage de toute synchronisation. Vous pouvez faire tourner le jeton dans Magento à tout moment pour révoquer l’accès.
Ce qu’une connexion Magento synchronise
- Clients : champs d’identité et métadonnées de compte pour la résolution des contacts. Le consentement marketing n’est jamais déduit de l’existence d’un compte
- Commandes : historique d’achat, totaux, devise, statut et lignes de commande pour la segmentation par cycle de vie et les automations de reconquête
- Produits et catégories : structure du catalogue pour la segmentation par centre d’intérêt et les campagnes tenant compte des produits
L’import historique s’exécute en premier, puis la synchronisation incrémentale garde Tajo à jour en interrogeant les enregistrements modifiés. Les événements de vitrine en temps réel (paniers, processus de paiement en cours) exigent une extension installée dans la boutique, ce que Magento n’a pas aujourd’hui. Les automations basées sur les commandes restent entièrement prises en charge via la synchronisation.
Automation marketing
Les automations (e-mail, SMS, WhatsApp via Brevo et d’autres fournisseurs) se configurent dans Tajo à partir des données synchronisées, par exemple des relances après achat sur les nouvelles commandes, de la reconquête sur les clients inactifs et des campagnes par centre d’intérêt à partir de l’historique des catégories.
Dépannage
| Symptôme | Cause et solution |
|---|---|
| 401 renvoyé par la boutique | Le jeton d’intégration a été régénéré ou l’intégration désactivée. Réactivez-la et mettez le jeton à jour dans Tajo |
| Les clients se synchronisent mais pas les commandes | Les droits API de l’intégration ne couvrent pas la ressource Sales |
| Import initial lent | Les grandes boutiques sont importées page par page. Votre contact Tajo peut vous indiquer l’avancement à tout moment |
Prochaines étapes
- Référence du connecteur Magento : statut d’implémentation et notes techniques
- Synchronisation client : mapper les clients Magento dans votre système de référence