Eén aanvraag. Meerdere plekken.
Een aanvraag komt binnen via je website. Je zet de klant in je werkruimte, maakt een project aan en bewaart een verwijzing in je andere tool. Als je dat een paar keer per week doet, is het vooral herhaling. Een koppeling kan die overname uitvoeren, terwijl jij controle houdt over wat er wordt opgeslagen.
Daarvoor heeft MANE een API-laag met servicesleutels en scopes, plus webhooks om wijzigingen door te geven. In n8n kun je de MANE-communitynodes gebruiken of zelf HTTP-verzoeken opbouwen. Make gebruikt HTTP- en webhookmodules. Begin met één concrete overdracht die past bij je werk.
API en webhook: twee kanten van dezelfde verbinding
Met de API vraagt je toepassing iets aan MANE: geef de projecten, zoek een klant of pas deze taak aan. Het antwoord vertelt welke gegevens zijn gevonden of dat de wijziging is opgeslagen. Een webhook werkt de andere kant op: MANE meldt bij jouw ontvanger dat er iets veranderde.
De webhook bevat een dossier-ID en revisie, zodat je workflow de juiste inhoud kan ophalen. Je hoeft daarvoor niet voortdurend alle projecten opnieuw te controleren. Je ontvanger moet wel kunnen omgaan met dubbele meldingen en tijdelijke fouten. Daarom horen ondertekening en ontdubbelen bij de uitwerking.
Je hoeft niet te raden hoe een veld heet
Als je ooit met een CRM-koppeling hebt gewerkt, herken je de vraag: schrijf ik contact.email, een intern veld-ID of een label? In MANE begin je bij Wat spreek je aan? onder Instellingen → API & webhooks. Daar kies je het object en zie je endpoint, veldsleutel, datatype en JSON-pad.
Cliënten kan bijvoorbeeld het schermlabel zijn, terwijl de object-ID uit jouw inrichting anders heet. Een e-mailveld schrijf je onder properties met de exacte sleutel die de catalogus aangeeft. Projecten en trajecten gebruiken dezelfde technische verzameling /projects. Het leesbare woord voor je bedrijf kan veranderen zonder dat je daarvoor je hele koppeling moet hernoemen.
Geef iedere koppeling passende toegang
Een servicesleutel hoort bij één MANE en één toepassing. Je kiest wat die mag lezen en wijzigen. Een planningsflow hoeft geen recht te krijgen om de objectinrichting aan te passen. Een koppeling die alleen installaties volgt kan worden beperkt tot het installatieobject.
De sleutel heeft een vervaldatum en wordt één keer volledig getoond. Bewaar hem in de beveiligde verbinding van je automatisering. Verander je van toepassing of stopt een samenwerking, dan kun je de toegang los intrekken. Webhooks beheer je apart, zodat je bewust bepaalt of de ontvanger nog meldingen mag krijgen.
Een kleine route die meteen te begrijpen is
Neem als voorbeeld een nieuwe aanvraag op je website. De workflow gebruikt de externe aanvraag-ID om te controleren of de aanvraag al is verwerkt. Daarna zoekt hij de passende klant, leest een actuele MANE-revisie en maakt een project aan met de juiste klantkoppeling. De nieuwe MANE-ID wordt bij de aanvraag bewaard.
Dat laatste maakt het verschil tussen een eenmalige kopie en een onderhoudbare koppeling. De volgende wijziging gebruikt hetzelfde dossier in plaats van opnieuw een klant aan te maken. De Idempotency-Key voorkomt bovendien dat een identieke herhaling na een timeout dubbel wordt opgeslagen. Dit voorbeeld is een flow die je zelf inricht; hij staat niet automatisch aan.
Ook je eigen objecten kunnen meedoen
Een klein bedrijf past niet altijd in dezelfde velden. Een installatiebedrijf wil een serienummer en onderhoudsdatum. Een adviseur wil een trajectfase of eigen intakekenmerk. Eigen objecten en eigenschappen kunnen onderdeel worden van de API-inrichting en verschijnen in de catalogus.
Maak de structuur eerst begrijpelijk voor jezelf en je collega’s. Leg vast welk systeem een waarde beheert en wat er gebeurt wanneer een gebruiker die ook in MANE aanpast. Meer koppelingen zijn pas nuttig als duidelijk blijft waar de juiste informatie staat.
Automatiseren vraagt duidelijke grenzen
Een vastgelegde offerte of factuur blijft beschermd. De API is geen manier om akkoord namens een klant te geven of een bankbetaling uit te voeren. Een opgeslagen bericht is ook niet automatisch verzonden mail. Dat onderscheid maakt je flow voorspelbaar: je weet welke stap gegevens vastlegt en welke stap om een afzonderlijke handeling vraagt.
Begin met fictieve gegevens en een leesflow. Voeg daarna één schrijfhandeling toe, test herhalen en fouten en controleer de activiteit. Pas als die route klopt, is het logisch om haar op echte aanvragen te gebruiken.
Van dit verhaal naar jouw eerste koppeling
In de Docs staat de praktische uitwerking: basisadres, sleutels en scopes, objecten en veldpaden, eigen eigenschappen, paginering, conflicten en webhookcontrole. Er zijn afzonderlijke handleidingen voor Make en n8n en een OpenAPI-download voor wie zelf bouwt.
Voor n8n is er nu ook het communitypakket n8n-nodes-mane@0.1.0-beta.2, met MANE-acties en MAINE Skills. Make gebruikt de HTTP- en webhookmodules. Beide routes werken met de API en de rechten van jouw servicesleutel. De n8n-communitynodes zijn een BETA en zijn niet door n8n geverifieerd.
Welk pakket heb je nodig?
De API en webhooks horen bij ieder MANE-pakket, inclusief Basic ZZP. Gewone gegevensverzoeken gebruiken geen MAINE-credits. Voor AI-hulp in je werkruimte heb je na de proefperiode Extended of hoger nodig. Een opgeslagen skill voert via de publieke API niet automatisch een AI-opdracht uit. Bekijk de actuele pakket- en creditkeuzes op de prijspagina.
