Come configurare workflow di analytics con n8n e il nodo Flowsery

Dei buoni workflow di analytics con n8n rispondono a due domande senza che nessuno apra una dashboard: com'è andato il sito la settimana scorsa, e si è rotto qualcosa per i visitatori? n8n parla già con la tua casella di posta, la tua chat, il tuo CRM e il tuo gestore di attività. Quello che gli manca di serie è un nodo che legga i numeri del traffico senza cookie, le entrate e i bug trovati nelle registrazioni delle sessioni. Il nodo community di Flowsery è quel nodo.

Questa guida copre l'installazione, la credenziale, ogni operazione e quattro workflow da copiare. Flowsery lo sviluppiamo noi, e tutto quello che segue corrisponde alla versione 0.2.0 del nodo.

In breve: installa n8n-nodes-flowsery da Settings > Community nodes, crea un token di workspace su flowsery.com/api-tokens con il ruolo Admin o Editor, incollalo nella credenziale Flowsery API e scegli il tuo sito nel campo Website di ogni nodo.

Cosa ti serve per collegare Flowsery a n8n?

Ti servono un'istanza n8n self-hosted, un sito su Flowsery con lo script di tracciamento installato e un token di workspace di Flowsery. Il README del nodo indica come testate le versioni di n8n dalla 1.100 in poi e non parla di n8n Cloud, quindi questa guida usa un'istanza self-hosted.

Il pacchetto è su npm come n8n-nodes-flowsery. Non è nella directory delle integrazioni di n8n, quindi lo installi con il nome del pacchetto. Il piano Team di Flowsery ($250 al mese) e il piano Pro ($500 al mese) includono entrambi l'integrazione con n8n, ed entrambi partono con una prova gratuita di 14 giorni senza carta.

Come si installa il nodo Flowsery in n8n?

Installalo dall'editor di n8n in Settings > Community nodes > Install. Scrivi n8n-nodes-flowsery come nome del pacchetto, conferma l'avviso sull'installazione di codice della community e clicca Install. n8n scarica il pacchetto da npm e aggiunge due nodi al pannello dei nodi: Flowsery e Flowsery Trigger.

Cerca "Flowsery" nel pannello dei nodi per verificare che l'installazione sia andata a buon fine.

Come colleghi il tuo account Flowsery a n8n?

Colleghi Flowsery a n8n con un solo segreto, incollato nel campo API Token di una nuova credenziale Flowsery API. n8n lo invia come token Bearer e lo verifica con una richiesta a GET /websites, quindi se la credenziale viene salvata il segreto funziona.

Segreto	Dove lo crei	Inizia con	Cosa raggiunge
Token di workspace	flowsery.com/api-tokens	flow_ws_	Ogni sito del workspace
Chiave del sito	Settings > API in un sito	flow_	Solo quel sito

Con un token di workspace, ogni nodo richiede il campo Website, che carica i tuoi siti per dominio. Con una chiave del sito puoi lasciare Website vuoto.

Scegli Admin o Editor come ruolo del token. Ogni chiamata all'API di Flowsery controlla il permesso flowsery.write, e solo questi due ruoli lo hanno, quindi un token Viewer o Contributor viene rifiutato con permission_denied. Un token, inoltre, non fa mai più di quanto possa fare il membro che l'ha creato.

Cosa può fare il nodo Flowsery?

Il nodo Flowsery ha sei risorse, e il Flowsery Trigger avvia un workflow quando Flowsery trova un nuovo problema.

Risorsa	Operazioni
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 restituisce una riga per un intervallo di date: visitatori, sessioni, frequenza di rimbalzo, durata media della sessione, entrate, entrate per visitatore e tasso di conversione. Get Timeseries raggruppa visitatori, sessioni ed entrate per ora, giorno, settimana o mese. Get Breakdown suddivide i visitatori secondo una di 25 dimensioni, tra cui pagina, pagina di ingresso, referrer, canale, campagna, paese, regione, città, dispositivo, browser, i cinque parametri UTM e obiettivo.

Ogni lettura accetta Start Date, End Date e Timezone. Le date sono di default gli ultimi 30 giorni, e il fuso orario è di default quello del sito. Limit accetta da 1 a 1000 righe. Get Overview, Get Timeseries, Get Breakdown e Goal > Get Many accettano anche Filters, 20 in tutto, uno per ogni parametro filter_* dell'API di Flowsery. I valori dei filtri corrispondono esattamente alle righe delle suddivisioni: il nome completo di una regione come California, un dispositivo tra Desktop, Mobile e Tablet, e il nome di una fonte referrer come Google.

Issue > Get Many elenca i problemi che l'IA di Flowsery ha trovato nelle registrazioni delle sessioni, con ricerca, gravità, stato e ordinamento per data o per gravità. Issue > Get aggiunge la descrizione, i passaggi per riprodurlo, le sessioni e i commenti. Update Status sposta un problema su Open, In Progress, Resolved o Suspended.

Visitor > Get restituisce il profilo di un visitatore con una cronologia delle attività. Goal > Track e Payment > Track scrivono eventi nella tua analytics, come spiega il terzo workflow qui sotto.

Il Flowsery Trigger controlla a intervalli regolari se ci sono nuovi problemi aperti e scatta una volta per problema. Puoi limitarlo a un sito e a una gravità. Il primo controllo dopo l'attivazione del workflow registra solo i problemi già esistenti, così un vecchio arretrato non inonda il workflow.

Workflow 1: invia un report settimanale del traffico

Questo workflow invia ogni lunedì mattina i numeri della settimana scorsa, confrontati con quelli della settimana prima.

1. Schedule Trigger parte ogni lunedì alle 9:00.
2. Flowsery, Analytics > Get Overview imposta Start Date su {{ $now.minus({ days: 7 }) }}, End Date su {{ $now }} e Timezone su un nome IANA come Europe/Berlin.
3. Un secondo Get Overview copre la settimana prima, da {{ $now.minus({ days: 14 }) }} a {{ $now.minus({ days: 7 }) }}.
4. Flowsery, Analytics > Get Breakdown usa Dimension Referrer e Limit 5 sulla settimana scorsa, per mostrare da dove sono arrivati i visitatori.
5. Merge unisce i risultati, e un nodo Send Email, Slack o Telegram invia il riepilogo.

Aggiungi un quarto nodo Flowsery con Dimension Page se il report deve indicare anche le pagine principali. La nostra guida ai report di analytics per siti web spiega quali numeri meritano un posto in un'email settimanale.

Workflow 2: trasforma un nuovo bug in un'attività nel tuo tracker

Flowsery invia già da solo i problemi su Slack e apre ticket in Linear e Jira, come descritto nella pagina sui ticket automatici per i bug. Usa n8n quando il problema va da un'altra parte, per esempio ClickUp, Asana, Trello, GitHub Issues, Microsoft Teams o Discord.

1. Flowsery Trigger osserva il tuo sito, con Severity impostato su High o Critical, oppure su Any.
2. Flowsery, Issue > Get riceve Issue ID {{ $json.id }} e aggiunge ogni occorrenza, le sessioni dietro il problema e i suoi commenti.
3. Un nodo ClickUp, Asana o Trello crea l'attività con titolo, gravità, numero di sessioni coinvolte e passaggi per riprodurlo.
4. Flowsery, Issue > Update Status porta il problema su In Progress, così l'elenco dei problemi di Flowsery mostra che qualcuno lo ha preso in carico.

Ogni problema che arriva dal trigger porta già con sé ID, titolo, descrizione, gravità, stato, sessioni coinvolte, passaggi per riprodurlo e date della prima e dell'ultima comparsa. La gravità nel trigger corrisponde in modo esatto, quindi High non include Critical: crea due workflow, oppure imposta Any e filtra con un nodo IF. Leggi come trasformare i replay delle sessioni in segnalazioni di bug per sapere cosa deve contenere una buona attività.

Dove deve andare un nuovo bug?

Ci pensa Flowsery

• Messaggi su Slack
• Ticket su Linear
• Ticket su Jira

Usa n8n

• ClickUp, Asana o Trello
• GitHub Issues, Microsoft Teams o Discord
• Il Flowsery Trigger avvia il workflow

Workflow 3: registra vendite e iscrizioni che Flowsery non vede

Flowsery collega Stripe, Paddle, Polar e Lemon Squeezy con un clic, come mostra la pagina sul tracciamento delle entrate. Pagamenti e conversioni da qualsiasi altra fonte, come uno strumento di fatturazione, una trattativa del CRM segnata come vinta o una demo prenotata, arrivano a Flowsery tramite Payment > Track e Goal > Track.

1. Un trigger dell'app di origine, o un nodo Webhook, avvia il workflow.
2. Flowsery, Payment > Track imposta Amount nell'unità principale della valuta, come 49.00. In Additional Fields imposta Currency su un codice ISO come EUR, Transaction Reference sul numero della fattura o dell'ordine, e Renewal o Refund quando servono.
3. Per un'iscrizione o una trattativa vinta, Flowsery, Goal > Track imposta un Goal Name come deal_won e fino a 10 proprietà di metadati.
4. Se il tuo modulo o il tuo checkout passa il valore del cookie _fs_vid impostato dallo script di Flowsery, mappalo su Visitor UID, così l'evento finisce nella cronologia di quel visitatore, accanto alla sua fonte di traffico.

Due dettagli ti risparmiano una pulizia in seguito. Senza Currency, Flowsery salva il pagamento in USD, non nella valuta del sito. E una Transaction Reference già registrata fallisce con un errore 409 invece di creare un secondo pagamento, quindi te ne serve una per pagamento, e ti serve anche per eliminare il pagamento in seguito. I nomi degli obiettivi accettano lettere minuscole, cifre, underscore e trattini, fino a 64 caratteri. La pagina sul tracciamento di obiettivi ed eventi spiega come gli obiettivi compaiono nei report.

Workflow 4: fai rispondere un agente IA di n8n alle domande sul traffico

Il nodo Flowsery è contrassegnato come utilizzabile come strumento, quindi un nodo AI Agent di n8n può chiamarlo. Collega uno strumento Flowsery per ogni tipo di domanda, per esempio Get Overview e Get Breakdown, e l'agente sceglie la chiamata e i filtri quando qualcuno chiede "Su quali pagine sono arrivati la settimana scorsa i visitatori da mobile dalla Germania?" su Slack o Telegram.

Su un'istanza self-hosted, n8n offre i nodi community come strumenti per gli agenti solo quando la variabile d'ambiente N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE è true. Ogni token di Flowsery ha il ruolo Admin o Editor, quindi limita quello che l'agente può fare scegliendo quali operazioni collegare: un agente con soli strumenti di lettura non può tracciare obiettivi né modificare un problema.

Quali errori restituisce il nodo Flowsery?

Il nodo Flowsery restituisce il codice di errore dell'API, e quattro codici spiegano quasi ogni esecuzione fallita.

Errore	Cosa significa	Cosa fare
401 token_issuer_lost_access	Il membro che ha creato il token ha lasciato il workspace o è stato disattivato	Crea un nuovo token
403 permission_denied	Il ruolo del token non ha flowsery.write	Usa un token Admin o Editor
403 subscription_required	Il piano del workspace non include più l'accesso all'API	Controlla il piano nella fatturazione di Flowsery
403 Upgrade to view this issue	Il problema va oltre i primi 10 della prova gratuita	Passa a un piano a pagamento

Il limite della prova gratuita riguarda anche il trigger. Durante la prova l'API elenca solo i primi 10 problemi, quindi il Flowsery Trigger smette di scattare una volta che esistono.

Quali sono le alternative a n8n per Flowsery?

Flowsery funziona anche con Zapier, con ChatGPT e Claude tramite il suo server MCP, e dal terminale tramite la Flowsery CLI. La pagina sugli agenti IA mette a confronto le configurazioni.

Scegli n8n quando vuoi il workflow sul tuo server, collegato agli altri tuoi sistemi. Zapier non richiede un server, e la guida all'analytics con Zapier spiega il suo trigger, le azioni e le ricerche. In ChatGPT, il plugin di analytics per ChatGPT di Flowsery risponde alle stesse domande da una chat. Per i tuoi script, il riferimento API di Flowsery documenta ogni endpoint chiamato dal nodo.

Domande frequenti

Esiste un nodo n8n per Flowsery?

Flowsery pubblica il nodo community n8n-nodes-flowsery su npm. Aggiunge un nodo Flowsery con le risorse Analytics, Issue, Goal, Payment, Visitor e Website, e un Flowsery Trigger che scatta sui nuovi problemi. Installalo con il nome del pacchetto da Settings > Community nodes.

Il nodo Flowsery funziona su n8n Cloud?

Il README del nodo non parla di n8n Cloud, quindi questa guida usa un'istanza n8n self-hosted. Il README indica come testate le versioni di n8n dalla 1.100 in poi.

Quale token di Flowsery serve a un workflow n8n?

Un workflow n8n ha bisogno di un token di workspace di Flowsery con il ruolo Admin o Editor, creato su flowsery.com/api-tokens, oppure di una chiave del sito da Settings > API. Ogni chiamata all'API di Flowsery controlla il permesso flowsery.write, che i ruoli Viewer e Contributor non hanno.

n8n può avvisarmi quando Flowsery trova un bug?

Il Flowsery Trigger avvia un workflow n8n una volta per ogni nuovo problema aperto che Flowsery trova nelle registrazioni delle sessioni. Puoi limitarlo a un sito e a una gravità. Ogni problema arriva con titolo, gravità, sessioni coinvolte e passaggi per riprodurlo, e Issue > Get aggiunge le sessioni e i commenti che ci sono dietro.

Perché Flowsery ha salvato il mio pagamento in USD?

Payment > Track invia Currency solo se lo compili, e senza Currency Flowsery salva il pagamento in USD, non nella valuta del sito. Imposta Currency su un codice ISO 4217 come EUR in Additional Fields.

Posso eliminare un pagamento inviato da n8n per errore?

La chiamata DELETE /payments dell'API di Flowsery rimuove un pagamento tramite il suo id di transazione, oppure tutti i pagamenti di un visitatore o di un intervallo di tempo. Il nodo n8n non ha un'operazione di eliminazione, quindi invia una Transaction Reference in ogni chiamata Payment > Track: quell'id è il modo per rimuovere un singolo pagamento in seguito tramite l'API o un nodo HTTP Request.

Quanto costa l'integrazione di Flowsery con n8n?

L'integrazione con n8n è inclusa nel piano Team di Flowsery ($250 al mese) e nel piano Pro ($500 al mese). Entrambi i piani partono con una prova gratuita di 14 giorni che non richiede la carta. Il nodo della community è su npm.

Come installo il nodo Flowsery in n8n?

Apri Settings > Community nodes > Install nel tuo n8n self-hosted e scrivi n8n-nodes-flowsery come nome del pacchetto. Conferma l'avviso sul codice della community e clicca su Install. I nodi Flowsery e Flowsery Trigger compaiono poi nel pannello dei nodi.

Cosa fa il Flowsery Trigger alla prima esecuzione?

La prima verifica dopo l'attivazione del workflow registra solo i problemi già esistenti. Poi avvia il workflow una volta per ogni nuovo problema aperto. Un vecchio arretrato non inonda il tuo workflow.

Perché il mio Flowsery Trigger ha smesso di partire?

Nella prova gratuita l'API elenca solo i primi 10 problemi, quindi il trigger smette di partire quando questi esistono. Un piano a pagamento toglie questo limite. Controlla anche l'impostazione Severity, perché corrisponde in modo esatto e High non include Critical.