Exercício 00 · Encontro 01 · 25 minutos
Começamos por aqui: a conta, a tela e o primeiro fluxo
O que você vai aprender
Você vai entrar na sua conta do n8n, reconhecer os lugares da tela e criar o primeiro fluxo: um gatilho manual e um nó que escreve uma mensagem com a hora de agora. Você sai sabendo executar um fluxo e ler o que ele produziu.
Como começar
- Onde
- O Chrome, na conta do n8n enviada pela Impacta. O endereço é o link do e-mail de convite (termina em .app.n8n.cloud).
- Conversa
- Não há conversa: o n8n é uma tela de desenho. O chat da reunião é onde vão os sinais.
- Pasta
- Nenhuma. Tudo vive na conta.
- Vem de
- A preparação: a conta ativada antes da aula.
- Leva para
- Exercício 1: o formulário que se registra sozinho.
Baixe antes de começar
Situação
Antes de automatizar qualquer coisa, você precisa saber onde está o que na tela e o que acontece quando um fluxo roda. Este exercício é o mapa: os lugares da tela, um fluxo de duas caixinhas e a primeira leitura de saída.
Quatro lugares para decorar: o +, o Execute workflow, o Publish e o OUTPUT.
Abra o link do convite e entre com a conta Google recebida da Impacta. Se pedir um código de verificação, ele chega no Gmail dessa mesma conta. Deixe o kit descompactado na Área de Trabalho.
Passo a passo
5 passos · 25 minO que este exercício monta, caixinha por caixinha
- Gatilho manual
- Edit Fields: mensagem e hora
Entrar e criar o fluxo
4 minutos. Na tela Overview (visão geral) da sua conta. Se a conta abrir em outra tela, clique em Overview no menu da esquerda.
Por que este passo: Todo trabalho no n8n vive dentro de um fluxo: o desenho das caixinhas ligadas por setas. Antes de qualquer caixinha existe o fluxo vazio, com nome.
- Clique em Create workflow (criar fluxo), no alto à direita. Abre a tela quadriculada do fluxo novo.
- No alto à esquerda, depois de Personal, clique no nome My workflow.
- Apague o nome, cole o nome abaixo e tecle Enter.Nome do fluxo · copiar
Olá, Vale Verde
Deve aparecer: Uma tela quadriculada vazia com Add first step... (adicionar o primeiro passo) e Build with AI (construir com IA) no meio. Sinal no chat: ENTREI.
- O nome do fluxo aparece no alto à esquerda, depois de Personal? Se ainda for My workflow, clique nele e cole de novo.
- Não use o Build with AI hoje: o exercício é montar à mão, caixinha por caixinha.
O que acabou de acontecer: O n8n já salvou o fluxo sozinho: não existe botão de salvar. Publicar é outra coisa, e vem no Exercício 1.
O tour de dois minutos
4 minutos. Com o instrutor, encontre na sua tela, sem clicar em nada ainda:
Por que este passo: Quem sabe onde as coisas estão não trava. Os lugares desta tela são os mesmos em todos os fluxos das sete manhãs.
- O menu da esquerda: n8n Assistant (com o selo Preview, que não usamos hoje), Overview (visão geral) e Personal (o seu projeto: tudo o que você cria fica nele). Embaixo, Admin Panel, Templates, Insights, Help e Settings.
- Dentro de Overview, no alto, as abas Workflows (fluxos), Credentials (credenciais), Executions (execuções), Variables (variáveis, que não usamos) e Data tables (tabelas de dados).
- No alto do fluxo: o nome (Personal / Olá, Vale Verde) com o menu de três pontos ao lado, e as abas Editor, Executions e Evaluations.
- O botão Publish (publicar), à direita.
- O botão de mais (+) na borda direita, que abre a lista de nós, e o painel Logs (registros), embaixo. O botão Execute workflow (executar o fluxo) só aparece embaixo depois que o fluxo tem um gatilho: você vai vê-lo no passo 4.
Deve aparecer: Você achou os cinco lugares. Sinal no chat: TOUR.
- Foi até Overview para ver as abas? Volte ao fluxo clicando em Olá, Vale Verde na aba Workflows.
O que acabou de acontecer: Tudo o que você vai fazer hoje cabe em quatro lugares: o +, o Execute workflow, o Publish e o OUTPUT.
O gatilho manual
Caixinha 1 de 2: Gatilho manual5 minutos. O gatilho é a primeira caixinha: o que faz o fluxo começar.
Por que este passo: Todo fluxo começa por um gatilho: o acontecimento que dispara o trabalho. Este é o mais simples de todos, o seu clique; no Exercício 1 será um formulário enviado, no Exercício 2, um horário.
- Clique em Add first step. Abre a lista What triggers this workflow? (o que dispara este fluxo).
- Clique em Trigger manually (acionar manualmente), o primeiro item da lista. Se preferir buscar, digite manual.
- O nó entra na tela como When clicking 'Execute workflow'. Se abrir o painel do nó, feche no X, no canto superior direito (ou tecle Esc).
Deve aparecer: Uma caixinha na tela, com um raio: o gatilho. Sinal no chat: GATILHO.
- Abriu um painel grande com INPUT e OUTPUT? É o nó aberto. O X do canto superior direito (ou Esc) fecha.
O que acabou de acontecer: A caixinha com o raio é o gatilho. Só existe um por fluxo, e ele é sempre a primeira caixinha.
A primeira ação: escrever uma mensagem
Caixinha 2 de 2: Edit Fields: mensagem e hora7 minutos. Agora o nó que faz alguma coisa: escrever dois campos.
Por que este passo: Depois do gatilho vêm os nós, e cada um faz uma coisa. Este escreve dois campos num pacote de dados: um fixo (a mensagem) e um calculado na hora (a data). É a sua primeira expressão, as chaves duplas.
- Clique no + grudado à direita do gatilho. Abre a lista de nós.
- Na busca, digite edit e clique em Edit Fields (Set) (editar campos). Abre o painel do nó.
- Mode (modo) já vem em Manual Mapping (mapear à mão): deixe assim.
- Em Fields to Set (campos a definir), clique em Add Field (adicionar campo). Aparece uma linha com Name (nome), Type (tipo) e Value (valor).
- Em Name, cole:Name do primeiro campo · copiar
mensagem - Em Type, deixe String (texto).
- Em Value, cole:Value do campo mensagem (Fixed) · copiar
Olá, Vale Verde. Este é o meu primeiro fluxo. - Clique em Add Field de novo. Aparece a segunda linha.
- Em Name, cole:Name do segundo campo · copiar
quando - Em Type, deixe String.
- Passe o mouse sobre o campo Value desta segunda linha: no canto superior direito dele aparece Fixed | Expression (fixo | expressão). Clique em Expression.
- Em Value, cole:Value do campo quando (Expression) · copiar
{{ $now.toFormat("dd/LL/yyyy HH:mm") }} - Feche o painel no X, no canto superior direito (ou tecle Esc).
Deve aparecer: Duas caixinhas ligadas por uma seta: o gatilho e o Edit Fields. Sinal no chat: DOIS NÓS.
- A expressão ficou com as chaves aparecendo em verde e uma prévia com a data embaixo? É expressão. Se ficou preta, o campo está em Fixed: clique em Expression.
- O botão Execute workflow apareceu embaixo, no meio da tela? É ele que roda no próximo passo.
O que acabou de acontecer: A diferença entre Fixed e Expression é a diferença entre escrever um valor e pedir ao n8n que calcule um. Tudo o que muda a cada execução é expressão.
Executar e ler a saída
5 minutos. Hora de rodar e ler o resultado. Ele fica dentro do n8n: nada acontece fora dele.
Por que este passo: Executar é ver o pacote de dados andar pelas setas. Ler o OUTPUT é como se descobre o que cada caixinha fez, e é o primeiro lugar a olhar quando algo dá errado.
- Clique em Execute workflow, o botão laranja embaixo, no meio da tela.
- As duas caixinhas ganham um sinal verde, as setas mostram 1 item (um pacote de dados passou) e o painel Logs, embaixo, lista o que rodou.
- Clique duas vezes na caixinha Edit Fields. À direita, em OUTPUT (saída), a visão abre em Schema (esquema). Clique em Table (tabela): aparecem a sua mensagem e a hora de agora. O mesmo resultado aparece também no painel Logs, embaixo.
- Clique em JSON para ver o mesmo dado escrito com chaves: é a forma como o n8n guarda tudo.
- Feche o painel no X, no canto superior direito (ou tecle Esc).
Deve aparecer: Um item com dois campos: mensagem e quando, com a hora certa. Sinal no chat: RODOU.
- A hora saiu com três horas de diferença? É o fuso: a conta de teste do n8n Cloud nasce em GMT. Não precisa corrigir este fluxo; a partir do Exercício 1, todo fluxo novo recebe o fuso de São Paulo logo depois do nome.
O que acabou de acontecer: O item que você viu em Table e em JSON é o dado: um pacote com campos e valores. É ele que viaja pela seta. No Exercício 2, vinte pacotes vão passar de uma vez.
O que você deve ver
- O fluxo Olá, Vale Verde salvo (o n8n salva sozinho enquanto você edita).
- Duas caixinhas ligadas, executadas com o sinal verde.
- A saída do Edit Fields com a mensagem e a hora.
Checagem obrigatória
- O gatilho é a primeira caixinha e tem o raio.
- O campo quando está em Expression e mostra a data de hoje.
- Você abriu o OUTPUT e viu o item em Table e em JSON.
Se travarabrir
- O link do convite diz que expirou ou não abre.
- Escreva TRAVEI 0.1 no chat. O instrutor tem a lista de contas da Impacta e reenvia o convite na hora. Enquanto isso, acompanhe pela tela compartilhada.
- Pediu um código de verificação.
- Ele chega no Gmail da conta Google recebida da Impacta, na mesma aba do Chrome. Abra o Gmail em outra aba, copie o código e volte.
- Não acho o + para adicionar o nó.
- Passe o mouse sobre a borda direita do gatilho: o + aparece grudado nele. Ou use o + grande na borda direita da tela, que também abre a lista.
- A conta abriu em Overview e não acho o meu fluxo.
- Em Overview, a aba Workflows lista os fluxos: clique em Olá, Vale Verde. O fluxo também está dentro de Personal, no menu da esquerda.
- O botão Execute workflow não aparece.
- Ele só existe depois que o fluxo tem um gatilho. Faça o passo 3 e olhe embaixo, no meio da tela.
- A expressão saiu como texto, com as chaves.
- O campo está em Fixed. Passe o mouse sobre o valor e clique em Expression, à direita. Cole de novo.
Se você terminou antesabrir
Não avance para o próximo passo. Faça um destes testes na resposta que já tem:
- No OUTPUT, alterne entre Table, JSON e Schema (esquema): são três jeitos de ver o mesmo item.
- Adicione um terceiro campo chamado turma com o valor SEFA-PR e execute de novo. O item ganha um campo.
Leve para o seu trabalho
- O gatilho começa; o nó faz
- O + adiciona; o Execute workflow roda
- OUTPUT é onde se lê o resultado
- Chaves duplas: expressão
- O n8n salva sozinho
Registre o método
Complete na folha ou num bloco de notas. É o que fica quando a aula acaba.
- Os lugares da tela, com as minhas palavras:
- O que o Execute workflow fez:
- O que apareceu no OUTPUT: