---
title: "🚀 Guia de instalação: n8n"
description: "Aprenda como automatizar o envio de dados do Data Reveal para o Google Sheets através do n8n."
url: https://suporte.datastone.com.br/pt-br/articles/11385754-🚀-guia-de-instalacao-n8n
collection: "N8n"
updated: 2025-12-12
language: pt-br
---

# 🚀 Guia de instalação: n8n

Aprenda como automatizar o envio de dados do Data Reveal para o Google Sheets através do n8n.

Você já imaginou poder **ver, em tempo real, quem está navegando pelo seu site**, nome, cargo, empresa, total de visitas, e ter tudo isso automaticamente registrado em uma planilha compartilhada com seu time?

A integração conecta o **Data Reveal ao n8n** e, a partir dele, ao **Google Sheets**, para que cada visitante identificado vire uma linha organizada em uma planilha. Assim, seu time consegue acompanhar quem está acessando o site, quantas vezes voltou e quais páginas visitou, usando uma ferramenta que todo mundo conhece: o Sheets.​

## 🧩 Visão geral da integração

Essa integração foi pensada para criar duas visões complementares dos visitantes:

-   Uma aba de **Visitas** para registrar cada página acessada, com data e hora;​
    
-   Uma aba de **Visitantes** para consolidar os dados de cada pessoa/empresa e o histórico de engajamento (primeira visita, última visita e total de visitas).​
    

Você vai precisar de:

-   Uma conta no **Google Sheets**;​
    
-   Um ambiente **n8n** (cloud ou self-hosted);​
    
-   Acesso ao painel do **Data Reveal** (seção Integrações > n8n ou no link: [**https://reveal.datastone.com.br/integrations**](https://reveal.datastone.com.br/integrations)**).**​
    

_Tempo estimado: cerca de 10–15 minutos do início ao fim.__​_

## 📄 Passo 1: criar a planilha no Google Sheets

O primeiro passo é preparar o lugar onde os dados vão chegar, dentro do seu Google Drive.​

1.  Acesse o site do Google Sheets e crie uma nova planilha em branco;​
    
2.  Renomeie a planilha para algo fácil de reconhecer, por exemplo: **Visitantes Data Reveal**.​
    

### Aba “Visitas” (histórico de navegação)

Essa aba registra cada visita ao site, página por página, com data/hora e identificador.​

1.  Renomeie a primeira aba da planilha para **Visitas**;​
    
2.  Na linha 1, crie as colunas abaixo:​
    
    -   A1: `data_hora`
        
    -   B1: `identificador`
        
    -   C1: `pagina_visitada`
        

Essa aba ajuda a entender o caminho do visitante dentro do site: quais páginas ele acessou e em que momento.​

### Aba “Visitantes” (pessoas e empresas)

Aqui você terá uma linha por visitante, com os principais dados de pessoa e empresa, além do resumo de visitas.​

1.  Crie uma nova aba e renomeie para **Visitantes**;​
    
2.  Na linha 1, crie as colunas abaixo:​
    
    -   A1: `identificador`
        
    -   B1: `foto`
        
    -   C1: `nome`
        
    -   D1: `email`
        
    -   E1: `telefone`
        
    -   F1: `cargo`
        
    -   G1: `linkedin_pessoa`
        
    -   H1: `localizacao`
        
    -   I1: `empresa`
        
    -   J1: `setor`
        
    -   K1: `funcionarios`
        
    -   L1: `faturamento`
        
    -   M1: `site_empresa`
        
    -   N1: `linkedin_empresa`
        
    -   O1: `total_visitas`
        
    -   P1: `primeira_visita`
        
    -   Q1: `ultima_visita`
        

Essa aba é a visão principal que seu time comercial e de marketing vai consultar para entender quem está engajado com o site.

Se preferir, já deixamos um modelo prontinho pra você aqui: [Visitantes Data Reveal](https://bit.ly/44nrOp8)

### Copie o ID da planilha

O n8n se conecta à planilha usando o ID que aparece na URL do Google Sheets.

![](https://staticfiles.gleap.io/gattachments/76OlsZSppDwJPTGpMrOU29WhGiWHrpw5GwBlVi7iQ1MBrbsbzs2ZMW21VBuSy9pqHMvLa4CAipF.png)

1.  Com a planilha aberta, copie o trecho da URL entre `/d/` e `/edit`;​
    
2.  Guarde esse ID, pois ele será usado em todos os módulos de Google Sheets do workflow n8n.​
    

## ⚙ Passo 2: importar o workflow no n8n

O Data Reveal fornece um workflow pronto para conectar o webhook ao Google Sheets, evitando que você tenha que montar tudo do zero.​

1.  Acesse seu ambiente n8n e vá até a área de **Workflows**;​
    
2.  Clique em **Add Workflow**;​
    
3.  Abra o menu de opções do workflow (três pontinhos no canto superior direito);​
    
4.  Escolha **Import from URL** ou **Import from File**, conforme a forma que você recebeu o JSON do Data Reveal;​
    
5.  Importe o arquivo JSON do workflow disponível na area de integrações do Data Reveal.​
    

Após a importação, você verá um fluxo com:

-   Um **webhook** de entrada;​
    
-   Módulos de formatação de dados;​
    
-   Quatro módulos de **Google Sheets** conectados às abas “Visitas” e “Visitantes”.​
    

## 🔐 Passo 3: conectar o Google Sheets no n8n

Agora é hora de dar permissão para o n8n acessar sua conta Google e a planilha criada.​

### Conectar a conta Google

1.  Clique no primeiro módulo **Google Sheets** do workflow (“Registrar visita”);
    
2.  Clique nos três pontinhos no canto superior do bloco e clique em “Open”;​
    
3.  No campo de credenciais, selecione **Create New**;​
    
4.  Siga o fluxo de autorização do Google para permitir que o n8n acesse suas planilhas;​
    
5.  Salve e escolha a credencial recém-criada.​
    

Essa conexão só precisa ser feita uma vez; os outros módulos podem reaproveitar a mesma credencial.​

### Informar o ID da planilha

Cada módulo de Google Sheets precisa saber em qual planilha vai escrever ou buscar dados.​

1.  Nos módulos de Google Sheets do workflow, localize o campo **Document ID**;​
    
2.  Cole o ID da planilha que você copiou no Passo 1;​
    
3.  Repita o processo para todos os módulos de Google Sheets.​
    

Os módulos que utilizam esse ID são:​

-   **Registrar Visita** – adiciona uma linha na aba **Visitas**;
    
-   **Buscar Visitante** – procura um visitante já existente na aba **Visitantes**;
    
-   **Salvar Atualização** – atualiza um visitante existente em **Visitantes**;
    
-   **Inserir Visitante** – cria um novo registro na aba **Visitantes**.
    

## ▶ Passo 4: ativar o workflow e copiar o webhook

Com a planilha pronta e os módulos configurados, basta ativar o fluxo.​

1.  No canto superior direito do workflow, ative a opção **Active** (o fluxo ficará com indicação verde);​
    
2.  No primeiro nó (Webhook), copie a **URL do webhook** que o n8n gerou.​
    

Essa URL é o “endereço” que o Data Reveal vai usar para enviar os dados de visitantes ao n8n.​

## 🌐 Passo 5: conectar o n8n no DataReveal

Agora vamos ligar tudo dentro do DataReveal.​

1.  No painel do DataReveal, acesse **Integrações** e busque por **n8n**;​
    
2.  Cole a URL do webhook copiada do n8n no campo indicado;​
    
3.  Clique em **Conectar** para salvar a integração;​
    
4.  Use o botão **Testar** para enviar um evento de teste (detalhado no artigo de testes).​
    

Se o teste retornar sucesso, a integração está pronta para receber visitantes reais.​

## 🔍 Como o fluxo trabalha por trás dos panos

Depois de tudo configurado, cada visitante identificado pelo Data Reveal segue este caminho:​

1.  O Data Reveal envia os dados do visitante para o **webhook** do n8n;​
    
2.  O n8n formata os dados e registra a visita na aba **Visitas**;​
    
3.  O fluxo verifica na aba **Visitantes** se esse identificador já existe;​
    
4.  Se existir, o fluxo **atualiza** o total de visitas e a data da última visita;​
    
5.  Se não existir, o fluxo **cria um novo visitante** com os dados completos de pessoa e empresa.​
    

Isso acontece automaticamente, sem precisar exportar relatórios ou mexer na planilha manualmente.​
