So richten Sie n8n-Analytics-Workflows mit dem Flowsery-Node ein

Gute n8n-Analytics-Workflows beantworten zwei Fragen, ohne dass jemand ein Dashboard öffnet: Wie lief die Website letzte Woche, und ist für Besucher etwas kaputtgegangen? n8n spricht bereits mit Ihrem Posteingang, Ihrem Chat, Ihrem CRM und Ihrem Task-Tracker. Was von Haus aus fehlt, ist ein Node, der cookielose Traffic-Zahlen, Umsatz und die in Sitzungsaufzeichnungen gefundenen Bugs liest. Der Community-Node von Flowsery ist dieser Node.

Diese Anleitung behandelt die Installation, die Credential, jede Operation und vier Workflows zum Kopieren. Wir bauen Flowsery, und alles unten entspricht Version 0.2.0 des Nodes.

Kurzfassung: Installieren Sie n8n-nodes-flowsery unter Settings > Community nodes, erstellen Sie unter flowsery.com/api-tokens ein Workspace-Token mit der Rolle Admin oder Editor, fügen Sie es in die Credential "Flowsery API" ein und wählen Sie Ihre Website im Feld Website jedes Nodes.

Was brauchen Sie, um Flowsery mit n8n zu verbinden?

Sie brauchen eine selbst gehostete n8n-Instanz, eine Flowsery-Website mit installiertem Tracking-Skript und ein Flowsery-Workspace-Token. Die README des Nodes nennt n8n 1.100 und neuer als getestet und deckt n8n Cloud nicht ab, deshalb nutzt diese Anleitung eine selbst gehostete Instanz.

Das Paket liegt auf npm als n8n-nodes-flowsery. Es steht nicht im eigenen Integrationsverzeichnis von n8n, Sie installieren es also über den Paketnamen. Der Team-Plan von Flowsery ($250 im Monat) und der Pro-Plan ($500 im Monat) enthalten beide die n8n-Integration, und beide beginnen mit einer 14-tägigen kostenlosen Testphase ohne Karte.

Wie installieren Sie den Flowsery-Node in n8n?

Installieren Sie ihn im n8n-Editor unter Settings > Community nodes > Install. Geben Sie n8n-nodes-flowsery als Paketnamen ein, bestätigen Sie den Hinweis zur Installation von Community-Code und klicken Sie auf Install. n8n lädt das Paket von npm und fügt dem Node-Panel zwei Nodes hinzu: Flowsery und Flowsery Trigger.

Suchen Sie im Node-Panel nach "Flowsery", um zu prüfen, ob die Installation geklappt hat.

Wie verbinden Sie Ihr Flowsery-Konto mit n8n?

Sie verbinden Flowsery mit n8n über ein Geheimnis, das Sie in das Feld API Token einer neuen Credential "Flowsery API" einfügen. n8n sendet es als Bearer-Token und testet es mit einer Anfrage an GET /websites, eine gespeicherte Credential heißt also, dass das Geheimnis funktioniert.

Geheimnis	Wo Sie es erstellen	Beginnt mit	Was es erreicht
Workspace-Token	flowsery.com/api-tokens	flow_ws_	Jede Website im Workspace
Website-Schlüssel	Settings > API in einer Website	flow_	Genau diese eine Website

Mit einem Workspace-Token braucht jeder Node das Feld Website, das Ihre Sites nach Domain lädt. Mit einem Website-Schlüssel können Sie Website leer lassen.

Wählen Sie Admin oder Editor als Rolle des Tokens. Jeder Aufruf der Flowsery-API prüft die Berechtigung flowsery.write, und nur diese beiden Rollen haben sie, ein Token mit der Rolle Viewer oder Contributor wird also mit permission_denied abgelehnt. Ein Token darf außerdem nie mehr als das Mitglied, das es erstellt hat.

Was kann der Flowsery-Node?

Der Flowsery-Node hat sechs Ressourcen, und der Flowsery Trigger startet einen Workflow, wenn Flowsery ein neues Issue findet.

Ressource	Operationen
Analytics	Get Overview, Get Timeseries, Get Realtime Visitors, Get Breakdown
Issue	Get Many, Get, Update Status
Goal	Get Many, Track
Payment	Track
Visitor	Get
Website	Get Many

Get Overview liefert eine Zeile für einen Zeitraum: Besucher, Sitzungen, Absprungrate, durchschnittliche Sitzungsdauer, Umsatz, Umsatz pro Besucher und Conversion-Rate. Get Timeseries gruppiert Besucher, Sitzungen und Umsatz nach Stunde, Tag, Woche oder Monat. Get Breakdown teilt Besucher nach einer von 25 Dimensionen auf, darunter Seite, Einstiegsseite, Referrer, Kanal, Kampagne, Land, Region, Stadt, Gerät, Browser, die fünf UTM-Parameter und Ziel.

Jeder Lesezugriff nimmt Start Date, End Date und Timezone. Der Zeitraum steht standardmäßig auf den letzten 30 Tagen, die Zeitzone auf der der Website. Limit nimmt 1 bis 1000 Zeilen. Get Overview, Get Timeseries, Get Breakdown und Goal > Get Many nehmen außerdem Filters, 20 Stück, einen pro filter_*-Parameter der Flowsery-API. Filterwerte entsprechen exakt den Breakdown-Zeilen: ein voller Regionsname wie California, ein Gerät Desktop, Mobile oder Tablet und ein Referrer-Quellname wie Google.

Issue > Get Many listet die Issues, die die KI von Flowsery in Sitzungsaufzeichnungen gefunden hat, mit Suche, Schweregrad, Status und Sortierung nach Aktualität oder Schweregrad. Issue > Get ergänzt Beschreibung, Schritte zur Reproduktion, Sitzungen und Kommentare. Update Status setzt ein Issue auf Open, In Progress, Resolved oder Suspended.

Visitor > Get liefert das Profil eines Besuchers mit einer Aktivitäts-Timeline. Goal > Track und Payment > Track schreiben Ereignisse in Ihre Analytics, beschrieben im dritten Workflow unten.

Der Flowsery Trigger fragt neue offene Issues ab und feuert einmal pro Issue. Sie können ihn auf eine Website und einen Schweregrad beschränken. Die erste Abfrage nach dem Aktivieren des Workflows merkt sich nur die Issues, die schon existieren, ein alter Rückstau überflutet den Workflow also nicht.

Workflow 1: einen wöchentlichen Traffic-Bericht senden

Dieser Workflow sendet jeden Montagmorgen die Zahlen der letzten Woche im Vergleich zur Woche davor.

1. Schedule Trigger läuft jeden Montag um 9:00.
2. Flowsery, Analytics > Get Overview setzt Start Date auf {{ $now.minus({ days: 7 }) }}, End Date auf {{ $now }} und Timezone auf einen IANA-Namen wie Europe/Berlin.
3. Ein zweites Get Overview deckt die Woche davor ab, von {{ $now.minus({ days: 14 }) }} bis {{ $now.minus({ days: 7 }) }}.
4. Flowsery, Analytics > Get Breakdown nutzt Dimension Referrer und Limit 5 über die letzte Woche, um zu zeigen, woher Besucher kamen.
5. Merge führt die Ausgaben zusammen, und ein Node Send Email, Slack oder Telegram verschickt die Zusammenfassung.

Fügen Sie einen vierten Flowsery-Node mit Dimension Page hinzu, wenn der Bericht auch die Top-Seiten nennen soll. Unser Leitfaden zum Website-Analytics-Reporting zeigt, welche Zahlen in eine wöchentliche E-Mail gehören.

Workflow 2: aus einem neuen Bug eine Aufgabe in Ihrem Tracker machen

Flowsery sendet Issues schon selbst an Slack und legt Tickets in Linear und Jira an, wie auf der Seite zu automatischen Bug-Tickets beschrieben. Nutzen Sie n8n, wenn das Issue woanders hingehört, etwa in ClickUp, Asana, Trello, GitHub Issues, Microsoft Teams oder Discord.

1. Flowsery Trigger beobachtet Ihre Website, mit Severity auf High oder Critical, oder Any.
2. Flowsery, Issue > Get nimmt Issue ID {{ $json.id }} und ergänzt jedes Vorkommen, die Sitzungen hinter dem Issue und seine Kommentare.
3. Ein Node ClickUp, Asana oder Trello erstellt die Aufgabe mit Titel, Schweregrad, Zahl der betroffenen Sitzungen und Schritten zur Reproduktion.
4. Flowsery, Issue > Update Status setzt das Issue auf In Progress, damit die Issue-Liste in Flowsery zeigt, dass sich jemand darum kümmert.

Jedes Issue aus dem Trigger bringt bereits ID, Titel, Beschreibung, Schweregrad, Status, betroffene Sitzungen, Schritte zur Reproduktion sowie den Zeitpunkt des ersten und letzten Auftretens mit. Severity im Trigger gilt exakt, High schließt Critical also nicht ein; bauen Sie zwei Workflows oder setzen Sie Any und filtern Sie mit einem IF-Node. Lesen Sie, wie Sie aus Session Replays Bug-Reports machen, um zu sehen, was eine gute Aufgabe enthalten sollte.

Wohin gehört ein neuer Bug?

Flowsery erledigt es für Sie

• Slack-Nachrichten
• Linear-Tickets
• Jira-Tickets

n8n verwenden

• ClickUp, Asana oder Trello
• GitHub Issues, Microsoft Teams oder Discord
• Der Flowsery Trigger startet den Workflow

Workflow 3: Verkäufe und Anmeldungen erfassen, die Flowsery nicht sieht

Flowsery verbindet Stripe, Paddle, Polar und Lemon Squeezy mit einem Klick, wie die Seite zum Umsatz-Tracking zeigt. Zahlungen und Conversions von überall sonst, etwa aus einem Rechnungstool, ein im CRM als gewonnen markierter Deal oder eine gebuchte Demo, erreichen Flowsery über Payment > Track und Goal > Track.

1. Ein Trigger aus der Quell-App oder ein Webhook-Node startet den Workflow.
2. Flowsery, Payment > Track setzt Amount in Haupteinheiten, etwa 49.00. Setzen Sie unter Additional Fields Currency auf einen ISO-Code wie EUR, Transaction Reference auf die Rechnungs- oder Bestellnummer und Renewal oder Refund, wenn sie zutreffen.
3. Für eine Anmeldung oder einen gewonnenen Deal setzt Flowsery, Goal > Track einen Goal Name wie deal_won und bis zu 10 Metadaten-Eigenschaften.
4. Wenn Ihr Formular oder Checkout den Wert des Cookies _fs_vid mitgibt, das das Flowsery-Skript setzt, ordnen Sie ihn Visitor UID zu, damit das Ereignis in der Timeline dieses Besuchers neben seiner Traffic-Quelle landet.

Zwei Details ersparen Ihnen später das Aufräumen. Ohne Currency speichert Flowsery die Zahlung in USD, nicht in der Währung der Website. Und eine Transaction Reference, die schon erfasst wurde, scheitert mit einem 409-Fehler, statt eine zweite Zahlung anzulegen, Sie brauchen also eine pro Zahlung, und Sie brauchen sie, um die Zahlung später zu löschen. Zielnamen bestehen aus Kleinbuchstaben, Ziffern, Unterstrichen und Bindestrichen, bis zu 64 Zeichen. Die Seite zum Ziel- und Event-Tracking erklärt, wie Ziele in Berichten erscheinen.

Workflow 4: einen n8n-KI-Agenten Traffic-Fragen beantworten lassen

Der Flowsery-Node ist als Tool nutzbar markiert, ein n8n-Node AI Agent kann ihn also aufrufen. Hängen Sie pro Fragetyp ein Flowsery-Tool an, zum Beispiel Get Overview und Get Breakdown, und der Agent wählt Aufruf und Filter, wenn jemand in Slack oder Telegram fragt: "Auf welchen Seiten sind mobile Besucher aus Deutschland letzte Woche gelandet?"

Auf einer selbst gehosteten Instanz bietet n8n Community-Nodes nur dann als Agenten-Tools an, wenn die Umgebungsvariable N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE auf true steht. Jedes Flowsery-Token trägt die Rolle Admin oder Editor, begrenzen Sie also über die angehängten Operationen, was der Agent tun kann: Ein Agent mit nur lesenden Tools kann keine Ziele erfassen und kein Issue ändern.

Welche Fehler gibt der Flowsery-Node zurück?

Der Flowsery-Node gibt den Fehlercode der API selbst zurück, und vier davon erklären fast jeden fehlgeschlagenen Lauf.

Fehler	Was er bedeutet	Was zu tun ist
401 token_issuer_lost_access	Das Mitglied, das das Token erstellt hat, hat den Workspace verlassen oder wurde deaktiviert	Ein neues Token erstellen
403 permission_denied	Der Rolle des Tokens fehlt flowsery.write	Ein Token mit Admin oder Editor nutzen
403 subscription_required	Der Workspace-Plan enthält keinen API-Zugriff mehr	Den Plan in der Flowsery-Abrechnung prüfen
403 Upgrade to view this issue	Das Issue liegt hinter den ersten 10 der kostenlosen Testphase	Einen bezahlten Plan starten

Die Grenze der Testphase betrifft auch den Trigger. In der Testphase listet die API nur die ersten 10 Issues, der Flowsery Trigger feuert also nicht mehr, sobald diese existieren.

Welche Alternativen zu n8n gibt es für Flowsery?

Flowsery funktioniert auch mit Zapier, mit ChatGPT und Claude über seinen MCP-Server und im Terminal über die Flowsery CLI. Die Seite zu KI-Agenten zeigt die Setups nebeneinander.

Wählen Sie n8n, wenn der Workflow auf Ihrem eigenen Server laufen und mit Ihren anderen Systemen verkettet sein soll. Zapier braucht keinen Server, und der Leitfaden zu Zapier-Analytics behandelt Trigger, Aktionen und Suchen. In ChatGPT beantwortet das ChatGPT-Analytics-Plugin von Flowsery dieselben Fragen aus einem Chat. Für Ihre eigenen Skripte dokumentiert die Flowsery-API-Referenz jeden Endpunkt, den der Node aufruft.

Häufig gestellte Fragen

Gibt es einen n8n-Node für Flowsery?

Flowsery veröffentlicht den Community-Node n8n-nodes-flowsery auf npm. Er fügt einen Flowsery-Node mit den Ressourcen Analytics, Issue, Goal, Payment, Visitor und Website hinzu sowie einen Flowsery Trigger, der bei neuen Issues feuert. Installieren Sie ihn über den Paketnamen unter Settings > Community nodes.

Funktioniert der Flowsery-Node auf n8n Cloud?

Die README des Nodes deckt n8n Cloud nicht ab, deshalb nutzt diese Anleitung eine selbst gehostete n8n-Instanz. Die README nennt n8n 1.100 und neuer als getestet.

Welches Flowsery-Token braucht ein n8n-Workflow?

Ein n8n-Workflow braucht ein Flowsery-Workspace-Token mit der Rolle Admin oder Editor, erstellt unter flowsery.com/api-tokens, oder einen Website-Schlüssel aus Settings > API. Jeder Aufruf der Flowsery-API prüft die Berechtigung flowsery.write, die den Rollen Viewer und Contributor fehlt.

Kann n8n mich benachrichtigen, wenn Flowsery einen Bug findet?

Der Flowsery Trigger startet einen n8n-Workflow einmal für jedes neue offene Issue, das Flowsery in Sitzungsaufzeichnungen findet. Sie können ihn auf eine Website und einen Schweregrad beschränken. Jedes Issue kommt mit Titel, Schweregrad, betroffenen Sitzungen und Schritten zur Reproduktion an, und Issue > Get ergänzt die Sitzungen und Kommentare dahinter.

Warum hat Flowsery meine Zahlung in USD gespeichert?

Payment > Track sendet Currency nur, wenn Sie das Feld ausfüllen, und ohne Currency speichert Flowsery die Zahlung in USD, nicht in der Währung der Website. Setzen Sie Currency unter Additional Fields auf einen ISO-4217-Code wie EUR.

Kann ich eine Zahlung löschen, die ich versehentlich aus n8n gesendet habe?

Der Aufruf DELETE /payments der Flowsery-API entfernt eine Zahlung über ihre Transaktions-ID oder alle Zahlungen eines Besuchers oder eines Zeitraums. Der n8n-Node hat keine Löschoperation, senden Sie also bei jedem Aufruf von Payment > Track eine Transaction Reference; über diese ID entfernen Sie später eine einzelne Zahlung per API oder mit einem HTTP-Request-Node.

Was kostet die Flowsery-Integration für n8n?

Die n8n-Integration ist im Team-Plan von Flowsery ($250 im Monat) und im Pro-Plan ($500 im Monat) enthalten. Beide Pläne beginnen mit einer 14-tägigen kostenlosen Testphase, für die Sie keine Karte brauchen. Der Community-Node selbst liegt auf npm.

Wie installiere ich den Flowsery-Node in n8n?

Öffnen Sie in Ihrem selbst gehosteten n8n Settings > Community nodes > Install und geben Sie n8n-nodes-flowsery als Paketnamen ein. Bestätigen Sie den Hinweis zu Community-Code und klicken Sie auf Install. Danach erscheinen die Nodes Flowsery und Flowsery Trigger im Node-Panel.

Was macht der Flowsery Trigger beim ersten Durchlauf?

Die erste Abfrage nach der Aktivierung des Workflows speichert nur die Issues, die bereits existieren. Danach startet er den Workflow für jedes neue offene Issue einmal. Ein alter Rückstau überflutet Ihren Workflow also nicht.

Warum feuert mein Flowsery Trigger nicht mehr?

In der kostenlosen Testphase listet die API nur die ersten 10 Issues auf, deshalb feuert der Trigger nicht mehr, sobald diese existieren. Ein bezahlter Plan hebt diese Grenze auf. Prüfen Sie auch die Einstellung Severity, denn sie gilt exakt und High schließt Critical nicht ein.