Google Sheets

Google Sheets é uma integração: um nó do fluxo que grava dados em uma planilha sua num ponto da jornada. Você o arrasta da paleta, aberta pelo botão Criar, do grupo Integrações. No mesmo grupo estão HTTP Request, ActiveCampaign, RD Station e Zapier. Tem uma entrada e uma única saída, sem ramo de sucesso ou de erro: depois de disparar, o fluxo segue para o nó conectado. No canvas aparece o Nome definido na aba Configurações (identificação interna) ou o rótulo "Google Sheets".

Antes de começar

Conecte uma conta Google na tela Credenciais, pelo botão Conectar conta Google. A credencial é da organização, serve para qualquer funil e dá acesso só aos arquivos que você escolher. Se a conexão cair, o painel do nó mostra Conexão com Google perdida. Reconectar conta. e o botão Reconectar conta.

O que você configura

Na aba Conteúdo, cada campo só aparece depois do anterior:

• Conta Google — obrigatória; o fim da lista traz Conectar nova conta.
• Planilha — obrigatória; Selecionar planilha abre o seletor do próprio Google, que lista só planilhas. Você não cola URL nem ID; escolhida, o botão vira Trocar.
• Aba — obrigatória; a lista vem da planilha escolhida.
• Operação — o nó suporta três operações: Inserir nova linha adiciona os valores mapeados ao final da planilha. Atualizar linha localiza a primeira linha cujo valor na coluna de busca é exatamente igual ao valor informado (sensível a maiúsculas/minúsculas) e sobrescreve apenas as colunas mapeadas — sem correspondência, nada é alterado. Buscar linha localiza a linha da mesma forma e grava os valores das colunas escolhidas em variáveis do funil (sem correspondência, as variáveis ficam vazias — combine com um nó de condição para tratar os dois caminhos). A primeira linha da planilha precisa ser o cabeçalho, com todos os nomes únicos. O Google limita cerca de 60 leituras e 60 escritas por minuto por conta — evite muitos nós do Sheets em sequência.
• Localizar linha — em Atualizar linha e Buscar linha: Coluna de busca (um cabeçalho da aba) e Valor de busca, que também aceita {{variavel}}. Valor de busca vazio (inclusive {{variavel}} que interpolou para vazio) nunca localiza linha nenhuma — célula em branco na coluna de busca não conta como correspondência.
• Mapeamento — Adicionar campo cria uma linha com Coluna (cabeçalhos da linha 1 da aba, cada um usável uma vez) e Valor, que aceita {{variavel}} (veja Variável).
• Variáveis de saída — só em Buscar linha: Adicionar variável cria uma linha com Coluna (cabeçalho a ler) e Variável (a variável do funil que recebe o valor lido).

Trocar a conta, a planilha ou a aba apaga o mapeamento.

No funil publicado

Ao passar pelo nó, Inserir nova linha e Atualizar linha disparam a gravação e o funil segue na hora, em segundo plano: nada trava, o visitante não espera nem vê erro. Buscar linha é a exceção: o funil aguarda a resposta do Google antes de avançar — é o que garante a variável pronta a tempo do próximo nó. Cada chamada ao Google tem o limite de 10 segundos e, em Buscar linha, o funil espera no máximo cerca de 12 segundos pela resposta; estourado esse tempo, ou em qualquer outra falha, ele segue sem gravar nada — as variáveis de saída ficam com o valor que já tinham (em geral, vazio) e a falha é silenciosa. A linha entra no fim da tabela, empurrando o que estiver abaixo, na ordem dos cabeçalhos — cabeçalho sem mapeamento fica vazio. O Google interpreta os valores, então um texto começando com = vira fórmula. Renomear a aba na planilha quebra a gravação até você reeditar o nó e publicar de novo. Publicar não valida o nó: incompleto, ele falha calado. O nó só funciona com o funil publicado. No modo Testar ele não executa, nem para ler: Buscar linha não preenche as variáveis no teste.

Onde conferir o resultado

Não há botão de teste nem histórico de execuções. Em Inserir nova linha e Atualizar linha, a única forma de saber se funcionou é abrir a planilha. Em Buscar linha, os valores lidos viram variáveis do funil: além de ficarem prontos para os nós seguintes, eles aparecem na aba Leads, na coluna de cada variável, como qualquer outra variável do funil. O que não existe em nenhuma das três operações é histórico de disparos — nem em Leads, nem em Analytics.