Comment créer des workflows d'analytics avec n8n grâce au node Flowsery

De bons workflows d'analytics avec n8n répondent à deux questions sans que personne n'ouvre un tableau de bord : comment le site s'est-il comporté la semaine dernière, et quelque chose a-t-il cassé pour les visiteurs ? n8n communique déjà avec votre boîte mail, votre chat, votre CRM et votre outil de suivi des tâches. Ce qui lui manque d'origine, c'est un node qui lit les chiffres de trafic sans cookies, les revenus et les bugs trouvés dans les enregistrements de session. Le community node Flowsery est ce node.

Ce guide couvre l'installation, la credential, chaque opération et quatre workflows à copier. Nous développons Flowsery, et tout ce qui suit correspond à la version 0.2.0 du node.

En bref : installez n8n-nodes-flowsery sous Settings > Community nodes, créez un token de workspace sur flowsery.com/api-tokens avec le rôle Admin ou Editor, collez-le dans la credential Flowsery API, et choisissez votre site dans le champ Website de chaque node.

De quoi avez-vous besoin pour connecter Flowsery à n8n ?

Il vous faut une instance n8n auto-hébergée, un site Flowsery avec le script de suivi installé, et un token de workspace Flowsery. Le README du node indique n8n 1.100 et les versions suivantes comme testées et ne couvre pas n8n Cloud : ce guide utilise donc une instance auto-hébergée.

Le package est sur npm sous le nom n8n-nodes-flowsery. Il ne figure pas dans l'annuaire d'intégrations de n8n, donc vous l'installez par son nom de package. Le forfait Team de Flowsery ($250 par mois) et le forfait Pro ($500 par mois) incluent tous deux l'intégration n8n, et tous deux commencent par un essai gratuit de 14 jours sans carte.

Comment installer le node Flowsery dans n8n ?

Installez-le depuis l'éditeur n8n sous Settings > Community nodes > Install. Saisissez n8n-nodes-flowsery comme nom de package, confirmez l'avertissement sur l'installation de code communautaire, puis cliquez sur Install. n8n télécharge le package depuis npm et ajoute deux nodes au panneau des nodes : Flowsery et Flowsery Trigger.

Cherchez "Flowsery" dans le panneau des nodes pour vérifier que l'installation a fonctionné.

Comment connecter votre compte Flowsery à n8n ?

Vous connectez Flowsery à n8n avec un seul secret, collé dans le champ API Token d'une nouvelle credential Flowsery API. n8n l'envoie comme token Bearer et le teste avec une requête GET /websites : une credential enregistrée signifie donc que le secret fonctionne.

Secret	Où le créer	Commence par	Ce qu'il atteint
Token de workspace	flowsery.com/api-tokens	flow_ws_	Tous les sites du workspace
Clé de site	Settings > API dans un site	flow_	Ce seul site

Avec un token de workspace, chaque node a besoin du champ Website, qui charge vos sites par domaine. Avec une clé de site, vous pouvez laisser Website vide.

Choisissez Admin ou Editor comme rôle du token. Chaque appel à l'API Flowsery vérifie la permission flowsery.write, et seuls ces deux rôles la détiennent : un token Viewer ou Contributor est donc refusé avec permission_denied. Un token ne fait jamais non plus plus que le membre qui l'a créé.

Que peut faire le node Flowsery ?

Le node Flowsery a six ressources, et le Flowsery Trigger lance un workflow quand Flowsery trouve un nouveau problème.

Ressource	Opérations
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 renvoie une ligne pour une période : visiteurs, sessions, taux de rebond, durée moyenne de session, revenus, revenus par visiteur et taux de conversion. Get Timeseries regroupe visiteurs, sessions et revenus par heure, jour, semaine ou mois. Get Breakdown ventile les visiteurs selon l'une des 25 dimensions, dont la page, la page d'entrée, le référent, le canal, la campagne, le pays, la région, la ville, l'appareil, le navigateur, les cinq paramètres UTM et l'objectif.

Chaque lecture prend Start Date, End Date et Timezone. Les dates couvrent par défaut les 30 derniers jours, et le fuseau horaire est par défaut celui du site. Limit accepte de 1 à 1000 lignes. Get Overview, Get Timeseries, Get Breakdown et Goal > Get Many prennent aussi des Filters, 20 au total, un par paramètre filter_* de l'API Flowsery. Les valeurs de filtre correspondent exactement aux lignes de ventilation : un nom de région complet comme California, un appareil Desktop, Mobile ou Tablet, et un nom de source de référence comme Google.

Issue > Get Many liste les problèmes que l'IA de Flowsery a trouvés dans les enregistrements de session, avec une recherche, la sévérité, le statut et un tri par date ou par sévérité. Issue > Get ajoute la description, les étapes pour reproduire, les sessions et les commentaires. Update Status fait passer un problème à Open, In Progress, Resolved ou Suspended.

Visitor > Get renvoie le profil d'un visiteur avec une chronologie de son activité. Goal > Track et Payment > Track écrivent des événements dans votre analytics, comme le montre le troisième workflow ci-dessous.

Le Flowsery Trigger interroge Flowsery à intervalles réguliers pour trouver les nouveaux problèmes ouverts et se déclenche une fois par problème. Vous pouvez le limiter à un site et à une sévérité. La première interrogation après l'activation du workflow se contente d'enregistrer les problèmes qui existent déjà, pour qu'un ancien backlog n'inonde pas le workflow.

Workflow 1 : envoyer un rapport de trafic hebdomadaire

Ce workflow envoie chaque lundi matin les chiffres de la semaine passée, comparés à ceux de la semaine d'avant.

1. Schedule Trigger s'exécute chaque lundi à 9:00.
2. Flowsery, Analytics > Get Overview règle Start Date sur {{ $now.minus({ days: 7 }) }}, End Date sur {{ $now }} et Timezone sur un nom IANA comme Europe/Berlin.
3. Un second Get Overview couvre la semaine d'avant, de {{ $now.minus({ days: 14 }) }} à {{ $now.minus({ days: 7 }) }}.
4. Flowsery, Analytics > Get Breakdown utilise la Dimension Referrer et une Limit de 5 sur la semaine passée, pour montrer d'où venaient les visiteurs.
5. Merge réunit les sorties, et un node Send Email, Slack ou Telegram envoie le résumé.

Ajoutez un quatrième node Flowsery avec la Dimension Page si le rapport doit aussi citer les pages principales. Notre guide sur le reporting d'analytics web indique quels chiffres ont leur place dans un e-mail hebdomadaire.

Workflow 2 : transformer un nouveau bug en tâche dans votre outil de suivi

Flowsery envoie déjà les problèmes dans Slack et crée lui-même des tickets dans Linear et Jira, comme le décrit la page des tickets de bugs automatiques. Utilisez n8n quand le problème doit aller ailleurs, par exemple dans ClickUp, Asana, Trello, GitHub Issues, Microsoft Teams ou Discord.

1. Flowsery Trigger surveille votre site, avec Severity réglé sur High ou Critical, ou sur Any.
2. Flowsery, Issue > Get prend l'Issue ID {{ $json.id }} et ajoute chaque occurrence, les sessions derrière le problème et ses commentaires.
3. Un node ClickUp, Asana ou Trello crée la tâche avec le titre, la sévérité, le nombre de sessions touchées et les étapes pour reproduire.
4. Flowsery, Issue > Update Status fait passer le problème à In Progress, pour que la liste des problèmes de Flowsery montre que quelqu'un s'en occupe.

Chaque problème issu du trigger porte déjà son ID, son titre, sa description, sa sévérité, son statut, les sessions touchées, les étapes pour reproduire et ses dates de première et de dernière apparition. Dans le trigger, la sévérité doit correspondre exactement, donc High n'inclut pas Critical : créez deux workflows, ou choisissez Any et filtrez avec un node IF. Lisez comment transformer les session replays en rapports de bugs pour savoir ce qu'une bonne tâche doit contenir.

Où doit aller un nouveau bug ?

Flowsery s'en charge pour vous

• Messages Slack
• Tickets Linear
• Tickets Jira

Utilisez n8n

• ClickUp, Asana ou Trello
• GitHub Issues, Microsoft Teams ou Discord
• Le Flowsery Trigger démarre le workflow

Workflow 3 : enregistrer les ventes et les inscriptions que Flowsery ne voit pas

Flowsery connecte Stripe, Paddle, Polar et Lemon Squeezy en un clic, comme le montre la page du suivi des revenus. Les paiements et les conversions venus d'ailleurs, comme un outil de facturation, une affaire gagnée dans un CRM ou une démo réservée, arrivent dans Flowsery via Payment > Track et Goal > Track.

1. Un trigger de l'app source, ou un node Webhook, lance le workflow.
2. Flowsery, Payment > Track règle Amount en unités principales, comme 49.00. Sous Additional Fields, réglez Currency sur un code ISO comme EUR, Transaction Reference sur le numéro de facture ou de commande, et Renewal ou Refund quand ils s'appliquent.
3. Pour une inscription ou une affaire gagnée, Flowsery, Goal > Track définit un Goal Name comme deal_won et jusqu'à 10 propriétés de métadonnées.
4. Si votre formulaire ou votre checkout transmet la valeur du cookie _fs_vid que pose le script Flowsery, associez-la à Visitor UID : l'événement arrive alors sur la chronologie de ce visiteur, à côté de sa source de trafic.

Deux détails évitent un nettoyage plus tard. Sans Currency, Flowsery enregistre le paiement en USD, et non dans la devise du site. Et une Transaction Reference déjà enregistrée échoue avec une erreur 409 au lieu de créer un second paiement : il en faut donc une par paiement, et elle vous sert aussi à supprimer le paiement plus tard. Les noms d'objectifs acceptent les lettres minuscules, les chiffres, les underscores et les tirets, jusqu'à 64 caractères. La page du suivi des objectifs et des événements explique comment les objectifs apparaissent dans les rapports.

Workflow 4 : laisser un agent IA n8n répondre aux questions de trafic

Le node Flowsery est marqué comme utilisable en tant qu'outil, donc un node AI Agent de n8n peut l'appeler. Attachez un outil Flowsery par type de question, par exemple Get Overview et Get Breakdown, et l'agent choisit l'appel et les filtres quand quelqu'un demande dans Slack ou Telegram "Sur quelles pages sont arrivés les visiteurs mobiles d'Allemagne la semaine dernière ?".

Sur une instance auto-hébergée, n8n ne propose les community nodes comme outils d'agent que si la variable d'environnement N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE vaut true. Chaque token Flowsery porte le rôle Admin ou Editor : limitez donc ce que l'agent peut faire par les opérations que vous attachez. Un agent qui n'a que des outils de lecture ne peut ni suivre des objectifs ni modifier un problème.

Quelles erreurs le node Flowsery renvoie-t-il ?

Le node Flowsery renvoie le code d'erreur de l'API elle-même, et quatre d'entre eux expliquent presque toutes les exécutions en échec.

Erreur	Ce qu'elle signifie	Que faire
401 token_issuer_lost_access	Le membre qui a créé le token a quitté le workspace ou a été désactivé	Créez un nouveau token
403 permission_denied	Le rôle du token n'a pas flowsery.write	Utilisez un token Admin ou Editor
403 subscription_required	Le forfait du workspace n'inclut plus l'accès à l'API	Vérifiez le forfait dans la facturation Flowsery
403 Upgrade to view this issue	Le problème dépasse les 10 premiers de l'essai gratuit	Passez à un forfait payant

La limite de l'essai gratuit touche aussi le trigger. Pendant l'essai, l'API ne liste que les 10 premiers problèmes, donc le Flowsery Trigger cesse de se déclencher une fois qu'ils existent.

Quelles sont les alternatives à n8n pour Flowsery ?

Flowsery fonctionne aussi avec Zapier, avec ChatGPT et Claude via son serveur MCP, et depuis le terminal via la CLI Flowsery. La page des agents IA présente ces configurations côte à côte.

Choisissez n8n quand vous voulez le workflow sur votre propre serveur, enchaîné avec vos autres systèmes. Zapier ne demande aucun serveur, et le guide de l'analytics avec Zapier couvre son trigger, ses actions et ses recherches. Dans ChatGPT, le plugin d'analytics pour ChatGPT de Flowsery répond aux mêmes questions depuis un chat. Pour vos propres scripts, la référence de l'API Flowsery documente chaque endpoint que le node appelle.

Questions fréquentes

Existe-t-il un node n8n pour Flowsery ?

Flowsery publie le community node n8n-nodes-flowsery sur npm. Il ajoute un node Flowsery avec les ressources Analytics, Issue, Goal, Payment, Visitor et Website, et un Flowsery Trigger qui se déclenche sur les nouveaux problèmes. Installez-le par son nom de package sous Settings > Community nodes.

Le node Flowsery fonctionne-t-il sur n8n Cloud ?

Le README du node ne couvre pas n8n Cloud, donc ce guide utilise une instance n8n auto-hébergée. Le README indique n8n 1.100 et les versions suivantes comme testées.

De quel token Flowsery un workflow n8n a-t-il besoin ?

Un workflow n8n a besoin d'un token de workspace Flowsery avec le rôle Admin ou Editor, créé sur flowsery.com/api-tokens, ou d'une clé de site obtenue sous Settings > API. Chaque appel à l'API Flowsery vérifie la permission flowsery.write, que les rôles Viewer et Contributor n'ont pas.

n8n peut-il m'alerter quand Flowsery trouve un bug ?

Le Flowsery Trigger lance un workflow n8n une fois pour chaque nouveau problème ouvert que Flowsery trouve dans les enregistrements de session. Vous pouvez le limiter à un site et à une sévérité. Chaque problème arrive avec son titre, sa sévérité, les sessions touchées et les étapes pour reproduire, et Issue > Get ajoute les sessions et les commentaires qui l'accompagnent.

Pourquoi Flowsery a-t-il enregistré mon paiement en USD ?

Payment > Track n'envoie Currency que si vous le remplissez, et sans lui Flowsery enregistre le paiement en USD, et non dans la devise du site. Réglez Currency sur un code ISO 4217 comme EUR sous Additional Fields.

Puis-je supprimer un paiement envoyé par erreur depuis n8n ?

L'appel DELETE /payments de l'API Flowsery supprime un paiement par son identifiant de transaction, ou tous les paiements d'un visiteur ou d'une période. Le node n8n n'a pas d'opération de suppression : envoyez donc une Transaction Reference à chaque appel Payment > Track. C'est grâce à cet identifiant que vous supprimez ensuite un seul paiement via l'API ou un node HTTP Request.

Combien coûte l'intégration Flowsery pour n8n ?

L'intégration n8n est incluse dans le plan Team de Flowsery ($250 par mois) et dans le plan Pro ($500 par mois). Les deux plans commencent par un essai gratuit de 14 jours, sans carte bancaire. Le node communautaire se trouve sur npm.

Comment installer le node Flowsery dans n8n ?

Ouvrez Settings > Community nodes > Install dans votre n8n auto-hébergé et saisissez n8n-nodes-flowsery comme nom de paquet. Confirmez l'avertissement sur le code communautaire, puis cliquez sur Install. Les nodes Flowsery et Flowsery Trigger apparaissent ensuite dans le panneau des nodes.

Que fait le Flowsery Trigger lors de sa première exécution ?

La première interrogation après l'activation du workflow enregistre seulement les problèmes qui existent déjà. Ensuite, il démarre le workflow une fois pour chaque nouveau problème ouvert. Un ancien arriéré ne submerge donc pas votre workflow.

Pourquoi mon Flowsery Trigger ne se déclenche-t-il plus ?

Pendant l'essai gratuit, l'API ne liste que les 10 premiers problèmes, donc le trigger cesse de se déclencher une fois ceux-ci présents. Un plan payant supprime cette limite. Vérifiez aussi le réglage Severity, car il correspond exactement et High n'inclut pas Critical.