Além do Script

O que é a ferramenta de automações N8N?

—

in

Oi, galera! Preparados para mais um papo?

Hoje falaremos um pouco sobre a ferramenta de automações N8N, que é bastante aceita pelos desenvolvedores principalmente para automações internas.

Tópicos:

  • O que é o N8N?
  • Funcionamento
  • Componentes
  • Exemplo de Funcionamento
  • Como rodar localmente?
  • Casos de alta demanda

O que é o N8N?

O n8n é uma ferramenta de automação de workflows open-source que permite a criação de fluxos de trabalho complexos sem a necessidade de programação.
Funciona como uma plataforma de low-code e no-code, permitindo que tanto desenvolvedores quanto usuários sem experiência em programação criem automações.
O n8n oferece suporte a mais de 200 integrações nativas com serviços como Google Sheets, Slack, Trello, GitHub, entre outros, além de permitir a criação de conexões personalizadas via APIs.

Mais informações: https://n8n.io/

Funcionamento

A execução no n8n segue uma lógica bem estruturada, baseada nos fluxos de trabalho que você configura. Os fluxos no n8n são conjuntos de tarefas interconectadas que seguem uma lógica definida pelo usuário para automatizar processos.
Cada fluxo é composto por nós, que representam ações, serviços, ou operações.

Pense em um fluxo como um “diagrama de tarefas”, onde você especifica:

  1. O que precisa ser feito (os nós e suas ações).
  2. A ordem das tarefas (como os nodes estão conectados).
  3. As condições ou decisões (fluxos condicionais ou paralelos).

Componentes de um Fluxo

Nós:

  • Cada tarefa ou ação em um fluxo é representada por um node.
  • Exemplos de nós:
    • Gatilhos: Iniciam o fluxo (ex.: webhook, cron).
    • Ações: Realizam tarefas, como enviar um e-mail, chamar uma API, ou inserir dados em um banco.
    • Funções: Permitem manipular ou transformar dados usando código JavaScript.
    • Condicionais: Tomam decisões baseadas em condições (ex.: “Se o valor X for maior que Y, faça isso; caso contrário, faça aquilo”)

Conexões:

  • Os nodes são conectados por linhas que definem a ordem de execução.
  • As conexões podem ser simples (sequenciais) ou ramificadas (condicionais e paralelas).

Dados

  • Cada node passa dados para o próximo, e esses dados podem ser transformados ou usados em condições durante o fluxo.

Exemplo de funcionamento

O fluxo abaixo tem o seguinte funcionamento:

  1. O fluxo começa ao clicar no botão de teste.
  2. O nó Edit Fields cria um JSON com o valor "novo valor".
  3. O nó Google Sheets adiciona esse valor à planilha na aba especificada.

Detalhes

  • Trigger Manual (Nó: When clicking ‘Test workflow’)
    • O que faz: Este nó é um gatilho manual. Ele inicia o fluxo quando o botão “Test workflow” é clicado no editor do n8n.
    • Para que serve: É útil para testar o fluxo durante a criação ou depuração.
  • Editar Campos (Nó: Edit Fields):
    • O que faz: Este nó define ou edita dados no formato JSON.
    • Configuração:
      • Cria um campo chamado test com o valor "novo valor".
      • O resultado desse nó é o seguinte JSON:
        • { "test": "novo valor" }
    • Para que serve: Prepara os dados para serem usados no próximo nó.
  • Google Sheets (Nó: Google Sheets):
    • O que faz: Este nó adiciona os dados ao Google Sheets.
    • Configuração:
      • Ele se conecta a uma planilha específica usando um ID do Google Sheets.
      • Localiza a aba chamada Página1 (referenciada pelo gid=0).
      • Adiciona uma nova linha com o valor do campo test.
      • Coluna na planilha:
        • Coluna “test”: Recebe o valor "novo valor".
    • Para que serve: Atualiza automaticamente a planilha com os dados processados no fluxo.

Como rodar localmente?

O Docker é a maneira mais prática de rodar o n8n, pois simplifica o setup e evita problemas de dependências.

Usando Node.js

Esse é um método alternativo para subir o n8n com o intuito de testá-lo, para casos mais avançados utilize a instalação via Docker.

  1. Instale o Node.js:
    • Certifique-se de ter o Node.js instalado (recomenda-se a versão 16 ou superior).
    • https://nodejs.org/
  2. Instale o n8n globalmente: No terminal, execute:
    npm install -g n8n
  3. Inicie o n8n: Execute o comando:
    n8n
  • O n8n estará disponível em: http://localhost:5678.

Espero que tenha gostado! Até breve!