Salta el contingut

Bones pràctiques en n8n

Adoptar bones pràctiques des del primer dia t'estalviarà molts problemes quan els teus workflows siguin més complexos. Aquestes pràctiques proven que un professional ha pensat el flux, no només que funciona.

1. Pensa abans de construir

La regla més important: defineix el que i el per què abans de connectar nodes.

Abans d'obrir n8n, respon aquestes preguntes:

  • Quin és el procés que vull automatitzar?
  • Quin és l'event que dispara el procés?
  • Quines dades necessito en cada pas?
  • Quines accions vull que es produeixin?
  • Com sabrà el sistema si alguna cosa ha anat malament?
flowchart TD
    A[Definir el proces] --> B[Identificar les dades necessaries]
    B --> C[Mapejar els passos]
    C --> D[Identificar possibles errors]
    D --> E[Construir el workflow]

Usa llapis i paper

Dibuixa el workflow a ma abans de crear-lo a n8n. Es més ràpid i t'ajuda a veure el flux global.

2. Noms clars als nodes

Per defecte, n8n posa noms genèricament als nodes ("Gmail", "IF", "HTTP Request"). Canvia'ls sempre per noms descriptius que expliquin què fa cada pas.

Nom genèric Nom descriptiu
Gmail Enviar correu de benvinguda
IF Comprovar si es client premium
HTTP Request Consultar API meteorològica
Set Preparar dades per a la BD
Code Calcular descompte per volum

Nodes innominats

Un workflow amb nodes "Gmail 1", "Gmail 2", "Gmail 3" és impossible de mantenir quan torna a ell al cap d'un mes.

3. Duplicar abans de modificar

Quan un workflow està en producció i funciona correctament, mai el modifiquis directament.

El procediment correcte es:

  1. Duplica el workflow (boto dret → Duplicar)
  2. Reanomena la còpia amb el sufix "(dev)" o la data
  3. Fes les modificacions a la còpia
  4. Prova exhaustivament la nova versió
  5. Desactiva l'antiga i activa la nova

Risc de producció

Modificar un workflow actiu sense una còpia pot travar processos en curs i causar perdua de dades o processos a mig fer.

4. Validar les dades

Sempre que un workflow rep dades externes (d'un formulari, d'una API, d'un webhook), vàlida que les dades existeixen i tenen el format esperat.

// Assumim que "email" existeix i es valid
const email = $input.item.json.email;
// Si "email" no existeix, el workflow peta

const email = $input.item.json.email;
if (!email || !email.includes('@')) {
  throw new Error('Email invalid o absent: ' + email);
}
// Continuem amb l'email validat

Usa nodes IF per comprovar que les dades critiques estan presents abans de continuar el flux.

5. Gestió d'errors

n8n permet configurar que passa quan un node falla:

  • Atura el workflow: per defecte, qualsevol error atura tot el flux
  • Continua amb l'error: el workflow continua però marca l'item com a error
  • Node d'error: defineix un camí alternatiu per als errors
flowchart LR
    A[HTTP Request] -->|Exit| B[Processar dades]
    A -->|Error| C[Slack: Notificar error]
    C --> D[Log: Guardar error a BD]

Sempre gestiona els errors

Un workflow sense gestió d'errors només és vàlid per a proves. En producció, sempre afegeix un camí d'error que notifiqui i registri el problema.

6. Usa variables d'entorn per a credencials

Mai escriguis credencials, URLs o claus API directament als nodes. Usa les variables d'entorn de n8n o el gestor de credencials integrat.

Correcte Incorrecte
{{ $env.API_KEY }} abc123secret (directament al camp)
Credencial guardada a n8n Password en el camp "Password" del node

7. Documenta els workflows complexos

Per a workflows amb més de 10 nodes o lògica complexa:

  • Afegeix un node Note (memo adhesiu) explicant el propòsit del workflow
  • Agrupa nodes relacionats amb Subworkflows
  • Afegeix descripcións als nodes que no son evidents

8. Prova amb dades reals (però de prova)

Quan proves un workflow:

  • Usa dades reals sempre que sigui possible (captures de producció anonimitzades)
  • Però mai proves amb el sistema de producció real (BD de producció, API de pagament real...)
  • Usa entorns separats: test vs producció

Resum

flowchart TD
    A[Bones practiques] --> B[Pensa primer]
    A --> C[Noms clars]
    A --> D[Duplica abans de modificar]
    A --> E[Valida les dades]
    A --> F[Gestiona els errors]
    A --> G[Credencials segures]
    A --> H[Documenta]
    A --> I[Prova be]

Miniactivitat ACN8N4

Revisar el següent workflow amb problemes:

  • Node 1: "Gmail" (llegeix correus)
  • Node 2: "IF" (comprova alguna cosa)
  • Node 3: "Gmail 1" (fa alguna acció)
  • Node 4: "Code" (processa dades)

Quines bones pràctiques no s'estan seguint? Com el milloraries?