Como montar workflows de analytics com n8n usando o node da Flowsery

Bons workflows de analytics com n8n respondem a duas perguntas sem que ninguém abra um painel: como o site foi na semana passada, e alguma coisa quebrou para os visitantes? O n8n já conversa com o seu e-mail, o seu chat, o seu CRM e o seu gerenciador de tarefas. O que falta nele de fábrica é um node que leia números de tráfego sem cookies, receita e os bugs encontrados nas gravações de sessão. O community node da Flowsery é esse node.

Este guia cobre a instalação, a credencial, cada operação e quatro workflows que você pode copiar. Nós construímos a Flowsery, e tudo abaixo corresponde à versão 0.2.0 do node.

Versão curta: instale n8n-nodes-flowsery em Settings > Community nodes, crie um token de workspace em flowsery.com/api-tokens com o papel Admin ou Editor, cole-o na credencial Flowsery API e escolha o seu site no campo Website de cada node.

Do que você precisa para conectar a Flowsery ao n8n?

Você precisa de uma instância self-hosted do n8n, de um site na Flowsery com o script de rastreamento instalado e de um token de workspace da Flowsery. O README do node lista o n8n 1.100 e versões posteriores como testados e não cobre o n8n Cloud, então este guia usa uma instância self-hosted.

O pacote está no npm como n8n-nodes-flowsery. Ele não aparece no diretório de integrações do próprio n8n, então você o instala pelo nome do pacote. O plano Team da Flowsery ($250 por mês) e o plano Pro ($500 por mês) incluem a integração com o n8n, e os dois começam com 14 dias de teste grátis sem cartão.

Como instalar o node da Flowsery no n8n?

Instale pelo editor do n8n em Settings > Community nodes > Install. Digite n8n-nodes-flowsery como nome do pacote, confirme o aviso sobre instalar código da comunidade e clique em Install. O n8n baixa o pacote do npm e adiciona dois nodes ao painel de nodes: Flowsery e Flowsery Trigger.

Busque "Flowsery" no painel de nodes para confirmar que a instalação funcionou.

Como conectar a sua conta da Flowsery ao n8n?

Você conecta a Flowsery ao n8n com um segredo colado no campo API Token de uma nova credencial Flowsery API. O n8n envia esse segredo como token Bearer e o testa com uma requisição a GET /websites, então uma credencial salva significa que o segredo funciona.

Segredo	Onde você cria	Começa com	O que alcança
Token de workspace	flowsery.com/api-tokens	flow_ws_	Todos os sites do workspace
Chave do site	Settings > API em um site	flow_	Apenas esse site

Com um token de workspace, todo node precisa do campo Website, que carrega os seus sites pelo domínio. Com uma chave do site, você pode deixar Website vazio.

Escolha Admin ou Editor como papel do token. Toda chamada à API da Flowsery verifica a permissão flowsery.write, e só esses dois papéis a têm, então um token de Viewer ou Contributor é recusado com permission_denied. Um token também nunca faz mais do que o membro que o criou.

O que o node da Flowsery consegue fazer?

O node da Flowsery tem seis recursos, e o Flowsery Trigger inicia um workflow quando a Flowsery encontra um novo problema.

Recurso	Operações
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 retorna uma linha para um intervalo de datas: visitantes, sessões, taxa de rejeição, duração média da sessão, receita, receita por visitante e taxa de conversão. Get Timeseries agrupa visitantes, sessões e receita por hora, dia, semana ou mês. Get Breakdown divide os visitantes por uma de 25 dimensões, incluindo página, página de entrada, referenciador, canal, campanha, país, região, cidade, dispositivo, navegador, os cinco parâmetros UTM e meta.

Toda leitura recebe Start Date, End Date e Timezone. As datas cobrem por padrão os últimos 30 dias, e o fuso horário padrão é o do próprio site. Limit aceita de 1 a 1000 linhas. Get Overview, Get Timeseries, Get Breakdown e Goal > Get Many também recebem Filters, 20 ao todo, um para cada parâmetro filter_* da API da Flowsery. Os valores dos filtros batem exatamente com as linhas do detalhamento: o nome completo de uma região, como California, um dispositivo Desktop, Mobile ou Tablet, e o nome de uma fonte de referência, como Google.

Issue > Get Many lista os problemas que a IA da Flowsery encontrou nas gravações de sessão, com busca, gravidade, status e ordenação por data ou por gravidade. Issue > Get acrescenta a descrição, os passos para reproduzir, as sessões e os comentários. Update Status move um problema para Open, In Progress, Resolved ou Suspended.

Visitor > Get retorna o perfil de um visitante com uma linha do tempo de atividade. Goal > Track e Payment > Track gravam eventos no seu analytics, como mostra o terceiro workflow abaixo.

O Flowsery Trigger consulta periodicamente os novos problemas abertos e dispara uma vez por problema. Você pode limitá-lo a um site e a uma gravidade. A primeira consulta depois que você ativa o workflow só registra os problemas que já existem, então um backlog antigo não inunda o workflow.

Workflow 1: enviar um relatório semanal de tráfego

Este workflow envia os números da semana passada, comparados com os da semana anterior, toda segunda-feira de manhã.

1. Schedule Trigger roda toda segunda-feira às 9:00.
2. Flowsery, Analytics > Get Overview define Start Date como {{ $now.minus({ days: 7 }) }}, End Date como {{ $now }} e Timezone como um nome IANA, como Europe/Berlin.
3. Um segundo Get Overview cobre a semana anterior, de {{ $now.minus({ days: 14 }) }} até {{ $now.minus({ days: 7 }) }}.
4. Flowsery, Analytics > Get Breakdown usa Dimension Referrer e Limit 5 sobre a semana passada, para mostrar de onde vieram os visitantes.
5. Merge junta as saídas, e um node Send Email, Slack ou Telegram envia o resumo.

Adicione um quarto node da Flowsery com Dimension Page se o relatório também deve citar as páginas principais. O nosso guia de relatórios de analytics de site mostra quais números cabem em um e-mail semanal.

Workflow 2: transformar um novo bug em tarefa no seu gerenciador

A Flowsery já envia problemas ao Slack e abre tickets no Linear e no Jira por conta própria, como descreve a página de tickets de bug automáticos. Use o n8n quando o problema pertence a outro lugar, como ClickUp, Asana, Trello, GitHub Issues, Microsoft Teams ou Discord.

1. Flowsery Trigger observa o seu site, com Severity definido como High ou Critical, ou Any.
2. Flowsery, Issue > Get recebe Issue ID {{ $json.id }} e acrescenta cada ocorrência, as sessões por trás do problema e os comentários.
3. Um node ClickUp, Asana ou Trello cria a tarefa com o título, a gravidade, o número de sessões afetadas e os passos para reproduzir.
4. Flowsery, Issue > Update Status define o problema como In Progress, para que a lista de problemas da Flowsery mostre que alguém o assumiu.

Cada problema vindo do trigger já traz ID, título, descrição, gravidade, status, sessões afetadas, passos para reproduzir e as datas em que foi visto pela primeira e pela última vez. A gravidade no trigger tem correspondência exata, então High não inclui Critical; monte dois workflows ou defina Any e filtre com um node IF. Leia como transformar replays de sessão em relatórios de bug para saber o que uma boa tarefa deve conter.

Para onde deve ir um bug novo?

A Flowsery faz por você

• Mensagens no Slack
• Tickets no Linear
• Tickets no Jira

Use o n8n

• ClickUp, Asana ou Trello
• GitHub Issues, Microsoft Teams ou Discord
• O Flowsery Trigger inicia o workflow

Workflow 3: registrar vendas e cadastros que a Flowsery não vê

A Flowsery conecta Stripe, Paddle, Polar e Lemon Squeezy com um clique, como mostra a página de rastreamento de receita. Pagamentos e conversões vindos de qualquer outro lugar, como uma ferramenta de faturamento, um negócio marcado como ganho no CRM ou uma demo agendada, chegam à Flowsery por Payment > Track e Goal > Track.

1. Um trigger do app de origem, ou um node Webhook, inicia o workflow.
2. Flowsery, Payment > Track define Amount na unidade principal da moeda, como 49.00. Em Additional Fields, defina Currency como um código ISO, como EUR, Transaction Reference como o número da fatura ou do pedido, e Renewal ou Refund quando se aplicarem.
3. Para um cadastro ou um negócio ganho, Flowsery, Goal > Track define um Goal Name, como deal_won, e até 10 propriedades de metadados.
4. Se o seu formulário ou checkout repassa o valor do cookie _fs_vid que o script da Flowsery define, mapeie esse valor para Visitor UID, e o evento cai na linha do tempo daquele visitante, ao lado da fonte de tráfego dele.

Dois detalhes evitam uma limpeza depois. Sem Currency, a Flowsery armazena o pagamento em USD, não na moeda do site. E uma Transaction Reference que já foi registrada falha com um erro 409 em vez de criar um segundo pagamento, então você precisa de uma por pagamento, e precisa dela para apagar o pagamento depois. Nomes de metas aceitam letras minúsculas, dígitos, underscores e hífens, com até 64 caracteres. A página de rastreamento de metas e eventos explica como as metas aparecem nos relatórios.

Workflow 4: deixar um agente de IA do n8n responder perguntas sobre tráfego

O node da Flowsery é marcado como utilizável como ferramenta, então um node AI Agent do n8n consegue chamá-lo. Conecte uma ferramenta da Flowsery por tipo de pergunta, por exemplo Get Overview e Get Breakdown, e o agente escolhe a chamada e os filtros quando alguém pergunta no Slack ou no Telegram "Em quais páginas os visitantes de celular da Alemanha chegaram na semana passada?".

Em uma instância self-hosted, o n8n só oferece community nodes como ferramentas de agente quando a variável de ambiente N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE está como true. Todo token da Flowsery carrega o papel Admin ou Editor, então limite o que o agente pode fazer pelas operações que você conecta: um agente só com ferramentas de leitura não consegue registrar metas nem alterar um problema.

Quais erros o node da Flowsery retorna?

O node da Flowsery retorna o próprio código de erro da API, e quatro deles explicam quase toda execução que falha.

Erro	O que significa	O que fazer
401 token_issuer_lost_access	O membro que criou o token saiu do workspace ou foi desativado	Crie um novo token
403 permission_denied	O papel do token não tem flowsery.write	Use um token de Admin ou Editor
403 subscription_required	O plano do workspace não inclui mais acesso à API	Confira o plano no faturamento da Flowsery
403 Upgrade to view this issue	O problema está além dos 10 primeiros do teste grátis	Assine um plano pago

O limite do teste grátis também afeta o trigger. No teste, a API lista só os 10 primeiros problemas, então o Flowsery Trigger para de disparar quando eles já existem.

Quais são as alternativas ao n8n para a Flowsery?

A Flowsery também funciona com o Zapier, com o ChatGPT e o Claude pelo servidor MCP dela, e no terminal pela Flowsery CLI. A página de agentes de IA lista as configurações lado a lado.

Escolha o n8n quando você quer o workflow no seu próprio servidor, encadeado com os seus outros sistemas. O Zapier não precisa de servidor, e o guia de analytics com Zapier cobre o trigger, as ações e as buscas dele. No ChatGPT, o plugin de analytics para o ChatGPT da Flowsery responde às mesmas perguntas a partir de um chat. Para os seus próprios scripts, a referência da API da Flowsery documenta cada endpoint que o node chama.

Perguntas frequentes

Existe um node do n8n para a Flowsery?

A Flowsery publica o community node n8n-nodes-flowsery no npm. Ele adiciona um node Flowsery com os recursos Analytics, Issue, Goal, Payment, Visitor e Website, e um Flowsery Trigger que dispara com novos problemas. Instale pelo nome do pacote em Settings > Community nodes.

O node da Flowsery funciona no n8n Cloud?

O README do node não cobre o n8n Cloud, então este guia usa uma instância self-hosted do n8n. O README lista o n8n 1.100 e versões posteriores como testados.

De qual token da Flowsery um workflow do n8n precisa?

Um workflow do n8n precisa de um token de workspace da Flowsery com o papel Admin ou Editor, criado em flowsery.com/api-tokens, ou de uma chave do site em Settings > API. Toda chamada à API da Flowsery verifica a permissão flowsery.write, que os papéis Viewer e Contributor não têm.

O n8n consegue me avisar quando a Flowsery encontra um bug?

O Flowsery Trigger inicia um workflow do n8n uma vez para cada novo problema aberto que a Flowsery encontra nas gravações de sessão. Você pode limitá-lo a um site e a uma gravidade. Cada problema chega com título, gravidade, sessões afetadas e passos para reproduzir, e Issue > Get acrescenta as sessões e os comentários por trás dele.

Por que a Flowsery armazenou o meu pagamento em USD?

Payment > Track só envia Currency quando você preenche o campo, e sem ele a Flowsery armazena o pagamento em USD, não na moeda do site. Defina Currency como um código ISO 4217, como EUR, em Additional Fields.

Posso apagar um pagamento que enviei do n8n por engano?

A chamada DELETE /payments da API da Flowsery remove um pagamento pelo ID da transação, ou todos os pagamentos de um visitante ou de um intervalo de tempo. O node do n8n não tem operação de exclusão, então envie uma Transaction Reference em toda chamada de Payment > Track; esse ID é o que permite remover um único pagamento depois pela API ou por um node HTTP Request.

Quanto custa a integração da Flowsery com o n8n?

A integração com o n8n está incluída no plano Team da Flowsery ($250 por mês) e no plano Pro ($500 por mês). Os dois planos começam com um teste grátis de 14 dias que não exige cartão. O node da comunidade está no npm.

Como instalo o node da Flowsery no n8n?

Abra Settings > Community nodes > Install no seu n8n auto-hospedado e digite n8n-nodes-flowsery como nome do pacote. Confirme o aviso sobre código da comunidade e clique em Install. Os nodes Flowsery e Flowsery Trigger aparecem depois no painel de nodes.

O que o Flowsery Trigger faz na primeira execução?

A primeira consulta depois que você ativa o workflow só registra os problemas que já existem. Depois disso, ele inicia o workflow uma vez para cada novo problema aberto. Um acúmulo antigo não inunda o seu workflow.

Por que o meu Flowsery Trigger parou de disparar?

No teste grátis, a API lista só os 10 primeiros problemas, então o trigger para de disparar quando eles já existem. Um plano pago remove esse limite. Confira também a configuração Severity, porque ela corresponde exatamente e High não inclui Critical.