Configurar blocos de ação do Google Sheets

Aprenda como configurar blocos de ação do Google Sheets no Advanced Flow Builder

Written By Frieda Yip (Super Administrator)

Updated at December 29th, 2025

Os blocos de ação do Google Sheets no Advanced Flow Builder permitem criar, atualizar e gerenciar linhas automaticamente em planilhas conectadas. Isso facilita a sincronização de dados de clientes, registros de pedidos ou informações de assinatura entre a SleekFlow e o Google Sheets, sem necessidade de preenchimento manual.

Neste artigo, mostramos os blocos de ação do Google Sheets disponíveis e como configurá-los passo a passo.
 

Antes de configurar os blocos de ação do Google Sheets, é necessário ter pelo menos uma integração com o Google Sheets conectada à sua empresa. Consulte este artigo da Central de Ajuda para saber mais sobre integrações com o Google Sheets.

 

 

Pesquisar linhas do Google Sheets

O bloco de ação Pesquisar linhas do Google Sheets busca e recupera as linhas correspondentes na planilha selecionada com base nas condições de busca definidas. Esse bloco é frequentemente usado em conjunto com o bloco de ação Atualizar linha do Google Sheets, permitindo localizar dinamicamente uma linha específica e atualizar seus dados de forma integrada ao fluxo.

Configurar o bloco de ação “Pesquisar linhas do Google Sheets”:

  1. Clique no bloco de ação Pesquisar linhas do Google Sheets para abrir o formulário do bloco, que será exibido no lado direito da tela.
  2. O formulário do bloco contém os seguintes campos:
    1. Selecionar conta do Google e planilha
      1. Conta do Google: selecione a conta do Google conectada. Caso nenhuma conta esteja conectada, consulte o artigo da Central de Ajuda para configurar a integração com o Google Sheets.
      2. Google Sheet: selecione a planilha na qual deseja realizar a busca.
      3. Aba: escolha a aba específica (planilha/worksheet) dentro do arquivo.
      4. Linha de cabeçalho: informe o número da linha que contém os cabeçalhos das colunas (geralmente 1).
  3. Definir condições de busca
    1. Coluna do Google Sheets: selecione a coluna na qual deseja buscar (por exemplo, Email, ID do pedido, ID do membro).
    2. Operador: escolha a condição (por exemplo, igual a, contém, começa com).
    3. Valor: insira o valor a ser correspondido ou utilize uma variável (por exemplo, e-mail do contato, ID da assinatura).

Exemplos de uso:

  • Buscar pela coluna ID do pedido usando o valor de uma variável de gatilho para localizar a linha correta do pedido.
  • Recuperar a coluna Status da assinatura e usar esse valor para decidir se um lembrete de renovação deve ser enviado.
     

 

Adicionar linha no Google Sheets

O bloco de ação Adicionar linha no Google Sheets permite inserir uma nova linha na planilha selecionada com valores predefinidos. Ele pode ser usado para registrar automaticamente dados de clientes, transações ou qualquer informação relevante.

Configurar o bloco de ação “Adicionar linha no Google Sheets”:

  1. Clique no bloco de ação Adicionar linha no Google Sheets para abrir o formulário do bloco, que será exibido no lado direito da tela.
  2. O formulário do bloco contém os seguintes campos:
    1. Selecionar conta do Google e planilha
      1. Conta do Google: selecione a conta do Google conectada.
      2. Google Sheet: selecione a planilha desejada.
      3. Aba: escolha a aba específica dentro da planilha.
      4. Linha de cabeçalho: informe o número da linha que contém os cabeçalhos das colunas (geralmente 1).
  3. Mapear valores das colunas
    1. Em Mapear valores das colunas, adicione um mapeamento para cada coluna que deseja preencher:
      1. Coluna do Google Sheets: selecione a coluna de destino (por exemplo, ID do pedido, Email, Nível).
      2. Valor: insira um valor fixo ou utilize uma variável (de gatilho, contato ou do meio do fluxo) por meio do seletor {x}.
      3. Clique em Adicionar para incluir mais colunas.

Observações e dicas

  • Os cabeçalhos devem existir na linha de cabeçalho selecionada; somente essas colunas poderão ser mapeadas.
  • Mapeie apenas as colunas necessárias — colunas não mapeadas permanecerão em branco ou manterão fórmulas padrão.
  • Se a planilha usar fórmulas (por exemplo, totais), deixe essas colunas sem mapeamento para que o Google Sheets faça o cálculo automaticamente.
  • Certifique-se de que os valores estejam no formato esperado (datas, números etc.) para evitar erros na planilha.
 

 

Atualizar linha do Google Sheets

O bloco de ação Atualizar linha do Google Sheets modifica uma linha existente na planilha selecionada com base em critérios definidos, garantindo que os registros permaneçam corretos e atualizados sem edições manuais.

Configurar o bloco de ação “Atualizar linha do Google Sheets”:

  1. Clique no bloco de ação Atualizar linha do Google Sheets para abrir o formulário do bloco, que será exibido no lado direito da tela.
  2. O formulário do bloco contém os seguintes campos:
    1. Selecionar conta do Google e planilha
      1. Conta do Google: selecione a conta do Google conectada.
      2. Google Sheet: selecione a planilha desejada.
      3. Aba: escolha a aba específica dentro da planilha.
      4. Linha de cabeçalho: informe o número da linha que contém os cabeçalhos das colunas (geralmente 1).
  3. Escolher qual linha atualizar (Linha)
    1. Defina como a linha será identificada:
      1. Linha fixa: selecione manualmente o número da linha (por exemplo, 2).
      2. Variáveis do fluxo: forneça o índice/ID da linha por meio de uma variável (por exemplo, a partir de um passo anterior de Pesquisar linhas do Google Sheets).
  4. Mapear valores das colunas
    1. Para cada campo que deseja atualizar:
      1. Coluna do Google Sheets: selecione a coluna de destino (por exemplo, Status, URL de rastreio, Nível).
      2. Valor: insira um valor fixo ou utilize uma variável por meio do seletor.
      3. Clique em Adicionar para atualizar várias colunas na mesma linha.

 

💡 Dicas para selecionar a linha de cabeçalho em planilhas complexas

Certifique-se de selecionar a linha de cabeçalho correta, pois ela informa à SleekFlow onde começar a ler os dados. Em planilhas simples, geralmente é a primeira linha. Em planilhas mais complexas (por exemplo, com títulos, células mescladas ou múltiplas seções), selecione a linha onde começam os nomes das colunas ou rótulos das propriedades.

Qualquer dado acima da linha de cabeçalho selecionada será ignorado.

✅ Exemplo 1: Estrutura de uma planilha simples

  • Linhas 1 e 2 contêm informações gerais ou títulos.
  • Linha 3 contém os cabeçalhos das colunas.

Nesse caso, selecione a linha 3 como linha de cabeçalho ao configurar o bloco de ação do Google Sheets.

 

✅ Exemplo 2: Planilha complexa de e-commerce com metadados


In this example:

  • Linha 1 contém notas internas e metadados do relatório.
  • Linha 2 contém os cabeçalhos reais.

Nesse caso, selecione a linha 2 como linha de cabeçalho para que a SleekFlow leia corretamente colunas como ID do pedido, Email, Adicionais e Status, ignorando o conteúdo acima.