Shopify-datasynchronisatie met Brevo begrijpen

Tajo verplaatst Shopify-data op twee manieren naar Brevo. De Tajo Shopify-app verwerkt Shopify-webhooks zodra ze binnenkomen. Syncregels zijn door mensen goedgekeurd, werken in één richting, draaien in batches en worden van begin tot eind gelogd. Dit artikel legt beide uit, wat er niet bij hoort en de paar dingen die de Tajo Shopify-app terugschrijft naar Shopify.

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.

Zodra events gebeuren: de Tajo Shopify-app

De Tajo Shopify-app abonneert zich op Shopify-webhooks en verwerkt elke webhook zodra die binnenkomt. Wijzigingen in klanten en producten wachten eerst ongeveer vier seconden. Klanten, bestellingen, checkouts, producten, collecties en voorraadniveaus komen zo in Brevo terecht, samen met events zoals order_paid en cart_abandoned. De handleiding voor de Shopify-integratie noemt elk topic en wat het naar Brevo schrijft.

De vorm van een syncregel

Een syncregel is een beoordeelde, goedgekeurde definitie van precies wat er beweegt en hoe. Een agent bouwt hem op basis van jouw beschrijving, en een mens keurt hem goed. Een regel heeft vier onderdelen die je op zijn pagina onder Connections > Syncs and mappings 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

Een syncregel verplaatst data in één richting: van je bron naar Brevo. Een syncregel schrijft nooit naar Shopify. De Tajo Shopify-app schrijft wel een paar dingen terug naar Shopify, zoals opt-outs voor toestemming en loyaltytierlabels. Shopify-machtigingen uitgelegd beschrijft elke schrijfactie en wanneer die gebeurt.

Wanneer een syncregel draait

Syncregels draaien in batches. Regels voor contactsynchronisatie draaien standaard elke 15 minuten. Een actieve, gepubliceerde regel Shopify orders → Brevo orders draait ook elke 15 minuten, maar alleen met het filter uit het sjabloon voor de marketing-opt-in van de koper. Een regel waarvan het filter is bewerkt, draait alleen als je hem zelf start. De eerste geplande run van een bestellingenregel begint een paar minuten vóór dat moment en verstuurt geen oudere bestellingen. Elke volgende run verstuurt de bestellingen die sinds de vorige run zijn bijgewerkt. Eerdere bestellingen komen alleen in Brevo terecht als je de regel zelf draait. De pagina van een actieve regel heeft een knop Test run (1 batch), en de agent Sync Operator draait actieve regels wanneer je daarom vraagt. Juist batchruns maken elke schrijfactie beoordeelbaar, gebudgetteerd en herleidbaar tot een specifieke run.

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 regel die persoonsgegevens naar Brevo schrijft, kan niet worden gepubliceerd zonder het filter voor toestemming en uitsluiting. Tijdens een run wordt een contact dat zonder aantoonbare toestemming naar een marketingdoelgroep zou worden geschreven, geweigerd. 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 sleutel die is afgeleid van het bronrecord. De sleutel is een hash, dus hij bevat geen persoonsgegevens. Een sync opnieuw draaien over dezelfde records, na een fout, een pauze of handmatig, creëert geen dubbele schrijfacties.

Alles wordt geauditeerd

Het publiceren van een regel, ongeldig gemaakte goedkeuringen en automatische pauzes worden vastgelegd onder Activity. Elke goedkeuringsbeslissing heeft een geschreven onderbouwing. Elke run wordt vastgelegd in de runhistorie van de regel. De goedkeuring die een publicatie autoriseerde, is gebonden aan een digest van exact de regel waarvan de preview is gedraaid. Bewerk je de regel, dan wordt hij weer een concept en wordt de goedkeuring ongeldig, zodat wat draait altijd is wat is geautoriseerd.

Fouten pauzeren de regel

Mislukken vijf 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

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.
In de batchsynchronisatie van klanten vergelijkt de Tajo Shopify-app het tijdstip van de toestemming in Shopify met het tijdstip van de uitschrijving in Brevo en houdt de laatste aan.
Een toestemmingswijziging die als webhook uit Shopify binnenkomt, wordt naar Brevo geschreven zoals Shopify die meldt.
Was het contact in Shopify aangemeld, dan zet de Tajo Shopify-app het daar ook op uitgeschreven. Een Brevo-event verandert een klant alleen van aangemeld naar uitgeschreven. Het meldt nooit iemand aan, dus een aanmelding in Brevo verandert niets in Shopify.

Welke data beschikbaar is

De Tajo Shopify-app stuurt contacten, bestellingen, bestel- en winkelwagenevents, de productcatalogus en voorraad. Wat een syncregel stuurt, hangt af van zijn veldmapping. Voor Shopify-klanten mapt het template identiteitsvelden, totale besteding, aantal bestellingen, tags en de opt-in 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 syncregels in twee richtingen. Een syncregel schrijft alleen naar Brevo. De eigen schrijfacties van de Shopify-app naar Shopify (opt-outs voor toestemming, Brevo-engagement- en loyaltymetafields, loyaltytierlabels) staan in Shopify-machtigingen uitgelegd.
Geen realtime syncregels. Syncregels draaien in batches. Alleen de webhooksynchronisatie van de Tajo Shopify-app werkt zodra events binnenkomen.
Geen knop voor nieuwe voorraad. De app houdt de productvoorraad in Brevo actueel en stuurt een back_in_stock-event naar shoppers die om een melding vroegen. Het verzoek moet uit je storefront komen: de app voegt geen knop “Houd me op de hoogte” aan je thema toe.

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 Connections > Syncs and mappings voor runhistorie, cursorpositie en tellingen per run. Activity legt publicaties en automatische pauzes 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? De pagina van een actieve regel heeft een knop Test run (1 batch). Voor wijzigingen zodra ze gebeuren, dekt de webhooksynchronisatie van de Tajo Shopify-app al klanten, bestellingen, checkouts, producten en voorraad.

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. Vraag de agent om de veldmapping of het filter van de regel aan te passen. Door de bewerking wordt de regel weer een concept, en hij moet opnieuw door preview en goedkeuring voordat hij weer draait.

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?

Neem contact op met het team.