Magento-integratiehandleiding
Tajo maakt via de Commerce REST API verbinding met Adobe Commerce (Magento 2). Er is geen Tajo-extensie die je in je Magento-codebase installeert. De verbinding gebruikt een integratietoken, waardoor de deploypijplijn van je winkel onaangeroerd blijft.
Magento is op dit moment een verbinding die tijdens de onboarding wordt opgezet: anders dan Shopify en WooCommerce is het nog niet selfservice, en richt je Tajo-team de synchronisatie in als onderdeel van de onboarding. De implementatiestatus van de connector laat zien hoe ver het staat. De voorbereiding aan de winkelkant hieronder is alles wat Magento van jouw kant nodig heeft, en het werkt met een standaard Magento, zonder codewijzigingen.
Vereisten
- Adobe Commerce / Magento Open Source 2.4+
- Beheerderstoegang om een integratietoken aan te maken
- HTTPS op je winkel (vereist voor tokenauthenticatie)
- Tajo-account met een actief abonnement
Stap 1: maak een Magento-integratietoken
- Ga in de Magento-beheeromgeving naar System → Extensions → Integrations → Add New Integration.
- Noem de integratie
Tajo, vul je beheerderswachtwoord in en geef onder API leestoegang tot de resources Customers, Sales en Catalog. - Sla op, klik daarna op Activate en kopieer het Access Token.
Tajo authenticeert met Authorization: Bearer <access token> op de REST-basis-URL van je winkel (https://yourstore.com/rest/V1/).
Stap 2: geef de verbinding door aan je Tajo-team
Deel het volgende met je Tajo-onboardingcontact:
| Veld | Waarde |
|---|---|
| Winkel-URL | https://yourstore.com |
| Access token | Het integratietoken uit stap 1 |
De verbinding wordt met een read-only verzoek gevalideerd voordat er iets wordt gesynchroniseerd. Je kunt het token in Magento op elk moment roteren om de toegang in te trekken.
Wat een Magento-verbinding synchroniseert
- Klanten: identiteitsvelden en accountmetadata om contacten te herleiden. Marketingtoestemming wordt nooit afgeleid uit het bestaan van een account
- Bestellingen: aankoopgeschiedenis, totalen, valuta, status en regelitems voor lifecyclesegmentatie en win-backautomatiseringen
- Producten en categorieën: catalogusstructuur voor interessesegmentatie en productgerichte campagnes
Eerst draait de historische import, daarna houdt incrementele synchronisatie Tajo actueel door gewijzigde records op te halen. Realtime storefront-events (winkelwagens, checkouts die nog bezig zijn) vragen om een extensie in de winkel zelf, en die krijgt Magento vandaag niet. Automatiseringen op basis van bestellingen worden volledig ondersteund via synchronisatie.
Marketingautomatisering
Automatiseringen (e-mail, SMS, WhatsApp via Brevo en andere providers) stel je in Tajo in op basis van de gesynchroniseerde gegevens. Denk aan opvolging na aankoop bij nieuwe bestellingen, win-back bij klanten die zijn afgehaakt, en campagnes rond productinteresse op basis van categoriegeschiedenis.
Problemen oplossen
| Symptoom | Oorzaak en oplossing |
|---|---|
| 401 vanuit de winkel | Het integratietoken is opnieuw gegenereerd of de integratie is gedeactiveerd. Activeer opnieuw en werk het token bij in Tajo |
| Klanten synchroniseren wel, bestellingen niet | In de API-rechten van de integratie ontbreekt de resource Sales |
| Trage eerste import | Grote winkels importeren in pagina’s. Je Tajo-contact kan je op elk moment de voortgang doorgeven |
Volgende stappen
- Referentie van de Magento-connector: implementatiestatus en technische notities
- Klantsynchronisatie: Magento-klanten koppelen aan je system of record