Conceptes bàsics de n8n

Abans de crear el primer workflow necessitem entendre tres conceptes fonamentals: el workflow, els nodes i els items. Aquests tres elements defineixen com pensa i funciona n8n.

Workflow

Un workflow és una seqüència completa d'accions que s'executen de manera ordenada per assolir un objectiu.

• Te un inici (un node trigger que dispara l'execució)
• Un recorregut definit (la cadena de nodes connectats)
• Un resultat final (l'acció que volem aconseguir)

L'ordre de cada pas es fonamental: condiciona directament el comportament i el resultat del procés.

flowchart LR
    T([Trigger]) --> N1[Node 1] --> N2[Node 2] --> N3[Node 3] --> R([Resultat])

Analogia

Imagina una recepta de cuina: ingredicients (dades d'entrada), passos ordenats (nodes), i el plat final (resultat). Si canvies l'ordre dels passos, el resultat canvia o el plat no surt be.

Nodes

Un node és una peça funcional d'un workflow que executa una acció concreta dins del procés.

Cada node:

• Rep dades d'entrada del node anterior
• Processa o transforma les dades
• Envia les dades resultants al node següent

Tipus de nodes

n8n classifica els nodes en quatre categories principals:

flowchart TD
    A[Tipus de nodes] --> B[TRIGGER]
    A --> C[LOGIC]
    A --> D[ACTION]
    A --> E[FUNCTION]

    B --> B1["Punt d'entrada del workflow\nDispara l'execucio"]
    C --> C1["Defineix el cami\nsegun condicions o regles"]
    D --> D1["Realitza una accio\nsobre un servei o sistema"]
    E --> E1["Transforma i prepara\nles dades amb logica propia"]

TRIGGER (Disparador)

El node trigger és el punt d'entrada del workflow. Sense un trigger, el workflow no s'executa.

Exemples de triggers: - Manual Trigger: s'executa quan prems el botó "Executa" - Schedule Trigger: s'executa cada hora, cada dia, cada setmana... - Webhook: s'executa quan arriba una petició HTTP externa - Gmail Trigger: s'executa quan arriba un correu nou

LOGIC (Lògica)

Nodes que defineixen el camí que seguiran les dades segons condicions.

Exemples de nodes de lògica: - IF: bifurcació binaria (true/false) - Switch: bifurcació multiple (cas 1, cas 2, cas 3...) - Merge: combina dades de branques diferents - Loop Over Items: itera sobre una llista d'elements

ACTION (Acció)

Nodes que fan alguna cosa sobre un servei extern.

Exemples de nodes d'acció: - Gmail: envia o llegeix correus - Google Sheets: llegeix o escriu a un full de calcul - Slack: envia missatges a un canal - HTTP Request: fa una petició a una API REST

FUNCTION (Funcio)

Nodes que transformen i preparen les dades amb lògica programatica.

Exemples: - Code: executa codi JavaScript per transformar dades - Set: defineix o modifica camps de les dades - Edit Fields: canvia l'estructura dels items

Exemple de workflow complet

flowchart LR
    T([Schedule\nTrigger]) -->|cada dilluns| S[Gmail\nLlegir]
    S --> I{IF: te\nadjunts?}
    I -->|Si| D[Google Drive\nGuardar]
    I -->|No| E[Slack\nNotificar]
    D --> E

Miniactivitat ACN8N2

Identifica quin tipus de node seria cadascun en aquest cas d'ús: "Cada vegada que algú omple un formulari de contacte, comprovem si el seu correu és vàlid i, si ho es, l'afegim a una llista de Mailchimp i enviem un SMS de benvinguda."

Items

Un item és una unitat de dades que es mou d'un node a un altre dins del workflow.

Tecnicamente, un item en n8n és un objecte JSON:

{
  "json": {
    "nom": "Anna Garcia",
    "email": "anna@example.com",
    "data": "2025-01-15"
  }
}

Un sol item vs col·leccions

Un workflow pot treballar amb:

• Un sol item: per exemple, les dades d'un formulari concret
• Col·leccions (llista d'items): per exemple, totes les files d'un full de calcul

flowchart LR
    A([Trigger]) -->|1 item| B[Node A] -->|1 item| C[Node B]
    D([Trigger]) -->|"[item1, item2, item3]"| E[Node A] -->|"[item1, item2, item3]"| F[Node B]

Important

El nombre d'items que surt d'un node determina quantes vegades s'executarà el següent node. Si el node anterior retorna 10 items, el següent s'executarà 10 vegades (una per cada item).

Com n8n processa els items

Quan un node rep una llista d'items, per defecte els processa tots de manera automàtica, un per un. Això significa que no necessites fer bucles manualment per a la majoria d'operacións.

flowchart TD
    A["Sheet Node\nRetorna 5 files"] --> B["Gmail Node\nEnvia 5 correus automaticament"]
    B --> C["Resultat: 5 items processats"]

Estructura interna d'un item

Un item de n8n sempre te aquesta estructura:

{
  "json": {
    // les teves dades principals
  },
  "binary": {
    // fitxers adjunts (opcional)
  },
  "pairedItem": {
    // referencia al item d'entrada (per a nodes que generen nous items)
  }
}

A la pràctica, treballaràs principalment amb la part json.

relació entre Workflow, Nodes i Items

La manera més clara d'entendre la relació entre els tres conceptes:

Concepte	Analogia	Paper en n8n
Workflow	El camí	Defineix el recorregut complet del procés, de l'inici al resultat
Nodes	Els passos	Cada node és un pas concret del camí, on es fa una acció o es pren una decisio
Items	Les dades	Les dades avancen pel camí passant per cada pas

flowchart LR
    subgraph WORKFLOW ["WORKFLOW (el cami)"]
        direction LR
        N1["NODE 1\n(Trigger)"] -->|"Items →"| N2["NODE 2\n(Logic)"] -->|"Items →"| N3["NODE 3\n(Action)"]
    end

La clau per entendre n8n

Sempre que tinguis un dubte sobre com funciona un workflow, pregunta't: quines dades entren? Quantes? Que fa el node amb elles? Quantes dades surten?