O que é e por que usar
Enviar emails manualmente para clientes, leads ou membros da equipe consome tempo e está sujeito a erros. Com o n8n e o nó nativo do Gmail, você pode automatizar disparos de email de forma segura e flexível — sem depender de serviços de terceiros ou plataformas de email marketing caras. O n8n conecta-se à API do Gmail usando OAuth 2.0, permitindo enviar emails com conteúdo dinâmico, anexos e até mesmo rastreamento básico.
O principal benefício é a integração direta com mais de 400 serviços: um novo lead capturado via formulário no Google Sheets pode disparar automaticamente um email de boas-vindas personalizado; uma atualização no status de um pedido pode gerar uma notificação ao cliente. Tudo sem escrever uma única linha de código complexo.
Neste artigo, você aprenderá a criar um fluxo de automação que envia emails automaticamente sempre que uma nova linha for adicionada a uma planilha do Google Sheets. O mesmo princípio pode ser adaptado para webhooks, bancos de dados ou qualquer gatilho que o n8n suporte.
Pré-requisitos
- Uma instância do n8n (self-hosted, n8n.cloud ou Docker).
- Uma conta Google com o Gmail ativo.
- Permissão para criar e gerenciar credenciais OAuth no Google Cloud Console.
- Conhecimento básico sobre nós e fluxos no n8n (saber conectar nós e usar expressões).
- Uma planilha no Google Sheets (exemplo: “Leads”) com colunas como Nome, Email, Empresa.
Exemplo Prático: Envio automático de e-mail de boas-vindas a partir de uma planilha
Cenário concreto
Imagine que você gerencia um site SaaS com teste gratuito. Toda vez que um usuário se cadastra, os dados (nome, email, data de cadastro) são salvos em uma planilha do Google Sheets chamada “Usuários Novos”. Você precisa enviar um email de boas-vindas personalizado instantes após o cadastro, sem precisar abrir o Gmail ou copiar dados manualmente.
O que será automatizado
- Gatilho: nova linha inserida na planilha “Usuários Novos”
- Ação: extrair nome e email da nova linha
- Ação: montar um email com assunto e corpo personalizados
- Ação: enviar o email via Gmail (conta configurada no n8n)
Resultado esperado
Após configurar o fluxo, qualquer nova linha adicionada à planilha (manualmente ou por integração com formulário) dispara automaticamente um email de boas-vindas para o endereço informado. O email chega em segundos na caixa de entrada do destinatário, com o nome e conteúdo personalizados.
Configuração Passo a Passo
1. Criar as credenciais OAuth do Gmail no n8n
- Acesse o Google Cloud Console e crie um projeto (ou use um existente).
- Ative a API do Gmail (Gmail API).
- Em “Credenciais”, crie um ID de cliente OAuth 2.0 do tipo “Aplicativo da Web”.
- Adicione o URI de redirecionamento:
https://seu-dominio-n8n/rest/oauth2-credential/callback(se usar n8n.cloud, use o domínio padrão). - Copie o Client ID e Client Secret.
- No n8n, vá em Credenciais → Adicionar → Gmail OAuth2 API e cole os dados. Autorize a conta do Gmail desejada.
2. Configurar a credencial do Google Sheets
Repita o processo de OAuth para o Google Sheets (ou use uma Service Account se preferir). Para este tutorial, usaremos a mesma conta Google. No n8n, crie uma credencial do tipo “Google Sheets OAuth2 API” com o mesmo Client ID/Secret (ou crie uma separada).
3. Criar o fluxo no n8n
Arraste os seguintes nós para a tela:
- Google Sheets (Trigger) – para escutar novas linhas.
- Gmail (Action) – para enviar o email.
- Function (opcional) – para formatar o corpo do email ou validar dados.
Configuração do nó Google Sheets (Trigger):
- Selecione a credencial do Google Sheets.
- Escolha a planilha e a planilha (sheet) onde os dados estão.
- Em “Operation”, escolha “Watch Rows”.
- Defina o intervalo de células (ex.:
A:D) para capturar todo o registro. - Em “Options”, marque “Return All” como False (para processar apenas a nova linha).
- Clique em “Execute Node” para ativar o gatilho.
Conexão com o nó Function (opcional):
Se o corpo do email precisar de lógica ou template, use um nó Function. Exemplo simples:
// Exemplo de corpo de email em HTML
const nome = $input.first().json.Nome;
const empresa = $input.first().json.Empresa;
return {
to: $input.first().json.Email,
subject: `Bem-vindo, ${nome}!`,
html: `
<h2>Olá ${nome},</h2>
<p>Obrigado por se cadastrar na ${empresa}.</p>
<p>Seu acesso ao teste gratuito já está ativo.</p>
`
};
Configuração do nó Gmail:
- Arraste o nó Gmail e conecte à saída do nó Function (ou diretamente do trigger).
- Na credencial, selecione a que criou para o Gmail.
- Em “Resource”, escolha “Message”.
- Em “Operation”, escolha “Send”.
- Preencha os campos:
-
- To:
{{ $json["to"] }}(ou direto do trigger:{{ $json["Email"] }}) - Subject:
{{ $json["subject"] }}(ou{{ $json["Nome"] }} - Seja bem-vindo) - HTML:
{{ $json["html"] }}(ou monte uma string com expressões) - Send As: Alias da conta (opcional, use o padrão).
- Em “Options”, você pode adicionar anexos ou configurar “Reply To”.
- To:
Exemplo JSON completo do nó Gmail (sem Function):
{
"parameters": {
"to": "={{ $json[\"Email\"] }}",
"subject": "Bem-vindo, {{ $json[\"Nome\"] }}!",
"html": "
Olá {{ $json[\”Nome\”] }},
Obrigado por se cadastrar. Seu teste começa agora.
” }, “resource”: “message”, “operation”: “send”, “authentication”: “oAuth2” }
4. Ativar e testar
-
-
- Adicione uma nova linha na planilha com dados reais (nome, email, empresa).
- O fluxo será disparado em segundos. Verifique o nó Gmail para ver se foi executado com sucesso (ícone verde).
- Acesse a caixa de entrada de teste e confirme o recebimento do email.
-
Dicas e Variações
-
-
- Use templates HTML profissionais: Armazene um template completo em um nó “Set” ou em um campo fixo e insira variáveis com
{{ }}. Assim o email fica mais bonito. - Adicione anexos dinâmicos: no nó Gmail, em “Options”, ative “Attachments” e use expressões para buscar arquivos de URLs ou do sistema de arquivos do n8n.
- Condicionais: use um nó “IF” antes do Gmail para enviar emails apenas para domínios específicos ou quando um campo estiver preenchido.
- Rate limiting: a API do Gmail tem limites de envio (até 2000 mensagens por dia para contas gratuitas). Para grandes volumes, considere usar uma fila de espera ou um nó “Wait”.
- Agendar disparos: combine com o nó “Schedule Trigger” para enviar emails em massa em horários pré-definidos, como resumos semanais.
- Use templates HTML profissionais: Armazene um template completo em um nó “Set” ou em um campo fixo e insira variáveis com
-
Erros Comuns e Como Evitá-los
-
-
- Erro de autenticação OAuth: certifique-se de que o URI de redirecionamento no console do Google corresponde exatamente ao do n8n. Reauthorize a credencial se ela expirar.
- Campos vazios no email: o nó Gmail falha se “To” estiver vazio. Use um nó “Function” para validar os dados antes de enviar, ou configure o nó “IF” para pular linhas com email inválido.
- Quota da API excedida: o Gmail gratuito tem limites diários. Acompanhe o console do Google Cloud e implemente uma pausa entre envios com o nó “Wait” se necessário.
- Formato de data/hora incorreto: ao usar expressões como
{{ new Date() }}, o resultado pode não ser o esperado. Utilize a funçãoformatDatedo n8n ou um nó “Function” para garantir o formato desejado. - Trigger duplicado: se a planilha for atualizada várias vezes seguidas, o nó “Watch Rows” pode disparar múltiplas vezes para a mesma linha. Ative a opção “Poll Times” com intervalo razoável (ex.: 1 minuto) e filtre por timestamps.
-
Próximos Passos
Agora que você tem um fluxo funcional de envio automático de emails, explore outras possibilidades:
-
-
- Responder automaticamente a emails recebidos: use o nó “Gmail: Watch Inbox” (disponível via API) para ler emails e responder com base em palavras-chave.
- Integrar com um CRM: conecte o n8n ao HubSpot, Pipedrive ou Salesforce e dispare emails conforme mudanças de estágio no pipeline.
- Criar um boletim informativo: combine o nó “RSS Feed Read” com o Gmail para enviar resumos de notícias automaticamente.
- Gerar relatórios diários: use o nó “Google Sheets” para buscar dados do dia anterior, montar um resumo em HTML e enviar para a equipe toda manhã.
-
Comece com este fluxo e expanda conforme sua necessidade. A automação com n8n e Gmail é flexível, gratuita e coloca o poder do email marketing inteligente em suas mãos sem depender de plataformas caras.
Gostou do conteúdo? Inscreva-se para receber as novidades:




Comments are closed