Tutorials

Zo zet je n8n-analyticsworkflows op met de Flowsery-node

Taras Shynkarenko
Taras Shynkarenko
•Bijgewerkt: •9 min leestijd
Zo zet je n8n-analyticsworkflows op met de Flowsery-nodeZo zet je n8n-analyticsworkflows op met de Flowsery-node

TL;DR, kort antwoord

9 min leestijd

Om n8n-analyticsworkflows op Flowsery te bouwen, installeer je de community-node n8n-nodes-flowsery in een self-hosted n8n onder Settings > Community nodes, plak je een flow_ws_-workspacetoken van flowsery.com/api-tokens in de credential Flowsery API en kies je bij elke node een Website. De Flowsery-node leest overzichten, tijdreeksen, realtime bezoekers, 25 uitsplitsingsdimensies, door AI gedetecteerde issues en tijdlijnen van bezoekers, en registreert behaalde doelen en betalingen. De Flowsery Trigger start een workflow één keer voor elk nieuw open issue.

Goede n8n-analyticsworkflows beantwoorden twee vragen zonder dat iemand een dashboard opent: hoe deed de website het vorige week, en ging er iets stuk voor bezoekers? n8n praat al met je inbox, je chat, je CRM en je takentracker. Wat het standaard mist, is een node die cookievrije verkeerscijfers, omzet en de bugs uit sessie-opnames leest. De community-node van Flowsery is die node.

Deze gids behandelt de installatie, de credential, elke operatie en vier workflows die je kunt kopiëren. Wij bouwen Flowsery, en alles hieronder klopt met versie 0.2.0 van de node.

Kort gezegd: installeer n8n-nodes-flowsery onder Settings > Community nodes, maak een workspacetoken aan op flowsery.com/api-tokens met de rol Admin of Editor, plak het in de credential Flowsery API en kies je website in het veld Website van elke node.

Wat heb je nodig om Flowsery aan n8n te koppelen?

Je hebt een self-hosted n8n-instantie nodig, een Flowsery-website met het trackingscript geïnstalleerd en een Flowsery-workspacetoken. De README van de node noemt n8n 1.100 en hoger als getest en behandelt n8n Cloud niet, dus deze gids gebruikt een self-hosted instantie.

Het pakket staat op npm als n8n-nodes-flowsery. Het staat niet in de eigen integratiegids van n8n, dus je installeert het op pakketnaam. Het Team-abonnement ($250 per maand) en het Pro-abonnement ($500 per maand) van Flowsery bevatten allebei de n8n-integratie, en beide beginnen met een gratis proefperiode van 14 dagen zonder creditcard.

De community-node n8n-nodes-flowsery op npm, met het installatiecommando

Hoe installeer je de Flowsery-node in n8n?

Installeer hem vanuit de n8n-editor onder Settings > Community nodes > Install. Typ n8n-nodes-flowsery als pakketnaam, bevestig de melding over het installeren van communitycode en klik op Install. n8n downloadt het pakket van npm en voegt twee nodes toe aan het nodepaneel: Flowsery en Flowsery Trigger.

Zoek in het nodepaneel naar "Flowsery" om te controleren of de installatie is gelukt.

Hoe koppel je je Flowsery-account aan n8n?

Je koppelt Flowsery aan n8n met één geheim dat je in het veld API Token van een nieuwe credential Flowsery API plakt. n8n stuurt het als Bearer-token en test het met een verzoek naar GET /websites, dus een opgeslagen credential betekent dat het geheim werkt.

GeheimWaar je het aanmaaktBegint metWat het bereikt
Workspacetokenflowsery.com/api-tokensflow_ws_Elke website in de workspace
WebsitesleutelSettings > API in één websiteflow_Alleen die ene website

Met een workspacetoken heeft elke node het veld Website nodig, dat je sites op domein laadt. Met een websitesleutel kun je Website leeg laten.

Kies Admin of Editor als rol van het token. Elke call naar de Flowsery-API controleert de permissie flowsery.write, en alleen die twee rollen hebben die, dus een token met de rol Viewer of Contributor wordt geweigerd met permission_denied. Een token doet ook nooit meer dan het teamlid dat het aanmaakte.

Wat kan de Flowsery-node?

De Flowsery-node heeft zes resources, en de Flowsery Trigger start een workflow als Flowsery een nieuw issue vindt.

ResourceOperaties
AnalyticsGet Overview, Get Timeseries, Get Realtime Visitors, Get Breakdown
IssueGet Many, Get, Update Status
GoalGet Many, Track
PaymentTrack
VisitorGet
WebsiteGet Many

Get Overview geeft één rij terug voor een periode: bezoekers, sessies, bouncepercentage, gemiddelde sessieduur, omzet, omzet per bezoeker en conversiepercentage. Get Timeseries deelt bezoekers, sessies en omzet in per uur, dag, week of maand. Get Breakdown splitst bezoekers uit op een van 25 dimensies, waaronder pagina, instappagina, referrer, kanaal, campagne, land, regio, stad, apparaat, browser, de vijf UTM-parameters en doel.

Elke leesoperatie neemt Start Date, End Date en Timezone. Datums staan standaard op de afgelopen 30 dagen, en de tijdzone staat standaard op die van de website zelf. Limit accepteert 1 tot 1000 rijen. Get Overview, Get Timeseries, Get Breakdown en Goal > Get Many nemen ook Filters, 20 stuks, één per filter_*-parameter van de Flowsery-API. Filterwaarden moeten exact overeenkomen met de rijen in de uitsplitsing: een volledige regionaam zoals California, een apparaat Desktop, Mobile of Tablet, en de naam van een referrerbron zoals Google.

Issue > Get Many toont de issues die de AI van Flowsery in sessie-opnames vond, met zoeken, ernst, status en sorteren op recentheid of ernst. Issue > Get voegt de beschrijving, de stappen om te reproduceren, de sessies en de opmerkingen toe. Update Status zet een issue op Open, In Progress, Resolved of Suspended.

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Visitor > Get geeft het profiel van één bezoeker terug met een activiteitentijdlijn. Goal > Track en Payment > Track schrijven events naar je analytics; die komen aan bod in de derde workflow hieronder.

De Flowsery Trigger pollt naar nieuwe open issues en gaat één keer per issue af. Je kunt hem beperken tot één website en één ernst. De eerste poll nadat je de workflow activeert legt alleen de issues vast die al bestaan, zodat een oude achterstand de workflow niet overspoelt.

Iemand leest een weekrapport op een laptop met een kop koffie, passend bij de workflow met het verkeersoverzicht op maandag.

Workflow 1: stuur een wekelijks verkeersrapport

Deze workflow stuurt elke maandagochtend de cijfers van vorige week, vergeleken met de week ervoor.

  1. Schedule Trigger draait elke maandag om 9:00.
  2. Flowsery, Analytics > Get Overview zet Start Date op {{ $now.minus({ days: 7 }) }}, End Date op {{ $now }} en Timezone op een IANA-naam zoals Europe/Berlin.
  3. Een tweede Get Overview dekt de week ervoor, van {{ $now.minus({ days: 14 }) }} tot {{ $now.minus({ days: 7 }) }}.
  4. Flowsery, Analytics > Get Breakdown gebruikt Dimension Referrer en Limit 5 over vorige week, om te tonen waar bezoekers vandaan kwamen.
  5. Merge voegt de uitvoer samen, en een node Send Email, Slack of Telegram verstuurt de samenvatting.

Voeg een vierde Flowsery-node toe met Dimension Page als het rapport ook de toppagina's moet noemen. Onze gids over rapportage van websiteanalyse behandelt welke cijfers in een wekelijkse e-mail thuishoren.

Een klein team bespreekt een bug bij een whiteboard, als beeld voor hoe een nieuw issue een gevolgde taak wordt.

Workflow 2: maak van een nieuwe bug een taak in je tracker

Flowsery stuurt issues zelf al naar Slack en maakt er zelf tickets van in Linear en Jira, zoals beschreven op de pagina automatische bugtickets. De gids over bugtracking in Linear loopt de setup voor Linear stap voor stap door. Gebruik n8n als het issue ergens anders thuishoort, zoals in ClickUp, Asana, Trello, GitHub Issues, Microsoft Teams of Discord.

  1. Flowsery Trigger bewaakt je website, met Severity op High of Critical, of Any.
  2. Flowsery, Issue > Get neemt Issue ID {{ $json.id }} en voegt elk voorval toe, de sessies achter het issue en de opmerkingen.
  3. Een node ClickUp, Asana of Trello maakt de taak aan met de titel, de ernst, het aantal geraakte sessies en de stappen om te reproduceren.
  4. Flowsery, Issue > Update Status zet het issue op In Progress, zodat de issuelijst van Flowsery laat zien dat iemand het heeft opgepakt.

Elk issue uit de trigger bevat al zijn ID, titel, beschrijving, ernst, status, geraakte sessies, stappen om te reproduceren en de tijden van eerste en laatste waarneming. Severity in de trigger moet exact overeenkomen, dus High omvat geen Critical; bouw twee workflows of kies Any en filter met een IF-node. Lees hoe je sessie-replays omzet in bugrapporten voor wat een goede taak moet bevatten.

Waar moet een nieuwe bug naartoe?
Flowsery doet het voor je
  • Berichten in Slack
  • Tickets in Linear
  • Tickets in Jira
Gebruik n8n
  • ClickUp, Asana of Trello
  • GitHub Issues, Microsoft Teams of Discord
  • Flowsery Trigger start de workflow
Begin met de ingebouwde opties en grijp alleen naar n8n als het issue in een andere tool thuishoort.

Workflow 3: registreer verkopen en aanmeldingen die Flowsery niet ziet

Flowsery koppelt Stripe, Paddle, Polar en Lemon Squeezy met één klik, zoals de pagina omzettracking laat zien. Betalingen en conversies van elders, zoals een facturatietool, een deal die in het CRM als gewonnen is gemarkeerd of een geboekte demo, komen in Flowsery terecht via Payment > Track en Goal > Track.

  1. Een trigger uit de bronapp, of een node Webhook, start de workflow.
  2. Flowsery, Payment > Track zet Amount in hele eenheden, zoals 49.00. Zet onder Additional Fields Currency op een ISO-code zoals EUR, Transaction Reference op het factuur- of bestelnummer, en Renewal of Refund als die van toepassing zijn.
  3. Voor een aanmelding of een gewonnen deal zet Flowsery, Goal > Track een Goal Name zoals deal_won en tot 10 metadata-eigenschappen.
  4. Geeft je formulier of checkout de waarde door van de cookie _fs_vid die het Flowsery-script zet, koppel die dan aan Visitor UID, zodat het event op de tijdlijn van die bezoeker terechtkomt, naast diens verkeersbron.

Twee details besparen je later opruimwerk. Zonder Currency slaat Flowsery de betaling op in USD, niet in de valuta van de website. En een Transaction Reference die al eerder is vastgelegd, mislukt met een 409-fout in plaats van een tweede betaling aan te maken, dus je hebt er één per betaling nodig, en je hebt hem nodig om de betaling later te verwijderen. Doelnamen bestaan uit kleine letters, cijfers, underscores en koppeltekens, tot 64 tekens. De pagina doel- en eventtracking legt uit hoe doelen in rapporten verschijnen.

Workflow 4: laat een AI-agent in n8n verkeersvragen beantwoorden

De Flowsery-node is gemarkeerd als bruikbaar als tool, dus een node AI Agent in n8n kan hem aanroepen. Koppel één Flowsery-tool per soort vraag, bijvoorbeeld Get Overview en Get Breakdown, en de agent kiest de call en de filters als iemand in Slack of Telegram vraagt: "Op welke pagina's kwamen mobiele bezoekers uit Duitsland vorige week binnen?"

Op een self-hosted instantie biedt n8n community-nodes alleen als agenttools aan als de omgevingsvariabele N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE op true staat. Elk Flowsery-token heeft de rol Admin of Editor, dus beperk wat de agent kan via de operaties die je koppelt: een agent met alleen leestools kan geen doelen registreren en geen issue wijzigen.

Welke fouten geeft de Flowsery-node terug?

De Flowsery-node geeft de eigen foutcode van de API terug, en vier daarvan zijn goed voor bijna elke mislukte run.

FoutWat het betekentWat je doet
401 token_issuer_lost_accessHet teamlid dat het token aanmaakte heeft de workspace verlaten of is gedeactiveerdMaak een nieuw token aan
403 permission_deniedDe rol van het token mist flowsery.writeGebruik een token met Admin of Editor
403 subscription_requiredHet abonnement van de workspace bevat geen API-toegang meerControleer het abonnement in de facturering van Flowsery
403 Upgrade to view this issueHet issue valt buiten de eerste 10 van de gratis proefperiodeStart een betaald abonnement

De limiet van de gratis proefperiode raakt ook de trigger. Tijdens een proefperiode toont de API alleen de eerste 10 issues, dus de Flowsery Trigger gaat niet meer af zodra die bestaan.

Wat zijn de alternatieven voor n8n bij Flowsery?

Flowsery werkt ook met Zapier, met ChatGPT en Claude via de MCP-server, en vanuit de terminal via de Flowsery CLI. De pagina over AI-agents zet de opties naast elkaar.

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Kies n8n als je de workflow op je eigen server wilt, gekoppeld aan je andere systemen. Zapier heeft geen server nodig, en de gids over Zapier-analytics behandelt de trigger, acties en zoekopdrachten. In ChatGPT beantwoordt de Flowsery-plugin voor analytics in ChatGPT dezelfde vragen vanuit een chat. Voor je eigen scripts documenteert de API-referentie van Flowsery elk endpoint dat de node aanroept.

Veelgestelde vragen

Is er een n8n-node voor Flowsery?

Flowsery publiceert de community-node n8n-nodes-flowsery op npm. Die voegt een Flowsery-node toe met de resources Analytics, Issue, Goal, Payment, Visitor en Website, en een Flowsery Trigger die afgaat bij nieuwe issues. Installeer hem op pakketnaam onder Settings > Community nodes.

Werkt de Flowsery-node op n8n Cloud?

De README van de node behandelt n8n Cloud niet, dus deze gids gebruikt een self-hosted n8n-instantie. De README noemt n8n 1.100 en hoger als getest.

Welk Flowsery-token heeft een n8n-workflow nodig?

Een n8n-workflow heeft een Flowsery-workspacetoken nodig met de rol Admin of Editor, aangemaakt op flowsery.com/api-tokens, of een websitesleutel uit Settings > API. Elke call naar de Flowsery-API controleert de permissie flowsery.write, die de rollen Viewer en Contributor niet hebben.

Kan n8n me waarschuwen als Flowsery een bug vindt?

De Flowsery Trigger start een n8n-workflow één keer voor elk nieuw open issue dat Flowsery in sessie-opnames vindt. Je kunt hem beperken tot één website en één ernst. Elk issue komt binnen met titel, ernst, geraakte sessies en stappen om te reproduceren, en Issue > Get voegt de sessies en opmerkingen erachter toe.

Waarom heeft Flowsery mijn betaling in USD opgeslagen?

Payment > Track stuurt Currency alleen mee als je het invult, en zonder slaat Flowsery de betaling op in USD, niet in de valuta van de website. Zet Currency onder Additional Fields op een ISO 4217-code zoals EUR.

Kan ik een betaling verwijderen die ik per ongeluk vanuit n8n heb gestuurd?

De call DELETE /payments van de Flowsery-API verwijdert één betaling op basis van de transactie-ID, of alle betalingen van één bezoeker of uit één periode. De n8n-node heeft geen verwijderoperatie, dus stuur bij elke call van Payment > Track een Transaction Reference mee; met die ID verwijder je later één betaling via de API of een node HTTP Request.

Wat kost de n8n-integratie van Flowsery?

De n8n-integratie zit in het Team-abonnement ($250 per maand) en het Pro-abonnement ($500 per maand) van Flowsery. Beide abonnementen beginnen met een gratis proefperiode van 14 dagen zonder creditcard. De community-node zelf staat op npm.

Hoe installeer ik de Flowsery-node in n8n?

Open Settings > Community nodes > Install in je self-hosted n8n en typ n8n-nodes-flowsery als pakketnaam. Bevestig de melding over communitycode en klik op Install. Daarna verschijnen de nodes Flowsery en Flowsery Trigger in het nodepaneel.

Wat doet de Flowsery Trigger bij de eerste run?

De eerste poll nadat je de workflow activeert, legt alleen de issues vast die al bestaan. Daarna start hij de workflow voor issues die verschijnen, één keer voor elk nieuw open issue. Een oude achterstand overspoelt je workflow nooit.

Waarom gaat mijn Flowsery Trigger niet meer af?

Tijdens een gratis proefperiode toont de API alleen de eerste 10 issues, dus de trigger gaat niet meer af zodra die bestaan. Een betaald abonnement heft die limiet op. Controleer ook de instelling Severity, want die moet exact overeenkomen en High omvat geen Critical.

Was dit artikel nuttig?

Laat ons weten wat je ervan vindt!

Zie ons vaker in Google

Met één klik markeer je Flowsery als voorkeursbron, zodat onze artikelen hoger staan in je Topverhalen, AI-modus en AI-overzichten.

Voordat je gaat...

Flowsery

Flowsery

Analytics voor je website, met omzet voorop

Volg elke bezoeker, bron en conversie in realtime. Eenvoudig, krachtig en zonder cookies.

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Gerelateerde artikelen