Pular para o conteúdo
Automação

Como registrar e-mails do Gmail em uma planilha com n8n

Sim, dá para registrar e-mails do Gmail em uma planilha sem copiar e colar cada mensagem. Com o n8n, você monta um fluxo que observa mensagens com um filtro, coleta dados como remetente, assunto e trecho do conteúdo e acrescenta uma nova linha no Google Sheets.

O caminho mais seguro é começar sem inteligência artificial: use uma etiqueta ou uma busca do Gmail para escolher o que entra no relatório. Assim, você não transforma a caixa de entrada inteira em uma planilha confusa e mantém o controle sobre quais mensagens serão processadas.

Diagrama de um fluxo automatizado que coleta dados e transforma informações em um resultado organizado

Imagem: diagrama de fluxo de automação, adaptado e processado para este artigo. Origem: Wikimedia Commons.

O que você vai criar

O fluxo básico terá três partes:

  • Gmail Trigger: detecta novas mensagens que atendem à busca definida;
  • Gmail: opcionalmente busca a mensagem completa quando o gatilho entregar apenas o identificador;
  • Google Sheets: adiciona os campos escolhidos em uma nova linha.

O Gmail permite filtrar mensagens com operadores de busca, como remetente, assunto, data e etiqueta. A documentação da API também confirma que a busca usa o parâmetro q e aceita boa parte da sintaxe avançada disponível na interface do Gmail. No n8n, esse filtro aparece no campo Search do gatilho.

Prepare o Google Sheets

Crie uma planilha nova e, na primeira linha, coloque nomes simples para as colunas. Um modelo útil para atendimento, vendas ou financeiro é:

Coluna Para que serve
recebido_em Data e hora da mensagem
remetente Nome ou endereço de quem enviou
assunto Assunto do e-mail
resumo Trecho curto ou snippet da mensagem
mensagem_id Identificador usado para conferir duplicidades
status Exemplo: novo, em análise ou resolvido

Evite começar com células mescladas, fórmulas espalhadas ou títulos em várias linhas. O nó do Google Sheets trabalha melhor quando a primeira linha representa os campos e cada execução cria um novo registro abaixo dela. A documentação do Sheets API explica que a planilha é organizada em abas, linhas, colunas e intervalos; essa estrutura simples facilita o mapeamento no n8n.

Configure as credenciais

No n8n, crie ou selecione uma credencial do Google para o Gmail e outra para o Google Sheets, caso a instalação peça conexões separadas. O caminho normal é o OAuth: você autoriza o n8n a acessar a conta escolhida sem informar sua senha do Gmail ao fluxo.

Em uma conta corporativa, o administrador pode limitar quais aplicativos podem receber autorização. Se a conexão for bloqueada, o problema não está necessariamente no nó: verifique as políticas do Google Workspace, a tela de consentimento e o usuário autorizado.

Se você usa n8n Cloud, parte da configuração é guiada pela própria plataforma. Em uma instalação própria, também é preciso manter o n8n funcionando e com endereço acessível para que os fluxos ativos sejam executados. Para não deixar credenciais expostas, vale ler também o guia do JSMS sobre como proteger chaves de API no n8n.

Monte o fluxo no n8n

1. Adicione o Gmail Trigger

Crie um workflow e escolha o nó Gmail Trigger. Na opção de evento, use o equivalente a novas mensagens recebidas. No campo Search, informe uma consulta que limite o que será registrado. Por exemplo:

label:registrar-cliente

Antes disso, crie no Gmail uma etiqueta chamada registrar-cliente. Quando quiser enviar um e-mail para a planilha, aplique essa etiqueta. Outra opção é usar uma busca mais específica, como:

from:cliente@example.com newer_than:7d

A primeira alternativa costuma ser mais previsível para equipes, porque alguém decide explicitamente quais mensagens entram no fluxo. A segunda é útil quando todos os e-mails de um remetente devem ser acompanhados.

2. Busque a mensagem completa se necessário

Execute o gatilho uma vez e observe o JSON retornado. Se ele já trouxer remetente, assunto, data e trecho da mensagem, você pode ligar o gatilho diretamente ao Google Sheets. Se vier apenas o ID ou faltarem cabeçalhos, acrescente o nó Gmail e use a operação de obter uma mensagem, preenchendo o ID com o valor recebido do gatilho.

O n8n mantém nós separados para disparar e operar o Gmail. A documentação do Gmail Trigger mostra o campo de busca para restringir as mensagens; já o nó Gmail é usado para automatizar operações na conta.

3. Acrescente o Google Sheets

Adicione o nó Google Sheets, selecione a operação de planilha e escolha a ação equivalente a Append Row ou adicionar linha. Selecione o arquivo e a aba preparados anteriormente. O n8n exibirá os campos da primeira linha para você relacionar cada coluna com um dado do Gmail.

Faça o mapeamento pelo seletor de dados do n8n. Ligue mensagem_id ao identificador da mensagem, assunto ao assunto, remetente ao cabeçalho do remetente e resumo ao snippet ou trecho disponível. Para status, use um valor fixo como novo. A página do Google Sheets no n8n é a referência para as operações do nó.

Como testar sem bagunçar a planilha

  1. Envie um e-mail de teste para a conta conectada.
  2. Aplique a etiqueta usada na busca ou faça a mensagem atender ao filtro.
  3. Execute o workflow manualmente ou aguarde a próxima verificação do gatilho.
  4. Confira se apenas uma linha nova apareceu na aba.
  5. Abra os dados da execução e confirme se remetente, assunto e ID foram preenchidos.

Se nada acontecer, comece pelo diagnóstico mais simples: teste o mesmo filtro na busca do Gmail. Depois, confira a credencial, a conta selecionada, a aba da planilha e o histórico de execuções do n8n. Um filtro muito restritivo é uma causa comum de fluxo que parece quebrado.

Como evitar linhas duplicadas

O identificador da mensagem deve ficar na planilha mesmo que você nunca o mostre para a equipe. Ele funciona como uma chave técnica. Para um fluxo mais resistente, coloque entre o Gmail e o Append Row uma consulta que procure esse ID na coluna mensagem_id. Só avance para adicionar a linha quando a busca não encontrar o registro.

Essa etapa é importante quando você reprocessa execuções antigas, muda o fluxo ou usa uma rotina agendada. A própria documentação do Gmail informa que a API permite listar mensagens por uma consulta de busca; a planilha, por sua vez, serve como registro simples para conferência e deduplicação.

Limitações que merecem atenção

  • Não é um arquivamento completo: gravar assunto e snippet não substitui guardar a mensagem original, anexos ou requisitos de retenção.
  • Dados sensíveis: uma planilha pode ampliar o número de pessoas com acesso a informações de clientes. Restrinja o compartilhamento e evite salvar o corpo inteiro por padrão.
  • Formato inconsistente: assinaturas, HTML e mensagens encaminhadas podem deixar o texto menos limpo. Use o snippet ou crie uma etapa de tratamento antes de salvar.
  • Execução depende do ambiente: no n8n próprio, o serviço precisa estar ligado e saudável. No n8n Cloud, a disponibilidade depende do plano e do serviço contratado.
  • Volume alto: Gmail e Sheets têm limites de API e de operação. Para milhares de mensagens, pense em paginação, filas, retenção e um banco de dados.

Vale a pena usar n8n para esse caso?

Vale quando você quer controlar o filtro, combinar Gmail com outras ferramentas e ter a opção de hospedar o fluxo. Também é uma boa porta de entrada para automação porque o resultado fica visível: cada e-mail vira uma linha que pode alimentar atendimento, vendas ou um relatório.

Se a necessidade é apenas encaminhar mensagens para uma tabela e você não quer administrar nada, uma ferramenta SaaS de automação pode ser mais simples. Por outro lado, o n8n faz mais sentido quando o fluxo vai crescer, quando você precisa de regras próprias ou quando quer manter os dados em uma infraestrutura sob seu controle.

Perguntas frequentes

O n8n consegue registrar e-mails do Gmail sem usar inteligência artificial?

Sim. O Gmail Trigger, o nó Gmail e o Google Sheets resolvem o fluxo básico. IA só é necessária se você quiser classificar, resumir ou extrair campos de texto livre.

Preciso deixar o Gmail aberto para o fluxo funcionar?

Não. A conexão usa autorização da conta, mas o n8n precisa estar disponível para executar o workflow. Em instalação própria, isso significa manter o serviço funcionando.

Como faço para registrar somente e-mails importantes?

Use uma etiqueta criada para esse fim ou uma busca do Gmail com remetente, assunto, período e outros operadores. Teste a consulta no Gmail antes de colocá-la no gatilho.

É possível impedir e-mails repetidos na planilha?

Sim. Salve o ID da mensagem e consulte essa coluna antes do Append Row. Se o ID já existir, encerre aquela execução sem criar outra linha.