Como automatizar relatórios do site e alertas de bugs: analytics com Zapier na Flowsery

O app da Flowsery para Zapier dá ao analytics com Zapier duas direções: ele lê tráfego, receita e os bugs que a Flowsery encontrou nas gravações de sessão, e registra cadastros e pagamentos que acontecem em outros apps. Um Zap pode mandar por e-mail os números da semana passada, transformar um checkout quebrado em uma tarefa no gerenciador da sua equipe ou registrar um negócio fechado no seu CRM como meta, ao lado da fonte de tráfego que trouxe o comprador.

O app da Flowsery é público no diretório de apps do Zapier. Este guia mostra o que ele faz, como conectá-lo e quatro Zaps que você pode copiar. Os nomes de gatilhos, ações, buscas e campos abaixo são os mesmos que você vê no editor de Zaps.

Versão curta: crie um token de workspace em flowsery.com/api-tokens com o papel Admin ou Editor, adicione a Flowsery como passo de um Zap e cole o token quando o Zapier pedir. Use Find Overview para relatórios, New Issue para alertas de bugs e Track Goal ou Track Payment para enviar eventos.

O que o app da Flowsery para Zapier consegue fazer?

O app da Flowsery para Zapier tem 1 gatilho, 3 ações e 6 buscas. O gatilho inicia um Zap, as ações gravam na Flowsery e as buscas leem da Flowsery para um passo seguinte.

O gatilho é o New Issue, que dispara quando a IA da Flowsery encontra um novo problema nas suas gravações de sessão. Ele funciona por consulta periódica, e a página do Zapier diz que ele verifica dados novos a cada 15 minutos no plano Free.

As ações:

• Track Goal registra a conclusão de uma meta, opcionalmente ligada a um visitante ou a uma sessão conhecidos.
• Track Payment registra um pagamento, uma renovação ou um reembolso, para que a receita apareça ao lado do tráfego.
• Update Issue Status move um problema para Open, In progress, Resolved ou Suspended.

As buscas:

• Find Overview retorna visitantes, sessões, taxa de rejeição, duração média da sessão, receita, receita por visitante e taxa de conversão para um intervalo de datas.
• Find Timeseries retorna visitantes, sessões e receita agrupados por hora, dia, semana ou mês, com totais.
• Find Realtime Visitors retorna quantos visitantes estão no site agora.
• Find Breakdown divide os visitantes por uma de 25 dimensões, como página, referenciador, canal, campanha, país, dispositivo ou um parâmetro UTM, e retorna até 1000 linhas.
• Find Goals retorna cada meta com o número de conclusões em um intervalo de datas.
• Find Issue retorna um problema com a descrição, os passos para reproduzir e as sessões.

As buscas que recebem um intervalo de datas têm os campos 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.

Como conectar a Flowsery ao Zapier?

Você conecta a Flowsery ao Zapier com um token de API, nunca com a sua senha. O Zapier pede um campo e envia o token como header Bearer em toda requisição.

1. Abra flowsery.com/api-tokens e crie um token de workspace. Ele começa com flow_ws_ e alcança todos os sites do workspace.
2. Escolha Admin ou Editor como papel. Toda chamada à API da Flowsery verifica a permissão flowsery.write, que só esses dois papéis têm.
3. No Zapier, crie um Zap, busque Flowsery e escolha o gatilho, uma ação ou uma busca.
4. Quando o Zapier pedir login, cole o token. O Zapier o testa com GET /websites e dá à conexão o nome dos seus domínios.

Uma chave do site criada em Settings > API também funciona. Ela começa com flow_ e alcança um site. Todo passo da Flowsery tem um campo Website obrigatório nos dois casos; com uma chave do site, a lista tem uma única opção.

Como receber um relatório semanal de tráfego pelo Zapier?

Você recebe um relatório semanal de tráfego com o Schedule by Zapier como gatilho e o Find Overview como busca.

1. Comece o Zap com Schedule by Zapier, configurado para toda semana na segunda-feira de manhã.
2. Adicione Formatter by Zapier, Date / Time, Add/Subtract Time, para transformar a data do gatilho na data de sete dias antes.
3. Adicione o Find Overview da Flowsery. Escolha o site, mapeie a saída do Formatter para Start date e a data do gatilho para End date, e defina Timezone com um nome IANA, como Europe/Berlin.
4. Adicione o Find Breakdown da Flowsery com Dimension definido como Referrer e Rows como 5, para as mesmas datas.
5. Envie um e-mail, uma mensagem no Slack ou uma mensagem no Microsoft Teams com os totais e os principais referenciadores.

Deixe Start date e End date vazios e o Find Overview cobre os últimos 30 dias, o que é a configuração mais rápida para um relatório mensal. A nossa página sobre relatórios de analytics de site mostra quais números merecem lugar nessa mensagem.

Como enviar novos bugs para as ferramentas que a sua equipe usa?

Você envia novos bugs da Flowsery para a sua equipe com um Zap que começa no New Issue e termina no seu gerenciador de tarefas ou no seu chat. A Flowsery já publica problemas no Slack e abre tickets no Linear e no Jira por conta própria, como mostra a página de tickets de bug automáticos, então este Zap serve para todo o resto: Asana, Trello, ClickUp, Monday, Microsoft Teams ou um e-mail para uma agência.

1. Comece o Zap no New Issue da Flowsery. Escolha o site e defina Severity para disparar só em um nível, ou deixe vazio para todos.
2. Adicione o Find Issue da Flowsery e mapeie o ID do problema vindo do gatilho, quando a tarefa precisar das sessões por trás do problema.
3. Crie a tarefa com o título, a gravidade, as sessões afetadas e os passos para reproduzir.

Severity tem correspondência exata, então High não inclui Critical. Monte um Zap por nível que importa para você, ou deixe Severity vazio e adicione um passo Filter. Cada problema traz o número de sessões que afetou, o que é uma ordenação melhor do que a gravidade sozinha: um problema médio em 140 sessões alcança mais visitantes do que um crítico em 3. Leia sobre triagem de bugs para saber como priorizar o que chega.

No teste grátis, a API da Flowsery lista só os 10 primeiros problemas, então o New Issue para de disparar quando eles já existem, e o Find Issue ou o Update Issue Status em um problema posterior falha com Upgrade to view this issue.

Como registrar uma venda ou um cadastro que acontece fora do seu site?

Você registra uma venda externa com o Track Payment e um cadastro externo com o Track Goal, os dois como último passo de um Zap que começa no app onde a venda ou o cadastro aconteceu. A Flowsery conecta Stripe, Paddle, Polar e Lemon Squeezy com um clique na página de rastreamento de receita, então este Zap serve para faturas, negócios do CRM, vendas em marketplaces e demos agendadas.

O Track Payment recebe o Amount na unidade principal da moeda, como 49.00, mais Currency, Transaction reference, e-mail, nome e referência do cliente, Renewal, Refund e Paid at. Três campos pedem cuidado:

• Currency. A Flowsery armazena o pagamento em USD quando o campo está vazio, não na moeda do site. Preencha com um código ISO, como EUR.
• Transaction reference. Use o número da fatura, da cobrança ou do pedido. Uma referência que já foi registrada é recusada com um 409, não mesclada, e a referência é o que você precisa para apagar o pagamento depois.
• Renewal. Marque as cobranças recorrentes para que a receita nova e a de renovação fiquem separadas na Flowsery.

O Track Goal recebe um Goal name com letras minúsculas, dígitos, _ e -, com até 64 caracteres, como demo_booked ou deal_won. Metadata aceita no máximo 10 propriedades, e uma décima primeira falha com um 400.

As duas ações recebem um Visitor UID e um Session UID. Quando 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 pagamento ou a meta cai na linha do tempo daquele visitante, ao lado da fonte de tráfego que o trouxe. O guia de metas de analytics mostra quais conversões vale a pena rastrear.

Três campos que decidem se um pagamento está certo

Deixados vazios

• Currency: o pagamento é armazenado em USD
• Transaction reference: você não consegue apagar aquele pagamento depois
• Renewal: uma cobrança recorrente conta como receita nova

Preenchidos

• Currency: um código ISO, como EUR
• Transaction reference: o número da fatura ou do pedido, um por pagamento
• Renewal: ativado em toda cobrança recorrente

Como fechar um problema na Flowsery quando a correção sai?

Você fecha um problema na Flowsery pelo Zapier com o Update Issue Status, definido como Resolved, em um Zap que começa quando a tarefa daquele problema é concluída. Guarde o ID do problema da Flowsery na tarefa quando o Zap de bugs a criar, e depois mapeie esse ID no Update Issue Status do segundo Zap.

Resolved diz que o bug foi corrigido. Suspended esconde da lista padrão um problema que não é problema, então um Zap que suspende problemas encurta a lista sem corrigir nada nela. Escolha Resolved, a menos que uma pessoa tenha decidido outra coisa.

Um bug, do alerta ao fechamento

New Issue dispara

Find Issue

Tarefa criada

Tarefa concluída

Update Issue Status: Resolved

Quais erros o app da Flowsery para Zapier mostra?

O app da Flowsery para Zapier mostra a própria mensagem e o código de erro da API em toda requisição recusada, então o histórico do Zap diz o que corrigir.

Erro	O que significa
401 token_issuer_lost_access	O membro que criou o token perdeu o acesso; crie um novo token
Qualquer outro 401	"Flowsery rejected the API token"; o token foi revogado ou digitado errado
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
403 workspace_access_denied	O token não alcança esse workspace
429	Limite de requisições; o app espera o tempo indicado em Retry-After, ou 60 segundos quando ele não vem

Quando usar o n8n, o ChatGPT ou a API em vez do Zapier?

Use o Zapier quando o evento começa em outro app e você quer montar o fluxo sem código e sem servidor. A Flowsery tem outras três formas de entrada, todas listadas na página de agentes de IA.

• O node do n8n cobre o mesmo terreno para equipes que rodam automações no próprio servidor, e acrescenta Visitor > Get e filtros de relatório. O guia de analytics com n8n mostra o passo a passo.
• O plugin do ChatGPT responde perguntas sobre tráfego e problemas a partir de um chat. O guia do plugin de analytics para o ChatGPT da Flowsery traz a configuração.
• A API REST é para os seus próprios scripts, documentada na referência da API da Flowsery.

Perguntas frequentes

Existe um app oficial da Flowsery no Zapier?

A Flowsery tem um app público no diretório do Zapier em zapier.com/apps/flowsery/integrations. Você o conecta com um token de workspace criado em flowsery.com/api-tokens. Ele tem 1 gatilho, 3 ações e 6 buscas.

O app da Flowsery para Zapier precisa da minha senha?

O app da Flowsery para Zapier se conecta com um token de API e nunca pede a sua senha da Flowsery. Um token de workspace começa com flow_ws_, uma chave do site começa com flow_, e o Zapier envia qualquer um dos dois como token Bearer em toda requisição.

Com que rapidez o gatilho New Issue dispara?

O New Issue é um gatilho de consulta periódica, então ele dispara na próxima vez que o Zapier verifica a Flowsery. A página do Zapier diz que ele verifica a cada 15 minutos no plano Free, e os planos pagos do Zapier verificam com mais frequência.

Quais planos da Flowsery incluem o Zapier?

O plano Team da Flowsery, a $250 por mês, e o plano Pro, a $500 por mês, incluem a integração com o Zapier. Os dois começam com 14 dias de teste grátis sem cartão. No teste, a API lista só os 10 primeiros problemas.

Por que um pagamento vindo do Zapier apareceu em USD?

O Track Payment só envia Currency quando o campo está preenchido, e sem ele a Flowsery armazena o pagamento em USD. Mapeie ou digite um código ISO 4217, como EUR, em Currency.

O Zapier consegue enviar dados da Flowsery para o Google Sheets?

Qualquer busca da Flowsery pode alimentar um passo do Google Sheets. Um Zap semanal com Find Overview e uma ação Create Spreadsheet Row adiciona uma linha por semana com visitantes, sessões, taxa de rejeição e receita.

Qual função um token de API da Flowsery precisa ter para o Zapier?

Crie o token com a função Admin ou Editor. Toda chamada à API da Flowsery verifica a permissão flowsery.write, e só essas duas funções a têm. Um token com outra função falha com o erro 403 permission_denied.

Posso receber um alerta do Zapier só para bugs críticos?

Sim. Defina Severity no gatilho New Issue como o único nível que você quer, ou deixe vazio e adicione uma etapa Filter. Severity corresponde de forma exata, então High não inclui Critical.

O que acontece se o Zapier enviar o mesmo pagamento duas vezes?

A Flowsery rejeita o segundo com um 409 quando a Transaction reference já foi registrada. Ela não os une. Use o número da fatura, da cobrança ou do pedido como referência, para que um Zap repetido não registre o mesmo pagamento duas vezes.

Quantas propriedades um evento Track Goal pode ter?

Metadata aceita no máximo 10 propriedades, e a décima primeira falha com um 400. O Goal name aceita letras minúsculas, dígitos, _ e -, com até 64 caracteres, como demo_booked.