Ik kan FITsociety niet installeren in n8n Cloud
De FITsociety-node is gepubliceerd voor eigen n8n-hosting, maar n8n Cloud-goedkeuring is nog niet verleend. Een npm-publicatie maakt de node niet automatisch beschikbaar in Cloud. Deze handleiding gaat daarom uit van een zelf gehoste omgeving.
Community nodes of de FITsociety-node ontbreekt
Laat de n8n Owner of Admin controleren of communitynodes in jouw omgeving zijn toegestaan en of n8n-nodes-fitsociety geïnstalleerd is. Gebruik n8n 2.44.6 of nieuwer. Bij meerdere workers moet dezelfde pakketversie op iedere worker aanwezig zijn. Verwijder het pakket niet als eerste herstelstap: bestaande workflows kunnen daarvan afhankelijk zijn.
De verbindingstest mislukt
Gebruik de volledige HTTPS-URL met
/public/v1als API Base URL.Controleer of Company ID, Client ID en Client Secret samen horen bij hetzelfde bedrijf en bij de n8n-koppeling.
Gebruik geen Zapier-, Make- of andere API-inloggegevens als vervanging.
Controleer of de toegang nog actief is. Vraag bij ingetrokken of vervangen toegang nieuwe gegevens aan via de bedrijfsbeheerder en FITsociety-support.
Een geslaagde verbindingstest bevestigt de verbinding met het bedrijfsprofiel. Hij bewijst niet dat de credential iedere actie mag uitvoeren. Ontbreekt alleen een bepaalde functie, laat dan de toegekende rechten controleren.
Een actie krijgt een toegangs-, zoek- of validatiefout
401 of ongeldige verbinding: controleer de credential en of de bedrijfstoegang nog actief is.
403 of onvoldoende rechten: laat de benodigde actie- of gegevensrechten beoordelen. Een leescredential kan geen cliënt wijzigen.
404 of niet gevonden: controleer het bedrijf en het juiste Client ID of Booking ID.
409 of conflict: controleer of het record al bestaat of een herhaalsleutel voor gewijzigde invoer wordt gebruikt.
Ongeldige invoer: controleer verplichte velden, datums, tijdzones en toegestane eigen-veldwaarden.
429 of te veel verzoeken: verlaag de gelijktijdigheid en respecteer de aangegeven wachttijd voordat je opnieuw probeert.
Gebruik bij een lege cliëntzoekopdracht het exacte e-mailadres en controleer eventuele statusfilters. Voor kalender- en boekingszoekopdrachten is het toegestane bereik maximaal 92 dagen.
De trigger ontvangt niets
Controleer of de workflow actief of gepubliceerd is en of de juiste Events zijn geselecteerd.
Controleer of de credential webhookrechten en de vereiste gegevensbevestigingen heeft. Een geslaagde gewone zoekactie is daarvoor geen bewijs.
Laat de n8n-beheerder de openbare HTTPS-webhook-URL en reverse-proxyinstellingen controleren. FITsociety moet de URL rechtstreeks kunnen bereiken; localhost, privéadressen en omleidingen worden geweigerd.
Schakel de workflow na een wijziging van URL, Events of credential uit en weer in.
Maak een nieuwe passende testgebeurtenis en bekijk de uitvoeringsgeschiedenis. Oude gebeurtenissen worden niet automatisch opnieuw gestuurd.
Een melding over handtekening of tijdstempel
De trigger controleert of een bericht echt van FITsociety komt. Laat de beheerder de serverklok en proxy controleren en nagaan of de oorspronkelijke webhookinhoud ongewijzigd wordt doorgestuurd. Schakel deze controle niet uit. Na het vervangen van de Client Secret moeten triggerworkflows opnieuw worden geactiveerd.
Een actie wordt dubbel uitgevoerd
Webhooklevering kan worden herhaald. Gebruik de oorspronkelijke gebeurtenis-ID voor ontdubbeling en voor de Business Event Key van FITsociety-schrijfacties. Gebruik geen willekeurig nieuw ID bij iedere herhaalpoging. Controleer ook de bescherming tegen dubbele verwerking van de ontvangende app.
Hulp van support
Vermeld de bedrijfsnaam, je n8n-versie, de versie van het FITsociety-pakket, de resource en actie of trigger, de foutmelding en het tijdstip met tijdzone. Voeg het uitvoerings-ID toe als dat beschikbaar is. Maak sleutels, tokens, webhookgeheimen en cliëntgegevens onleesbaar in screenshots en workflowexports. Deel geen Client Secret in je supportbericht.