Verbind Tajo met Shopify - complete setupgids

Tajo verbindt je Shopify-winkel met Brevo door de integratie voor je op te stellen en vervolgens te wachten tot jij die bekijkt en goedkeurt voordat er iets draait. Deze gids doorloopt de volledige levenscyclus: verbind beide accounts, bekijk het concept, keur het goed en laat de gecontroleerde synchronisatie het overnemen.

Even checken Tajo is in early access. Je hebt Shopify-beheerderstoegang nodig, een Brevo-account en een Tajo-account. Er wordt niets gepubliceerd of verzonden totdat iemand in je team het goedkeurt. Reken dus op een korte reviewstap; dat is bewust zo ontworpen, geen vertraging om omheen te werken.

Hoe de setup werkt

De setup is niet één “verbinden”-knop. Hij verloopt in vijf fasen:

1. Verbinden: je koppelt je Shopify-winkel en je Brevo-account.
2. Concept: Tajo stelt de integratie op, oftewel welke records er verplaatst worden, hoe velden worden gemapt en wat eruit wordt gefilterd.
3. Review: jij inspecteert het concept en het previewbewijs dat ervoor is opgebouwd.
4. Goedkeuren: iemand in je team keurt de publicatie goed met een geschreven onderbouwing.
5. Draaien: de goedgekeurde synchronisatie draait volgens schema (of op verzoek), en elke run wordt gelogd.

Reken voor de verbindingsstappen op een paar minuten per stuk; de review duurt zo lang als jij eraan wilt besteden. Data begint pas te bewegen na goedkeuring, niet eerder.

Stap 1: verbind je Shopify-winkel

1. Open Connectors in Tajo.
2. Kies Shopify en autoriseer toegang tot je winkel. Je wordt naar Shopify gestuurd om toestemming te geven en komt daarna terug in Tajo.
3. Tajo vraagt leestoegang tot klanten, bestellingen en producten, en schrijftoegang tot klanten voor een paar specifieke schrijfacties, zoals opt-outs voor toestemming en loyaltytierlabels. Zie Shopify-permissies uitgelegd voor elke scope en elke schrijfactie.
4. Zodra de verbinding er is, verschijnt Shopify op de Connectors-pagina met de bijbehorende verbindingsstatus.

Stap 2: verbind je Brevo-account

1. Verbind, nog steeds in Connectors, Brevo met je Brevo-API-sleutel. Zie Brevo-API-sleutel instellen voor hoe je er een aanmaakt met de juiste scopes.
2. Zodra de verbinding er is, verschijnt Brevo naast Shopify met zijn status.

Beide verbindingen moeten gezond zijn voordat er een synchronisatie tegen kan worden opgesteld.

Stap 3: laat Tajo de integratie opstellen

1. Open Connectors > Syncs en maak een nieuwe sync aan.
2. Kies een template voor je bron, bijvoorbeeld Shopify-klanten naar Brevo-contacten. Bij het instantiëren van een template wordt een volledige veldmapping gekopieerd naar een concept-syncregel die je kunt bewerken.
3. Open het concept. Je ziet en wijzigt daar:
   • Veldmapping: elk bronveld, het Brevo-veld waar het naartoe schrijft en eventuele transformaties daartussen.
   • Filterexpressie: wordt per record geëvalueerd; records die niet matchen worden overgeslagen.

Een concept doet uit zichzelf niets. Er beweegt geen data zolang een regel in concept staat.

Stap 4: vraag publicatiegoedkeuring aan

1. Kies op de pagina van de syncregel Request publish approval (publicatiegoedkeuring aanvragen).
2. Tajo bouwt een preview van wat de regel zou doen, met ondersteunend bewijs, en maakt een goedkeuringsverzoek aan.
3. Het verzoek verschijnt in Approvals, waar iedereen in je team met de juiste toegang het kan oppakken.

De goedkeuring is gebonden aan exact de versie van de regel die je hebt ingediend. Wordt de regel na goedkeuring bewerkt, dan vervalt de goedkeuring en moet je een nieuwe aanvragen: een goedgekeurd “ja” kan nooit worden hergebruikt voor een andere configuratie.

Stap 5: review en goedkeuring

1. Open het verzoek vanaf de Approvals-pagina.
2. Bekijk de configuratie van de regel en het previewbewijs. Voorbeelddata voor de review is geredigeerd: reviewers zien de vorm van wat er geschreven gaat worden, niet ruwe persoonsgegevens.
3. Keur goed of wijs af. Publicatiegoedkeuringen vereisen een korte geschreven onderbouwing en kunnen niet in bulk worden goedgekeurd: elke goedkeuring is een individuele beslissing die wordt vastgelegd.

Elke beslissing, inclusief wie hem nam en waarom, belandt in de audittrail.

Stap 6: publiceer en laat de sync draaien

1. Kies terug op de syncregel Publish approved version (goedgekeurde versie publiceren). De regel wordt actief.
2. De synchronisatie draait nu volgens schema, of op verzoek wanneer je zelf een run start.
3. Op de pagina van de regel volg je:
   • Runhistorie: elke run met gelezen, geschreven en mislukte records, plus de duur.
   • Cursor: tot waar de incrementele synchronisatie is gevorderd, zodat runs verdergaan waar de vorige stopte.

Wat je van de synchronisatietiming kunt verwachten

De Tajo Shopify-app verwerkt Shopify-webhooks zodra ze binnenkomen, zodat klanten, bestellingen, checkouts, producten en voorraad Brevo bereiken zonder op een batch te wachten. Syncregels draaien in batches: contactsyncregels standaard elke 15 minuten. De pagina van een actieve regel heeft een knop Test run (1 batch).

Vangrails die aan blijven staan

• Toestemming faalt gesloten (fail closed). Een regel die persoonsgegevens naar Brevo schrijft, kan niet worden gepubliceerd zonder het toestemmings- en suppressiefilter, en een contact dat zonder aantoonbare toestemming naar een marketingdoelgroep wordt geschreven, wordt geweigerd. Bij twijfel weigert Tajo liever dan te veel te versturen.
• Budgetten zijn begrensd. Uitgavenlimieten worden afgedwongen; het werk stopt in plaats van een budget te overschrijden.
• Fouten pauzeren de regel. Mislukken meerdere runs achter elkaar, dan pauzeert een circuit breaker de regel automatisch en toont hij de laatste fout. Los het onderliggende probleem op en publiceer opnieuw om te hervatten.
• Alles wordt geauditeerd. Verbindingen, goedkeuringen, publicaties en runs laten allemaal auditrecords achter.

Controleer of het werkt

1. Check de runhistorie van de syncregel: de laatste run hoort een gezond aantal geschreven records te tonen.
2. Open in Brevo Contacten en controleer of je Shopify-klanten verschijnen met gemapte attributen.
3. Missen er contacten, zie dan contacten ontbreken in Brevo en data synchroniseert niet.

Veelgestelde vragen

Kan Tajo de integratie publiceren zonder mens? Nee. Publicatie vereist altijd een menselijke goedkeuring met onderbouwing, en die goedkeuring is gekoppeld aan exact de configuratie die is beoordeeld. Alleen nauw afgebakende, expliciet gemarkeerde routineacties kunnen ooit automatisch worden goedgekeurd, en alleen als je workspace daar ook bewust voor kiest.

Wordt data teruggesynchroniseerd naar Shopify? Nee. De synchronisatie loopt één richting op: van je bron naar Brevo.

Is er een gratis proefperiode? Tajo is in early access en er is geen selfservice gratis versie. Neem contact op met het team om aan de slag te gaan.

Vertraagt de reviewstap het proces? Hij voegt één bewuste menselijke beslissing toe voordat data beweegt. Na die eerste goedkeuring draait de synchronisatie onbeheerd volgens schema totdat je de regel wijzigt, en dat vereist een nieuwe goedkeuring.

Kan ik later ontkoppelen? Ja. Zie ontkoppelen of opnieuw verbinden. Data die al naar Brevo is geschreven, blijft in Brevo.

Gerelateerde artikelen

• Shopify-datasynchronisatie begrijpen
• Accountsetup en teamrollen
• Je Brevo-API-sleutel instellen
• Probleemoplossing: data synchroniseert niet

Hulp nodig?

• Live chat: beschikbaar in het Tajo-dashboard (rechtsonder)
• E-mailsupport: [email protected]
• Documentatie: docs.tajo.io