Voor je twee systemen koppelt, beslis je welk systeem welke gegevens beheert, kies je bewust tussen API, webhook en export, en zorg je dat fouten zichtbaar zijn.
01 Begin bij eigenaarschap
Als iemand me vraagt twee systemen te koppelen, klinkt de vraag meestal als “kan je X met Y laten praten?”. De nuttige vraag komt daarvoor: welk systeem is de bron van waarheid voor welke gegevens? Kunnen beide systemen dezelfde klant aanpassen, dan los je het komende jaar conflicten op. Beslis wie waarvan eigenaar is, en koppel dan pas.
Beslis wie waarvan eigenaar is, en koppel dan pas.
02 API, webhook of export
Er zijn drie manieren om gegevens te verplaatsen, en ze passen bij andere taken:
Jij vraagt
Je vraagt gegevens op, of zegt het andere systeem iets te doen. Dat past als je nu meteen een antwoord nodig hebt, of op je eigen tempo wilt ophalen.
Zij melden
Het andere systeem meldt dat er iets gebeurd is. Dat past als je snel wilt reageren zonder om de paar minuten te controleren.
Een bestand komt aan
CSV of XML: de oude manier, en soms de enige optie. Prima voor een nachtelijke batch, zolang iemand merkt wanneer het niet aankomt.
Veel koppelingen combineren ze: een webhook als trigger, daarna een API-aanroep om het volledige record op te halen.
03 Kant-en-klare connector of maatwerk
Een tool zoals Zapier of Make is vaak het juiste antwoord. Is de flow eenvoudig, het volume laag en kost een storing weinig, gebruik dat dan en hou je geld.
Een maatwerkkoppeling begint zin te hebben als de logica echte regels bevat, als je exact moet weten wat er met elk record gebeurd is, of als de connector de gegevens die je nodig hebt niet bereikt. Dat zeg ik je liever in het eerste gesprek dan dat ik iets bouw wat je niet nodig hebt.
04 Wat er in de praktijk misgaat
- Het andere systeem ligt plat of is traag. Aanvragen hebben nieuwe pogingen met een pauze ertussen nodig, en een wachtrij zodat één trage aanroep niet de rest blokkeert.
- Dezelfde gebeurtenis komt twee keer binnen. Webhooks worden opnieuw verstuurd. De ontvangende kant moet een herhaling aankunnen zonder een tweede bestelling of contact aan te maken.
- De gegevens passen niet. Een veld is leeg, een formaat is veranderd, of er duikt een status op die je niet kende. Beslis wat er dan gebeurt voor het zover is.
- Niemand merkt het. De stille fout is de dure. Een sync die dinsdag stopt en pas bij maandafsluiting opgemerkt wordt, kost veel meer dan eentje die dinsdag een melding gaf.
05 Bewaar wat binnenkwam
In een platform voor leadbeheer dat ik bouwde, kwamen leads binnen via formulieren, advertenties en marketingtools. Als dezelfde persoon opnieuw inschreef, was de makkelijke keuze het duplicaat weggooien. Ik bewaarde elk bronevent en koppelde ze aan dezelfde persoon. Sales zag de hele geschiedenis, en er verdween niets omdat een regel besliste dat het een duplicaat was.
De oorspronkelijke payload bewaren kost bijna niets, en het maakt de vraag “waarom is dit record veranderd?” een maand later veel makkelijker te beantwoorden.
06 Vragen om te stellen voor je begint
Kan je die beantwoorden, dan is het technische deel overzichtelijk. Kan je het nog niet, dan is dat het eerste wat we samen uitzoeken.
- Welk systeem is eigenaar van welke gegevens?
- Wat moet er gebeuren als de andere kant een uur onbereikbaar is? Een dag?
- Hoe merk je dat er iets misloopt, en wie krijgt de melding?
- Kan je een maand later zien wat er voor één record verstuurd en ontvangen werd?
- Wie beheert de toegangsgegevens, en wie vernieuwt ze?
