Automações com n8n: Guia Completo Para Iniciantes

A arte de criar automações com n8n pode transformar completamente a maneira como lidamos com tarefas digitais. Conseguir desenvolver um fluxo de trabalho inteligente que elimina aquelas atividades repetitivas do dia a dia é o objetivo de muitos profissionais de tecnologia. E se você pudesse fazer tudo isso com uma ferramenta de código aberto, poderosa e gratuita?

É exatamente isso que vamos explorar neste guia completo. Apresentamos o n8n (pronuncia-se “n-eight-n”), uma plataforma que permite criar workflows de automação com uma abordagem low-code, conectando APIs, serviços diversos e bancos de dados de forma visual e escalável.

Neste tutorial, vamos construir juntos um workflow prático: um sistema que verifica o status de uma lista de sites e, caso algum deles esteja fora do ar, envia uma notificação instantânea para você. Vamos cobrir desde a instalação e configuração da ferramenta até a criação do nosso fluxo de automação do zero.

O que é o n8n?

O n8n é uma ferramenta de automação de fluxo de trabalho que se destaca por ser open source e auto-hospedável. Isso significa que você tem total controle sobre seus dados e automações. Ele permite personalizações avançadas com JavaScript e Python, mas sua interface visual intuitiva torna a criação de automações acessível mesmo para quem não tem profundo conhecimento em programação.

Você pode executá-lo de forma local na sua máquina ou implantá-lo em um servidor próprio, garantindo flexibilidade e escalabilidade para seus projetos.

Preparando o Ambiente para Suas Automações com n8n

Existem duas maneiras principais de configurar o n8n: localmente com Docker para desenvolvimento e testes, ou em um servidor VPS para um ambiente de produção.

1. Instalação Local com Docker

Usar o Docker é uma das formas mais simples de rodar o n8n. Você pode criar um arquivo docker-compose.yml para definir o serviço.

Um ponto crucial na configuração são as variáveis de ambiente. É fundamental definir o GENERIC_TIMEZONE para garantir que as execuções agendadas e os registros de data funcionem corretamente na sua localidade.


# Exemplo de um arquivo docker-compose.yml simples
version: '3'
services:
  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - GENERIC_TIMEZONE=America/Sao_Paulo
    volumes:
      - ./n8n_data:/home/node/.n8n

Com este arquivo, basta executar o comando docker-compose up no terminal para iniciar sua instância do n8n.

2. Instalação em um Servidor (VPS)

Para um uso mais robusto, o ideal é instalar o n8n em um Servidor Privado Virtual (VPS). Muitos provedores de hospedagem oferecem templates ou instaladores de um clique que já preparam todo o ambiente com Docker e o n8n, facilitando enormemente o processo. Essa abordagem permite que suas automações rodem 24/7 e sejam acessíveis de qualquer lugar.

Primeiros Passos na Interface do n8n

Após a instalação, ao acessar o endereço do seu n8n, você criará uma conta de administrador e será direcionado para a tela principal. A interface é limpa e organizada em torno de alguns conceitos centrais:

Workflows: É aqui que a mágica acontece. Cada workflow é um fluxo de automação composto por “nós” interligados.
Credentials (Credenciais): Para se conectar a serviços como Telegram, Google Sheets, Slack ou qualquer API, você precisa configurar as credenciais de acesso. O n8n armazena essas chaves de forma segura para que você possa reutilizá-las em seus workflows.
Executions (Execuções): Esta área funciona como um log, registrando todas as vezes que seus workflows foram executados. É essencial para depurar e monitorar o funcionamento das suas automações.
Templates: O n8n possui uma vasta biblioteca de workflows prontos que você pode importar e adaptar. É uma excelente fonte de aprendizado para entender como resolver problemas comuns.

Construindo Suas Primeiras Automações com n8n: Monitor de Sites

Vamos ao que interessa: criar nosso sistema de monitoramento. Construir automações com n8n é um processo lógico e visual, como veremos a seguir.

Passo 1: Criar o Workflow e Definir o Gatilho (Trigger)

Todo workflow começa com um gatilho (trigger), que é o evento que inicia a automação.
1. No painel principal, clique em Add workflow.
2. O primeiro nó é o gatilho. Você pode escolher entre vários tipos: manual, agendado (cron), por webhook, etc.
3. Para nosso caso, adicionaremos um gatilho do tipo Schedule (Agendado). Configure-o para rodar a cada 10 minutos. Isso fará com que a verificação dos sites seja executada periodicamente.
Passo 2: Ler a Lista de Sites

Nossa automação precisa de uma lista de URLs para verificar. Vamos armazená-las em um arquivo de texto simples (.txt), com uma URL por linha.
1. Clique no ícone + para adicionar um novo nó e pesquise por Read Binary File.
2. No campo File Path, informe o caminho para o seu arquivo de texto dentro do contêiner Docker. Por exemplo: /home/node/data/lista_sites.txt.
3. É importante notar que este nó lê o arquivo como dados binários. Precisaremos convertê-lo a seguir.
Passo 3: Converter e Processar os Dados com o Nó de Código

Agora que temos o conteúdo do arquivo, precisamos transformá-lo de binário para uma lista de URLs utilizável.
1. Adicione um nó Code. Este nó permite executar código JavaScript personalizado.
2. O código a seguir pega os dados binários do nó anterior, converte para uma string, divide o texto em linhas para criar um array de URLs e retorna um JSON estruturado.
```
// Pega os dados binários do item de entrada
const binaryData = items[0].binary.data;

// Converte o buffer binário para uma string UTF-8
const fileContent = Buffer.from(binaryData).toString('utf-8');

// Divide o conteúdo por quebras de linha, remove linhas vazias e espaços
const urls = fileContent.split('\n').filter(line => line.trim() !== '').map(line => line.trim());

// Retorna um novo array de itens, cada um com uma URL
return urls.map(url => ({
  json: {
    url: url
  }
}));
```
Ao final deste passo, teremos uma saída de dados organizada, pronta para ser processada pelo próximo nó.
Passo 4: Fazer a Requisição HTTP para Cada Site

Este é o coração do nosso workflow. O n8n irá percorrer a lista de URLs e fazer uma requisição para cada uma.
1. Adicione um nó HTTP Request.
2. No campo URL, vamos usar uma expressão para pegar dinamicamente a URL de cada item que vem do nó anterior. Clique no ícone de engrenagem e arraste o campo url da entrada para o campo URL. A expressão ficará algo como {{ $json["url"] }}.
3. Vá até a aba Settings do nó e, na opção Continue On Fail, ative-a. Isso é MUITO IMPORTANTE! Por padrão, se uma requisição falhar (ex: site fora do ar), o workflow para. Com essa opção, ele continua, separando a saída em um caminho de sucesso e um de erro.
Passo 5: Filtrar os Resultados com o Nó “IF”

Agora temos duas saídas do nó HTTP Request: uma para sucessos (status 200) e outra para falhas. Vamos nos concentrar na saída de erro.
1. Conecte um nó IF à saída de erro (vermelha) do nó HTTP Request.
2. Configure a condição para verificar se o status da resposta não é igual a 200. Isso garante que qualquer problema (404, 500, etc.) seja capturado.
Passo 6: Enviar a Notificação via Telegram

Finalmente, se a condição do nó IF for verdadeira (ou seja, um site está com problemas), enviaremos uma mensagem.
1. Primeiro, vá até a seção Credentials no menu principal e adicione suas credenciais do Bot do Telegram. Você precisará do Token do Bot, que pode ser obtido conversando com o “BotFather” no próprio Telegram.
2. De volta ao workflow, adicione um nó Telegram conectado à saída “true” do nó IF.
3. Selecione sua credencial recém-criada.
4. No campo Chat ID, insira o ID do chat para onde a mensagem será enviada.
5. No campo Text, crie uma mensagem personalizada usando expressões para incluir informações úteis, como a URL que falhou e a data da verificação.
Exemplo de mensagem:
⚠️ Alerta! O site {{ $json["url"] }} parece estar fora do ar. Verificado em: {{ new Date().toLocaleString('pt-BR') }}

Testando e Ativando o Workflow

Com todos os nós configurados e conectados, você pode clicar em Execute Workflow para fazer um teste manual. Se você incluiu uma URL inválida na sua lista, deverá receber uma notificação no Telegram em instantes.

Quando estiver satisfeito com o resultado, não se esqueça de ativar o workflow usando o seletor no canto superior direito. A partir de agora, sua automação rodará no intervalo agendado, monitorando seus sites de forma autônoma.

Automações com n8n: Conclusão

O n8n é uma ferramenta extraordinariamente versátil que democratiza a criação de automações com n8n. O que construímos aqui é apenas um exemplo simples do seu potencial. Explore os mais de 300 nós disponíveis e pense em quais outras tarefas manuais você poderia automatizar para economizar tempo e aumentar sua produtividade.

Agora é sua vez: que tipo de automação você vai criar? As possibilidades são infinitas.

Evolution