Ler e-mails no n8n: receber, responder e organizar

Como ler e-mails no n8n com o nó Gmail: credencial OAuth2 ou Service Account, Gmail Trigger, respostas, marcadores e a diferença para o nó Send Email.

Por Redação Eleven Host · @robson.direitodigital · 31 de outubro de 2026 · 9 min de leitura

Para ler e-mails no n8n, use o nó Gmail, que lê, envia, marca e organiza mensagens de uma conta Gmail dentro do fluxo, ou o Gmail Trigger, que inicia o fluxo quando chega uma mensagem nova. Os dois usam uma credencial Google.

Este guia mostra o que o nó Gmail faz, como escolher entre OAuth2 e Service Account, o passo a passo para enviar um e-mail, como ler e responder mensagens, como configurar o Gmail Trigger e quando usar o nó Send Email no lugar. Os nomes de campos e opções seguem a documentação do n8n, em inglês, como aparecem na tela.

O que dá para fazer com o nó Gmail

Segundo a documentação do n8n, o nó Gmail organiza as operações em quatro recursos: Draft, Label, Message e Thread. Em cada recurso, você escolhe a operação no campo Operation. A lista da documentação é esta:

• Draft: Create a draft, Delete a draft, Get a draft, Get Many drafts.
• Label: Create a label, Delete a label, Get a label, Get Many labels.
• Message: Add Label to a message, Delete a message, Get a message, Get Many messages, Mark as Read, Mark as Unread, Remove Label from a message, Reply to a message, Send a message.
• Thread: Add Label to a thread, Delete a thread, Get a thread, Get Many threads, Remove Label from thread, Reply to a message, Trash a thread, Untrash a thread.

Para uma operação que o nó não oferece, a documentação manda usar o nó HTTP Request com a credencial do Gmail.

Credencial: OAuth2 ou Service Account

A documentação de credenciais do Google informa que os nós de serviços Google aceitam dois métodos de autenticação: OAuth2 e Service Account. Para o Gmail, o n8n recomenda usar OAuth2. A documentação descreve o OAuth2 como o método recomendado por estar mais disponível e ser mais fácil de configurar.

A Service Account com o Gmail exige a delegação em todo o domínio (domain-wide delegation), que a documentação diz que o Google desaconselha. Ela permite se passar por outros usuários, inclusive super administradores, e o próprio texto avisa que isso pode representar um risco de segurança. Por isso, este guia segue o OAuth2.

Se você usa o n8n Cloud

A documentação descreve o OAuth2 gerenciado (managed OAuth2) como disponível nos planos do n8n Cloud e indisponível em instalações self-hosted. Nele, você entra com o Google direto no n8n, sem configuração no Google Cloud Console.

Se o n8n é self-hosted

Aqui você precisa criar o seu próprio aplicativo OAuth no Google Cloud. Os passos da documentação, na ordem:

1. Crie um projeto no Google Cloud Console.
2. Em APIs & Services > Library, ative a Gmail API.
3. Em APIs & Services > OAuth consent screen, clique em Get started e informe o nome do app e um e-mail de suporte.
4. Escolha o User type: Internal, só para usuários da sua organização Google Workspace, ou External, para qualquer conta Google. O External começa em modo Testing, e só os usuários de teste (test users) conseguem concluir a conexão.
5. Em Branding, adicione o domínio da sua instância do n8n em Authorized domains.
6. Em APIs & Services > Credentials, clique em + Create credentials, escolha OAuth client ID e o tipo Web application.
7. Na credencial do n8n, copie a OAuth Redirect URL e cole em Authorized redirect URIs no Google.
8. Cole o Client ID e o Client Secret na credencial do n8n e clique em Sign in with Google.

A documentação avisa que, no modo Testing com External, o consentimento e os tokens expiram em sete dias, então a credencial precisa ser reconectada. Se aparecer o erro redirect_uri_mismatch, a URI não bate com as registradas no cliente OAuth do Google Cloud, incluindo http ou https e a porta. Se aparecer invalid_client, o Client ID ou o Client Secret não confere; copie de novo e cuide dos espaços.

Passo a passo: enviar um e-mail com o nó Gmail

Com a credencial pronta, o envio segue os campos que a documentação lista para a operação de enviar mensagem:

1. Adicione o nó Gmail ao fluxo.
2. Em Credential to connect with, escolha a credencial Google que você criou.
3. Em Resource, escolha Message.
4. Em Operation, escolha Send a message.
5. Em To, informe o destinatário, por exemplo cliente@exemplo.com.
6. Em Subject, escreva o assunto.
7. Em Email Type, escolha Text ou HTML.
8. Em Message, escreva o corpo do e-mail.
9. Execute o nó e confira a mensagem na caixa do destinatário.

Na área Options, a documentação lista: Append n8n attribution, Attachments, BCC, CC, Sender Name, Send Replies To e Reply to Sender Only.

• Append n8n attribution: por padrão, o nó acrescenta ao e-mail a frase "This email was sent automatically with n8n". Para tirar, use Options > Add option > Append n8n attribution e deixe desligado.
• Attachments: selecione Add Attachment e informe o Attachment Field Name (in Input). Para mais de um anexo, use uma lista separada por vírgula.

Ler e-mails no n8n e responder

Para ler, use o recurso Message com a operação Get Many. A documentação lista estes campos: Return All, Limit e Simplify. Os filtros (Filters) são:

• Include Spam and Trash
• Label Names or IDs
• Search
• Read Status: Unread and read emails, Unread emails only (padrão) ou Read emails only
• Received After e Received Before: retornam só os e-mails recebidos depois ou antes da data e hora informadas, com seletor de data ou expressão com texto ISO ou carimbo de tempo em milissegundos
• Sender

Como o Read Status vem com "Unread emails only" por padrão, o Get Many traz só mensagens não lidas até você mudar o filtro.

Para responder, escolha a operação Reply to a message. Os campos são Message ID, Email Type e Message, e as opções são Append n8n attribution, Attachments, BCC, CC, Sender Name e Reply to Sender Only. Segundo a documentação, essa última opção escolhe entre responder com a opção desligada (reply all) e responder só ao remetente (ligada).

Para organizar a caixa, as operações Mark as Read, Mark as Unread e Delete a message pedem só o Message ID. Add Label to a message e Remove Label from a message pedem o Message ID e os rótulos em Label Names or IDs. Depois de buscar vários e-mails, o guia Filter no n8n: como filtrar itens no seu fluxo mostra como ficar só com os itens que interessam.

Para automatizar e-mails no seu próprio n8n: n8n Essencial a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Ver planos de n8n

Gmail Trigger: iniciar o fluxo com e-mail novo

O Gmail Trigger é o nó de início. A documentação traz um evento, Message Received: o nó dispara para mensagens novas no horário de verificação escolhido (Poll Time). Veja os campos:

• Credential to connect with: a credencial Google do gatilho.
• Poll Times: define com que frequência o n8n verifica se há e-mails novos.
• Simplify: devolve uma versão simplificada da resposta (ligado, que é o padrão) ou os dados brutos (desligado).
• Max Emails per Poll: o máximo de e-mails que o nó busca por ciclo. O padrão é 10 e o máximo é 50. Se houver mais e-mails não lidos que o limite, o restante fica para o próximo ciclo.

Os filtros do gatilho são Include Spam and Trash, Label Names or IDs (só dispara para mensagens com os rótulos escolhidos), Search (aceita filtros de busca do Gmail, como from:), Read Status (o padrão é "Unread emails only") e Sender (um e-mail ou parte do nome do remetente).

Quando algo dá erro

A documentação do nó Gmail registra estes problemas:

• Forbidden - perhaps check your credentials: aparece, por exemplo, ao carregar o campo Label Names or IDs. A documentação diz que acontece mais com Google Service Account sem Impersonate a User, e a solução é ligar essa opção.
• 401 unauthorized error: com OAuth2, ative a Gmail API em APIs & Services > Library. Com Service Account, ative a delegação em todo o domínio e inclua a Gmail API nela. A mesma solução vale para o Gmail Trigger.
• Bad request - please check your parameters: o Message ID, o Thread ID ou o Label ID informado não existe. Confira o valor com uma operação Get.

Gmail ou nó Send Email

O nó Gmail trabalha com uma conta Gmail e com a caixa dela: envia, mas também lê, responde, marca, usa rótulos e rascunhos. Já o nó Send Email, descrito no guia Enviar e-mail no n8n: como usar o nó Send Email, é outro nó, com configuração própria. Se o fluxo precisa ler a caixa do Gmail, use o nó Gmail.

Quer conhecer o n8n da Eleven Host? O n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Conhecer o n8n Essencial

Perguntas frequentes

O que o nó Gmail do n8n faz?

Ele envia, lê, responde, marca e organiza e-mails de uma conta Gmail, além de trabalhar com rascunhos, rótulos e conversas (threads).

Qual credencial usar no Gmail?

A documentação do n8n recomenda OAuth2 com o nó Gmail. A Service Account exige delegação em todo o domínio, que o Google desaconselha.

Como ler e-mails no n8n?

Use o nó Gmail com o recurso Message e a operação Get Many. Ele traz por padrão só e-mails não lidos; mude o Read Status se quiser também os lidos.

Como iniciar um fluxo quando chega e-mail?

Use o Gmail Trigger com o evento Message Received. Ele verifica o Gmail no Poll Time escolhido e busca até o limite de Max Emails per Poll.

Como tirar a frase "This email was sent automatically with n8n"?

No nó Gmail, abra Options, clique em Add option, escolha Append n8n attribution e deixe desligado.