Shopify-datasynchronisatie met Brevo begrijpen

Tajo verplaatst data van je bronsysteem naar Brevo via gecontroleerde syncregels: door mensen goedgekeurd, in één richting, volgens schema uitgevoerd en van begin tot eind gelogd. Dit artikel legt uit wat dat in de praktijk betekent en wat er niet bij hoort.

Even checken Dit artikel gaat ervan uit dat je Shopify en Brevo hebt verbonden en minstens één syncregel hebt gepubliceerd. Zo niet, begin dan met Tajo verbinden met Shopify.

De vorm van een sync

Elke synchronisatie in Tajo is een syncregel: een beoordeelde, goedgekeurde definitie van precies wat er beweegt en hoe. Een regel heeft vier onderdelen die je op zijn pagina onder Connectors > Syncs kunt inspecteren:

Onderdeel	Wat het doet
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
Cursor	Houdt bij hoever de synchronisatie is gevorderd, zodat elke run verdergaat waar de vorige stopte
Runhistorie	Elke run, met gelezen, geschreven en mislukte records, plus duur en status

Data stroomt in één richting: van je bron naar Brevo. Tajo schrijft geen data terug naar Shopify.

Wanneer data synchroniseert

Syncruns gebeuren in geplande batches, of op verzoek wanneer je een run start vanaf de pagina van de regel. Tajo is geen realtime pipeline: een wijziging in Shopify bereikt Brevo bij de volgende run, niet binnen seconden. Dat is een bewuste keuze. Juist batchruns maken elke schrijfactie beoordeelbaar, gebudgetteerd en herleidbaar tot een specifieke run in de audittrail.

Elke run leest nieuwe en gewijzigde records sinds de cursor, past het filter toe, mapt de velden en schrijft naar Brevo. Het runrecord toont exact hoeveel records er gelezen, geschreven en mislukt zijn.

De governancegaranties

Toestemming faalt gesloten (fail closed)

Een syncregel kan niet worden gepubliceerd zonder toestemmingsbeleid, en tijdens een run wordt een record zonder aantoonbare toestemming niet geschreven. Kan toestemming niet worden vastgesteld, dan weigert Tajo de schrijfactie in plaats van te gokken. De faalmodus is altijd “te voorzichtig”, nooit “te veel verstuurd”.

Runs zijn idempotent

Elke schrijfactie draagt een herkomstsleutel die is afgeleid van het bronrecord (ontworpen om PII-veilig te zijn). Een sync opnieuw draaien, na een fout, een pauze of handmatig, creëert dus geen dubbele schrijfacties. Het is altijd veilig om een regel opnieuw te draaien.

Alles wordt geauditeerd

Het publiceren van een regel, elke goedkeuringsbeslissing (met de geschreven onderbouwing) en elke run worden vastgelegd in de audittrail. De goedkeuring die een publicatie autoriseerde, is gebonden aan exact de regelversie die is beoordeeld; het bewerken van de regel maakt de goedkeuring ongeldig, zodat de audittrail altijd weergeeft wat er werkelijk is geautoriseerd.

Fouten pauzeren de regel

Mislukken meerdere runs achter elkaar, dan pauzeert een circuit breaker de regel automatisch en toont hij de laatste fout op de pagina van de regel. Los de oorzaak op en publiceer opnieuw om te hervatten. Een deels mislukte run rapporteert zijn aantal mislukte records, zodat je precies ziet wat niet is geland.

Hoe uitschrijvingen worden gerespecteerd

Tajo behandelt Brevo als de bron van waarheid voor e-mailtoestemming:

Schrijft een contact zich uit via een uitschrijflink in de footer van een Brevo-e-mail, dan wordt die opt-out vastgelegd bij het contact en sluit Brevo het uit van verdere campagnes.
Contacten die in Brevo op de blacklist staan, blijven uitgesloten; latere verzendingen wekken ze niet opnieuw tot leven.
Tajo pusht de uitschrijfstatus niet terug naar Shopify. Verzamel je ook e-mailtoestemming in Shopify, beheer die daar dan apart; ga er niet van uit dat de twee systemen elkaar spiegelen.

Welke data beschikbaar is

Wat er synchroniseert, hangt af van de templates die voor je bron beschikbaar zijn. Voor Shopify is de typische vorm: klantrecords, met identiteitsvelden en uit bestellingen afgeleide attributen zoals totale besteding en aantal bestellingen, gemapt naar Brevo-contactattributen die je kunt gebruiken in segmenten en campagnes. De exacte mapping voor jouw workspace zit niet verstopt in een beschrijving: open de syncregel en lees de veldmappingtabel. Die tabel is het gezaghebbende antwoord op “wat synchroniseert er”.

Wat Tajo vandaag niet doet

Precies zijn over de grenzen is belangrijker dan een lange featurelijst:

Geen bidirectionele synchronisatie. Er wordt niets teruggeschreven naar Shopify: geen uitschrijvingen, geen tags, geen engagementscores.
Geen realtime synchronisatie. Runs zijn geplande of handmatig gestarte batches, geen streaming binnen de minuut.
Geen voorraadtracking. Voorraadniveaus van producten worden niet gemonitord en er zijn geen back-in-stock-triggers.

Blokkeert een van deze grenzen een use case voor jou, laat het het team dan weten; de prioriteiten in early access worden gevormd door precies deze feedback.

Waar je je data ziet

In Tajo: open de syncregel onder Connectors > Syncs voor runhistorie, cursorpositie en tellingen per run. De audittrail legt publicaties en goedkeuringen vast.
In Brevo: open Contacten en inspecteer de attributen van een contact om te bevestigen dat gemapte velden gevuld worden. Bouw segmenten op die attributen voor targeting.

Probleemoplossing

Contacten verschijnen niet in Brevo: check de laatste run van de regel op fouten en check de status van de regel (een gepauzeerde regel draait niet). Zie contacten ontbreken in Brevo.
Runs mislukken herhaaldelijk: de circuit breaker pauzeert de regel en toont de laatste fout. Zie data synchroniseert niet.
Dubbele contacten: schrijfacties zijn idempotent per bronrecord, maar bestaande duplicaten in Brevo blijven staan. Zie dubbele contacten.

Veelgestelde vragen

Kan ik de synchronisatie sneller maken? Je kunt op elk moment een run op verzoek starten vanaf de pagina van de syncregel. Er is geen realtime modus.

Wat gebeurt er als een run halverwege mislukt? De run rapporteert zijn aantal mislukte records, de cursor schuift alleen op over wat verwerkt is, en de volgende run dekt dat terrein veilig opnieuw af; idempotentiesleutels voorkomen duplicaten.

Kan ik veranderen wat er synchroniseert? Ja: bewerk de veldmapping of het filter van de regel. De bewerking levert een nieuwe versie op die opnieuw door de publicatiegoedkeuring moet voordat ze van kracht wordt.

Waarom heeft mijn regel zichzelf gepauzeerd? Opeenvolgende mislukte runs activeren de circuit breaker. De pagina van de regel toont het aantal fouten en de laatste fout; los het probleem op en publiceer opnieuw.

Hulp nodig?

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