Pular para o conteúdo
Documentação API Reference FAQ Changelog Status
Marketing Magento 2 Adobe Commerce

Integração com a Flowbiz Universal tracker

PDF

Esta documentação é um guia passo a passo para configurar o módulo Flowbiz (Events) no Magento 2. Ela cobre a ativação do módulo, o preenchimento do ID de integração, a configuração dos eventos de rastreamento (visualização de produto, pedido completo, sincronização de carrinho, etc.), a ativação da recuperação de carrinho abandonado, e os procedimentos de validação e teste para garantir que a integração está funcionando corretamente.

L Lucas Steinbach 18/04/2026 Atualizado 19/04/2026 8 min de leitura

Como configurar o Flowbiz (Events)

  • O módulo Flowbiz (Events) conecta sua loja virtual à plataforma Flowbiz, especializada em automação de marketing para e-commerce.
  • Com ele ativo, a Flowbiz passa a identificar os visitantes da sua loja, acompanhar o carrinho de compras e registrar as conversões — tudo de forma automática.
  • Isso permite criar campanhas automatizadas como recuperação de carrinho abandonado, e-mails pós-compra e reativação de clientes inativos.
  • Também inclui a funcionalidade de recuperação de carrinho, onde o cliente recebe um link (por e-mail ou WhatsApp) que recria o carrinho automaticamente.

Tutorial em vídeo

[Inserir player do vídeo aqui quando disponível]


Passo a passo por escrito

Acessar as configurações do módulo

1. Acesse o caminho do módulo no painel administrativo

No menu lateral do admin, navegue até Lojas → Configuração → Vendas → Flowbiz (Events).

A tela de configuração será exibida com três grupos de opções: General, Events e Cart Recovery.


Configurar o grupo General

O grupo General contém as configurações essenciais para o funcionamento da integração. Sem preencher corretamente esses campos, nenhuma informação será enviada à Flowbiz.

2. Ative o módulo

No campo Enable module, selecione Sim.

Resultado esperado: O campo muda para "Sim", indicando que o módulo está ativo.

Enquanto este campo estiver como "Não", nenhuma informação será enviada à Flowbiz, mesmo que os demais campos estejam configurados.


3. Ative o carregamento automático da Flowbiz

No campo Initialize mb_track (bootstrap), selecione Sim.

Essa opção carrega automaticamente o código de comunicação com a Flowbiz em todas as páginas da loja.

Resultado esperado: O campo muda para "Sim".

Só desative esta opção se a equipe técnica da sua loja já carrega o código da Flowbiz manualmente em outro ponto. Na dúvida, mantenha ativo.


4. Preencha o ID de Integração

No campo Integration Id, insira o código de integração fornecido pela Flowbiz.

Esse código identifica a sua conta na plataforma Flowbiz e é obrigatório para que os dados da loja sejam enviados corretamente.

Resultado esperado: O campo exibe o código preenchido.

Sem o Integration Id preenchido, o módulo até funciona internamente, mas a Flowbiz não conseguirá associar os dados à sua conta. Se você ainda não possui esse código, entre em contato com o suporte da Flowbiz para obtê-lo.


5. (Opcional) Ative o modo de depuração

No campo Enable Console Log, selecione Sim caso precise verificar se os dados estão sendo enviados corretamente.

Essa opção exibe informações de diagnóstico no console do navegador (acessível pela ferramenta de desenvolvedor do navegador — tecla F12).

Resultado esperado: O campo muda para "Sim".

Este campo é útil apenas para testes e diagnóstico. Após confirmar que tudo funciona corretamente, você pode desativá-lo.


Configurar o grupo Events

Neste grupo, você escolhe quais tipos de informação a loja envia para a Flowbiz. Cada opção controla um tipo diferente de dado.

6. Ative os eventos desejados

Para cada campo abaixo, selecione Sim para ativar ou Não para desativar:

  • Fire productView — Envia informações quando um cliente visualiza a página de um produto.
  • Fire orderComplete — Envia os dados completos do pedido quando a compra é finalizada.
  • Sync customer (accountSync) — Envia dados de identificação do cliente (nome, e-mail, telefone) em diversas situações: login, cadastro, edição de conta, navegação logada e checkout.
  • Enable Checkout Step Tracking — Envia informações a cada etapa do checkout (identificação, endereço, pagamento e confirmação).
  • Enable cartSync — Envia o estado atualizado do carrinho sempre que houver uma alteração (adicionar/remover itens, mudar quantidade, calcular frete).
  • Enable addToCart — Envia uma notificação imediata quando o cliente adiciona um produto ao carrinho.

Resultado esperado: Cada campo selecionado muda para "Sim".

Você pode ativar os eventos gradualmente. Por exemplo, comece ativando apenas Sync customer e Fire orderComplete e, depois de validar o funcionamento, ative os demais. Desativar um evento específico não afeta os outros.


Configurar o grupo Cart Recovery

7. Ative a recuperação de carrinho

No campo Enable Cart Recovery, selecione Sim.

Com essa opção ativa, a Flowbiz poderá enviar links de recuperação de carrinho por e-mail ou WhatsApp. Quando o cliente clica no link, o carrinho é recriado automaticamente na loja.

Resultado esperado: O campo muda para "Sim".

Para que a recuperação de carrinho funcione, o módulo principal precisa estar ativo (passo 2) e o Integration Id precisa estar preenchido (passo 4).

O carrinho só pode ser recuperado enquanto os dados da compra ainda existirem no sistema. Carrinhos muito antigos podem ter sido removidos automaticamente pela loja e, nesses casos, a recuperação tentará recriar o carrinho com os mesmos produtos.


Salvar as configurações

8. Salve as configurações

Clique no botão Salvar configuração no canto superior direito da tela.

Resultado esperado: Uma mensagem de "Configuração salva com sucesso" será exibida no topo da tela.


9. Limpe o cache da loja

Acesse Sistema → Gerenciamento de Cache e clique em Liberar Cache do Magento (ou Flush Magento Cache).

Resultado esperado: Uma mensagem confirmando que o cache foi limpo será exibida.

As configurações do módulo só entram em vigor após a limpeza do cache. Não pule esta etapa.


Validação e Testes

Após concluir a configuração, siga os testes abaixo para confirmar que a integração está funcionando.

Teste 1 — Verificar se os dados estão sendo enviados

Ação:

  1. Ative o campo Enable Console Log (passo 5) caso ainda não esteja ativo.
  2. Abra a sua loja em uma nova aba do navegador.
  3. Pressione a tecla F12 para abrir a ferramenta de desenvolvedor e clique na aba Console.
  4. Navegue por algumas páginas da loja, visualize um produto, adicione ao carrinho e avance no checkout.

Resultado esperado: No console do navegador, devem aparecer mensagens iniciando com [Flowbiz] para cada ação realizada (visualização de produto, sincronização de carrinho, etapas do checkout, etc.).


Teste 2 — Verificar a recuperação de carrinho

Ação:

  1. Abra a loja em uma aba anônima do navegador.
  2. Adicione produtos ao carrinho.
  3. Utilize um link de recuperação fornecido pela Flowbiz (contendo o parâmetro de recuperação na URL).

Resultado esperado: O carrinho é recriado automaticamente e o cliente é redirecionado para a página do carrinho com os produtos adicionados.


Teste 3 — Os dados não aparecem no painel da Flowbiz

Ação: Verifique os seguintes pontos:

  1. O campo Enable module está como Sim?
  2. O campo Initialize mb_track (bootstrap) está como Sim?
  3. O Integration Id está preenchido com o código correto fornecido pela Flowbiz?
  4. O cache da loja foi limpo após salvar as configurações?

Se não funcionar, verifique: Se as mensagens [Flowbiz] aparecem no console do navegador mas os dados não chegam na Flowbiz, o problema pode estar do lado da Flowbiz. Entre em contato com o suporte da Flowbiz informando que os eventos estão sendo disparados corretamente pela loja.

Pronto! Dessa forma realizamos a configuração do Flowbiz (Events) em sua loja virtual Magento 2.


Observações importantes

  • O módulo envia os dados de identificação do cliente (nome, e-mail) a cada página visitada enquanto ele estiver logado. Isso é normal e garante que a Flowbiz mantenha o rastreamento atualizado.
  • As informações de endereço de entrega só são enviadas ao carrinho quando o CEP está preenchido. Antes disso, o campo de endereço não aparecerá no painel da Flowbiz.
  • Se o cliente utilizar um bloqueador de anúncios no navegador, os dados podem não ser enviados à Flowbiz. Esse é um comportamento do navegador do cliente e não indica um problema na configuração.
  • Para compras como visitante (sem criar conta), a Flowbiz identifica o cliente apenas pelo e-mail informado no checkout.
  • O rastreamento das etapas do checkout (Enable Checkout Step Tracking) é baseado no checkout padrão do Magento 2. Caso sua loja utilize um checkout personalizado, entre em contato com o suporte para verificar a compatibilidade.

Referências e Relacionados


Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br

Resultado esperado: O campo muda para "Sim", indicando que o módulo está ativo.

Enquanto este campo estiver como "Não", nenhuma informação será enviada à Flowbiz, mesmo que os demais campos estejam configurados.

Copiar para usar com IA

Este artigo foi útil?

Obrigado pelo seu feedback!