Gebruik de node FITsociety om gegevens op te halen of te wijzigen. Gebruik FITsociety Trigger wanneer een gebeurtenis in FITsociety het startpunt moet zijn. Welke acties daadwerkelijk mogen worden uitgevoerd, hangt af van de rechten van je bedrijfscredential.
Beschikbare acties
Client: zoeken, ophalen, aanmaken, contactgegevens bijwerken en uitnodigen.
Tag: tags ophalen en aan een cliënt toevoegen of verwijderen.
Coach: coaches ophalen en een coach aan een cliënt toewijzen.
Booking: zoeken, ophalen, aanmaken, annuleren en aanwezigheid bijwerken.
Calendar Event: agendamomenten ophalen.
Form: formulieren ophalen, een intake toewijzen en een check-up plannen.
Custom Field: velddefinities en cliëntwaarden ophalen en bewerkbare waarden aanpassen.
Het ontvangen van een gebeurtenis geeft geen extra schrijfrechten. Zo is een factuurgebeurtenis wel beschikbaar als trigger, maar bevat de node geen algemene actie om facturen aan te maken. Bij boekingen blijven de gewone bedrijfsregels, beschikbare producten en tegoeden gelden.
Voorbeeld: een cliënt opzoeken en ophalen
Maak een workflow met een Manual Trigger.
Voeg FITsociety toe met Client → Search en filter op het exacte e-mailadres van een testcliënt.
Voeg een tweede FITsociety-node toe met Client → Get.
Koppel de Client ID uit de zoekuitvoer aan het veld Client ID van de tweede node.
Voer de workflow uit en controleer de uitvoer. Voeg een voorwaarde toe als een zoekopdracht ook geen resultaat kan opleveren.
Een workflow starten vanuit FITsociety
FITsociety Trigger biedt een catalogus van 56 gebeurtenissen voor onder andere cliënten, boekingen, facturatie, formulieren, metingen, doelen, habits, documenten en gesprekken. Een gebeurtenis is geen volledige export van het onderliggende dossier. Controleer de ontvangen velden voordat je ze verder gebruikt.
Voeg FITsociety Trigger als startnode toe.
Selecteer de juiste bedrijfscredential.
Kies onder Events één of meer passende gebeurtenissen.
Voeg de gewenste vervolgstap en eventuele filters toe.
Sla de workflow op en activeer of publiceer hem, afhankelijk van de benaming in jouw n8n-versie.
Voer daarna een passende testhandeling uit in FITsociety en controleer de uitvoering in n8n.
Activatie registreert het abonnement automatisch. Je hoeft geen generieke webhook handmatig in FITsociety aan te maken. Je credential moet wel webhookrechten en de vereiste afzonderlijke toestemmingen voor gezondheidsgegevens en privécommunicatie hebben. Alleen leesrechten voor cliënten zijn niet voldoende.
Voor triggers moet n8n via een openbare HTTPS-webhook-URL bereikbaar zijn. Een localhost-adres of alleen intern netwerkadres werkt niet. Na wijzigingen aan Events, de webhook-URL of de credential schakel je de triggerworkflow uit en weer in zodat het abonnement wordt bijgewerkt. Historische gebeurtenissen worden niet automatisch ingehaald.
Herhaalde gebeurtenissen veilig verwerken
Een gebeurtenis kan opnieuw worden aangeboden, bijvoorbeeld na een tijdelijke verbindingsfout. Gebruik het id van de gebeurtenis om dubbele verwerking in je vervolgproces te herkennen. Voor FITsociety-schrijfacties kun je dit ID koppelen aan Business Event Key, zodat een herhaalde uitvoering dezelfde bedoelde actie herkent binnen de bewaartermijn. Gebruik voor afzonderlijk bedoelde wijzigingen verschillende sleutels of nodes. Dit is geen onbeperkte garantie tegen dubbele verwerking in alle aangesloten apps.
Gegevens zorgvuldig invullen
Voor kalender- en boekingszoekopdrachten kies je een bereik van maximaal 92 dagen. Gebruik bij datums YYYY-MM-DD en bij tijdstippen een tijdzone. Bij eigen velden wijzig je alleen de gekozen velden; nul en false blijven geldige waarden. Een waarde bewust wissen doe je met null. Bedrijfsvalidatie blijft gelden.
Test schrijfacties alleen met daarvoor bestemde gegevens. Client Create kan een bestaand account koppelen en daarover een e-mail sturen. Client Send Invitation verstuurt een echte uitnodiging. De FITsociety-node kan ook als tool worden gebruikt door een daarvoor ingerichte AI-agent; beperk de beschikbare acties en gegevens tot wat die agent nodig heeft.