Workflow simples para registrar novos clientes no banco de dados usando n8n

Neste artigo, você descobrirá passo a passo como criar o fluxo mais simples no n8n para capturar informações de novos clientes e armazená‑las automaticamente em um banco de dados. A abordagem apresentada requer poucos nós, é fácil de adaptar e elimina a necessidade de codificação complexa.

Capturando os dados do cliente

O ponto de partida é definir como os dados chegarão ao n8n. As opções mais comuns são formulários web, e‑mails ou integrações com plataformas de vendas. Para manter a simplicidade, utilizaremos o nó Webhook, que recebe requisições HTTP POST contendo os campos do cliente.

• Passo 1 – Criar o Webhook: No editor do n8n, adicione um nó “Webhook”, escolha o método POST e copie a URL gerada.
• Passo 2 – Testar a chamada: Envie um JSON de teste (por exemplo, via Postman) com os campos nome, email e telefone. Verifique se o n8n exibe os dados recebidos.
• Passo 3 – Validar os campos: Insira um nó “Set” ou “Function” para garantir que nenhum campo obrigatório esteja vazio. Use expressões simples como {{ $json["email"] ? $json["email"] : throw new Error("Email ausente") }}.

Com a captura e validação concluídas, o próximo passo é encaminhar esses dados para o banco de dados.

Persistindo o cliente no banco de dados

Para armazenar as informações, o n8n oferece nós nativos para MySQL, PostgreSQL, SQLite e outros. Aqui usaremos o nó PostgreSQL como exemplo, mas o procedimento é análogo para outras bases.

• Passo 1 – Conectar ao banco: Arraste o nó “PostgreSQL” ao fluxo, configure a conexão (host, porta, usuário, senha e nome do banco) e teste a conexão.
• Passo 2 – Inserir o registro: No campo “Query”, escreva a instrução INSERT INTO clientes (nome, email, telefone) VALUES ({{$json["nome"]}}, {{$json["email"]}}, {{$json["telefone"]}}). Utilize as chaves {{$json["campo"]}} para mapear os valores recebidos.
• Passo 3 – Tratar possíveis erros: Conecte um nó “Error Trigger” ao fluxo para capturar falhas de conexão ou violação de restrições (como e‑mail duplicado). Opcionalmente, envie um e‑mail de notificação ao administrador.

Para fechar o ciclo, adicione um nó “Respond to Webhook” que devolva ao cliente uma mensagem de sucesso ou erro, indicando se o cadastro foi realizado corretamente.

Conclusão

Com apenas três nós – Webhook, Set/Function e PostgreSQL – você cria um workflow totalmente funcional que recebe dados de novos clientes e os grava em um banco de dados de forma automática e segura. Essa estrutura modular permite expandir o fluxo facilmente, integrando validações avançadas, automação de e‑mails ou sincronização com CRM. Comece agora a implementar o seu processo de cadastro e acelere a coleta de informações valiosas para o seu negócio.