Do zero ao primeiro fluxo a trabalhar

O n8n é o motor onde as automações funcionam. Há duas formas de o ter, e a diferença entre elas é maior do que parece.

O meu conselho sem rodeios: se é a tua primeira automação, começa na nuvem. Põe o fluxo a funcionar hoje e decide depois se vale a pena mudar para casa. Ter o motor instalado e nenhuma automação a correr não serve de nada a ninguém.

O caminho mais limpo, tanto no Windows como no Mac, é o Docker, que é um programa que corre outros programas dentro de uma caixa isolada.

Mac: instala o Docker Desktop a partir de docker.com, abre-o, e espera que a baleia no topo do ecrã fique fixa. Depois abre a aplicação Terminal e cola:

docker run -d --restart unless-stopped --name n8n \
  -p 5678:5678 -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Windows: o mesmo Docker Desktop, mas durante a instalação aceita quando pedir para ativar o WSL2, que é o que permite ao Windows correr isto. Depois abre o PowerShell e cola o mesmo comando, tudo numa linha só.

Em qualquer dos casos, abre o browser em localhost:5678 e cria a tua conta. O --restart unless-stopped faz com que volte a arrancar sozinho quando ligares o computador.

Atenção a uma coisa que ninguém avisa: se o n8n estiver no teu computador, as automações só correm com o computador ligado. Para coisas que têm de acontecer todos os dias às nove da manhã, ou usas a nuvem, ou pões isto num servidor.

Na página dos fluxos, carrega em copiar. Depois, no n8n, cria um fluxo novo no botão de mais, clica uma vez na área em branco e faz Ctrl+V no Windows ou Cmd+V no Mac. Os nós aparecem todos ligados.

Se preferires o ficheiro, usa o menu dos três pontos no canto superior direito e escolhe Import from File.

Esta é a única parte chata, e só se faz uma vez. Clica num nó que tenha Gmail, Drive ou Sheets no nome, e em Credential to connect with escolhe criar nova.

Na nuvem: aparece um botão para entrar com o Google, escolhes a conta, aceitas, e acabou.

Em casa: o n8n mostra-te um endereço de redirecionamento e pede duas chaves. Tens de as ir buscar à Google Cloud Console: criar um projeto, ativar as APIs do Gmail, do Drive e do Sheets, criar credenciais OAuth do tipo aplicação web, e colar lá o endereço que o n8n te deu. O próprio n8n tem o passo a passo com imagens em docs.n8n.io, e vale a pena segui-lo à letra.

Depois de ligada, a mesma credencial serve para todos os nós do Google em todos os fluxos. É por isso que só dói uma vez.

Um fluxo é uma fila de caixas, cada uma faz uma coisa e passa o resultado à seguinte. Aqui vão as caixas dos dois fluxos abertos, uma a uma.

Nunca ligues um fluxo sem o ver correr uma vez. Carrega em Execute workflow e repara nos números que aparecem por cima de cada seta: é a quantidade de coisas que passaram ali. Se um nó receber zero, o problema está no anterior.

Clica num nó depois de correr e vês, do lado esquerdo, o que ele recebeu, e do direito, o que devolveu. É assim que se percebe tudo o que corre mal.

Só quando estiver bem é que ligas o interruptor Active no canto superior direito.