Já abordámos anteriormente o n8n em termos gerais — o que é o n8n, em que difere dos seus concorrentes e o que oferece quando combinado com a RO App. Este artigo centra-se na vertente prática: vamos percorrer todo o processo passo a passo, desde o registo até à execução do seu primeiro cenário.
Como implementar o n8n
Existem duas formas:
n8n baseado na nuvem (n8n.cloud) — a forma mais rápida de começar, não requer administração e é adequada para a maioria das empresas.
Auto-hospedado — a plataforma é implementada no seu próprio servidor ou mesmo num computador local. Proporciona-lhe controlo total sobre os seus dados, mas requer alguns conhecimentos técnicos por parte da sua equipa para a configuração e manutenção.
Passo 1. Registo no n8n
Aceda a n8n.io e clique em “Get started” / “Sign up.”
Introduza o seu endereço de e-mail, palavra-passe (pelo menos 8 caracteres, incluindo um número e uma letra maiúscula) e clique em “Next”.
Defina o nome da sua conta — este será o endereço de subdomínio exclusivo do seu espaço de trabalho (por exemplo, mycompany.app.n8n.cloud).
Verifique o seu e-mail clicando na ligação contida no e-mail de confirmação.
O sistema irá iniciar sessão automaticamente — será redirecionado diretamente para o painel, onde poderá criar o seu primeiro fluxo de trabalho.
Passo 2. Instalação do módulo comunitário RO App
Para instalar o módulo com os nós do RO App, tem de começar a criar o seu fluxo de trabalho.
1. Aceda ao Dashboard e clique em Create workflow.
2. Clique em Add step e selecione On app event.
3. Introduza «roapp» na barra de pesquisa e abra a aplicação que aparecer.
4. Clique em Install node.
5. Pronto! O módulo RO App está instalado e já pode escolher entre as ações disponíveis para criar o fluxo de trabalho de que necessita.
Também pode ligar o módulo diretamente a partir da página «Nós da Comunidade», sem o associar a um cenário específico:
Aceda a Settings → Community Nodes.
Clique em Install.
Introduza o nome do pacote — roapp (ou o nome completo do módulo no npm).
Aceite os termos de instalação e clique em Install.
Assim que estiver concluída, o módulo RO App aparecerá na lista de módulos instalados e estará disponível para seleção em qualquer cenário.
Passo 3. Ligar a sua conta RO App aos Nós
Antes de utilizar um nó (nodes) RO App num cenário, deve ligá-lo à sua conta uma vez — utilizando credenciais. É isto que identifica a sua conta e permite que o nó execute ações especificamente em seu nome, em vez de o fazer de forma abstrata. No caso do RO App, a chave API da sua conta serve como credencial.
Para o fazer:
1. Ao configurar o passo com o módulo RO App, clique em Set up credentials.
2. No RO App, aceda a Settings > API e copie a chave API.
3. No n8n, introduza a chave copiada no campo Access Token e guarde as configurações.
Depois disso, este nó e todos os outros nós do RO App que utilizará em cenários futuros ficarão associados à sua conta. O mesmo se aplica aos nós de quaisquer outros serviços: ao utilizá-los pela primeira vez, deve associá-los à conta adequada antes de os utilizar num cenário. Isto é importante para garantir que a ação no cenário seja executada especificamente pelo colaborador pretendido e a partir da conta pretendida, em vez de, de forma abstrata, «por alguém».
Pode visualizar todas as credenciais ligadas na página Personal → Credentials. Aí, também pode ligar novas credenciais ou adicionar vários pacotes para o mesmo módulo — por exemplo, se alguns cenários precisarem de ser executados em nome de diferentes colaboradores ou de diferentes contas.
Como trabalhar com cenários no n8n
Independentemente do processo que estiver a automatizar, todos os fluxos de trabalho no n8n seguem a mesma lógica.
Onde fazer isto: Todos os fluxos de trabalho são configurados no separador Workflows — aí pode criar um novo («+ Add workflow) ou abrir um já existente para edição.
Selecione um gatilho — o evento que inicia o fluxo de trabalho: um novo evento na RO App (por exemplo, um novo agendamento), uma nova resposta num Formulário do Google, um webhook, um gatilho agendado ou um início manual.
Ligue as suas credenciais aos nodos relevantes — caso ainda não o tenha feito. Isto é feito uma única vez para cada conta.
Adicione nodos de ação — passo a passo, descreva o que deve acontecer após o gatilho: verificar algo, criar um agendamento, enviar uma mensagem, etc. Cada novo nodo é adicionado clicando no botão «+» após o anterior.
Transfira os dados necessários entre os nodos — nos campos de cada nodo, pode preencher valores das etapas anteriores (nome, e-mail, ID, etc.) clicando no campo e selecionando os dados pretendidos da lista.
Adicione condições conforme necessário — o nodo IF permite dividir o fluxo de trabalho em ramificações (por exemplo, «se o cliente já existir» / «se o cliente não existir»).
Teste o fluxo de trabalho — o botão Testar fluxo de trabalho executa o fluxo de trabalho e mostra quais os dados que passaram por cada nodo, o que é útil para verificar se existem erros.
Ative o fluxo de trabalho — utilize o botão de alternância Ativo na parte superior do ecrã. Só então o fluxo de trabalho começará a ser executado automaticamente, sem necessidade de ser acionado manualmente.
Estes sete passos repetem-se em qualquer fluxo de trabalho — a única diferença reside nos gatilhos e nós específicos que escolher para uma tarefa concreta.
como se registar no N8N, registo no N8N, instalação do N8N, nós, como configurar um nó da comunidade, credenciais do N8N, como criar um script, como criar um fluxo de trabalho, N8N para principiantes, N8N auto-hospedado, N8N Cloud, gatilho do N8N, como criar automações, configuração da chave API, guia do N8N, instruções passo a passo do N8N, ativação de scripts