Pular para o conteúdo
JSMS
Automação

Como criar uma automação no n8n para receber um formulário e enviar e-mail

· 7 min de leitura

# Como criar uma automação no n8n para receber um formulário e enviar e-mail

Você pode usar um Webhook no n8n para receber os dados de um formulário e o nó do Gmail para enviar uma mensagem automaticamente. O fluxo básico tem três partes: entrada, tratamento e saída. Neste tutorial, a entrada será um Webhook, e a saída será um e-mail com os dados recebidos.

O Webhook do n8n funciona como um endereço que recebe requisições de outros serviços e inicia um workflow. Ele oferece URLs separadas para teste e produção, além de autenticação básica, por cabeçalho ou JWT.[4] O nó do Gmail, por sua vez, permite criar, consultar, responder e enviar mensagens depois que a credencial do Google foi configurada.[5]

Mapa visual de um workflow de automação

O que você vai precisar

  • uma instalação do n8n Cloud ou uma instância própria;
  • acesso para criar um workflow;
  • uma conta do Google para enviar o e-mail;
  • um formulário ou serviço capaz de fazer uma requisição HTTP;
  • um endereço de e-mail de destino para o teste.

Não coloque senhas ou tokens diretamente em campos de texto do workflow. Use o sistema de credenciais do n8n e limite o acesso de cada integração ao necessário.

1. Crie um workflow novo

Abra o n8n e crie um workflow vazio. Dê um nome que descreva o processo, como “Novo contato do site para e-mail”.

Clique em Add first step e procure pelo nó Webhook. Escolha o evento que inicia o fluxo. O Webhook precisa estar na primeira posição porque será o gatilho que recebe os dados.

2. Configure o Webhook

No nó Webhook, escolha:

  • HTTP Method: POST;
  • Path: um caminho simples, como novo-contato;
  • Authentication: Header Auth ou outra opção adequada;
  • Respond: Immediately, se você só precisa confirmar o recebimento.

Durante o desenvolvimento, use a Test URL e clique em Listen for test event. O n8n registra a URL de teste quando você inicia a escuta. A URL de produção só deve ser usada depois que o workflow estiver pronto e publicado.[4]

Se o formulário enviar JSON, uma carga de teste pode ter esta aparência:

{
  "nome": "Ana Souza",
  "email": "ana@example.com",
  "assunto": "Orçamento",
  "mensagem": "Gostaria de receber mais informações."
}

Você pode testar o endpoint com uma ferramenta de requisições HTTP. Substitua a URL pelo endereço exibido pelo seu n8n:

curl -X POST "URL_DE_TESTE_DO_N8N" \
  -H "Content-Type: application/json" \
  -H "X-Automacao-Token: SEU_TOKEN" \
  -d '{
    "nome": "Ana Souza",
    "email": "ana@example.com",
    "assunto": "Orçamento",
    "mensagem": "Gostaria de receber mais informações."
  }'

O token acima é apenas um exemplo. Não publique o valor real em um artigo, repositório ou captura de tela.

3. Confira os dados recebidos

Fluxo de automação de mensagens de e-mail

Depois de enviar a requisição, volte ao n8n e veja a saída do Webhook. Confirme onde cada campo apareceu. Dependendo do formato da chamada, os dados podem estar dentro de body, nos cabeçalhos ou nos parâmetros da URL.

Se o JSON foi recebido como no exemplo, você poderá usar expressões semelhantes a:

{{ $json.body.nome }}
{{ $json.body.email }}
{{ $json.body.assunto }}
{{ $json.body.mensagem }}

Os nomes precisam corresponder exatamente ao payload recebido. Se o campo chegar como name em vez de nome, a expressão com nome ficará vazia.

4. Adicione o nó do Gmail

Clique no sinal de conexão depois do Webhook e adicione Gmail. Escolha a operação de envio de mensagem.

Na primeira configuração, crie ou selecione uma credencial do Google. O n8n orienta a configuração de credenciais Google e informa que o nó Gmail usa essa autenticação para executar operações na conta.[5]

Preencha os campos principais:

  • To: o endereço que receberá o aviso;
  • Subject: um assunto que identifique o novo contato;
  • Email Type: o formato desejado;
  • Message: o conteúdo da mensagem.

Um exemplo de assunto é:

Novo contato: {{ $json.body.assunto }}

No corpo, use os dados do formulário:

Nome: {{ $json.body.nome }}
E-mail: {{ $json.body.email }}

Mensagem:
{{ $json.body.mensagem }}

Se o workflow for usado em uma empresa, considere enviar para uma caixa de atendimento em vez de uma pessoa. Assim, o processo não para quando alguém está de férias ou deixa a equipe.

5. Teste o fluxo completo

Com o Webhook ainda escutando a URL de teste, envie uma nova requisição. O n8n deverá mostrar uma execução com os dois nós concluídos.

Verifique:

  • se todos os campos chegaram;
  • se o destinatário está correto;
  • se o assunto não ficou vazio;
  • se caracteres acentuados aparecem corretamente;
  • se a mensagem não caiu no spam;
  • se o workflow não enviou duplicado.

Não teste usando uma lista de clientes reais. Comece com endereços controlados pela equipe e remova dados pessoais das execuções antigas quando a política interna exigir.

6. Publique a automação

Quando o fluxo estiver funcionando, salve e publique o workflow. O n8n passa a usar a Production URL do Webhook quando o workflow está ativo. A URL de produção não funciona como a de teste: as execuções aparecem no histórico, mas não ficam expostas da mesma maneira no editor.[4]

Atualize o formulário para chamar a URL de produção e faça um último teste. Só depois desative o endereço antigo ou remova o código de teste.

Como proteger o Webhook

Diagrama de arquitetura de rede

Um Webhook sem autenticação pode ser chamado por qualquer pessoa que descubra a URL. Isso permite spam, envio de e-mails indevidos e consumo desnecessário da infraestrutura.

Use pelo menos uma destas medidas:

  • autenticação por cabeçalho;
  • autenticação básica;
  • JWT quando o serviço de origem já trabalha com tokens assinados;
  • allowlist de IP quando a origem tiver endereços estáveis;
  • validação de campos antes de enviar o e-mail;
  • limite de frequência no proxy ou na infraestrutura.

O n8n também oferece opções de allowlist de IP e uma condição para executar o fluxo apenas quando o conteúdo recebido atender a um critério.[4] Essas medidas não substituem a validação do lado do sistema que envia os dados.

Problemas comuns

O e-mail não chega

Confira a execução no n8n e veja se o Gmail retornou erro. Depois verifique spam, filtros e limites da conta. Não conclua que o formulário falhou antes de olhar o histórico de execução.

O campo aparece vazio

Abra a saída do Webhook e compare o caminho real com a expressão usada no Gmail. O dado pode estar em body.nome, nome ou em outro objeto, dependendo do sistema de origem.

O workflow envia várias mensagens

Veja se o formulário está repetindo a requisição ou se o navegador está reenviando a página. Também confira se há mais de um gatilho conectado ao fluxo.

Conclusão

Webhook e Gmail resolvem uma automação simples sem exigir um sistema de CRM completo. O ponto que costuma ser ignorado é a segurança: endereço público, autenticação e validação devem entrar no projeto desde o primeiro teste. Depois, o mesmo fluxo pode ganhar uma planilha, um CRM ou uma etapa de aprovação sem precisar recomeçar do zero.

Se o Webhook ficará exposto na internet, veja também o tutorial do JSMS sobre como proteger um Webhook público no n8n.

Fontes

Consultado em 18 de agosto de 2026.

Sources

[4] https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.webhook [5] https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-base.gmail