n8n integracija

Samogostena avtomatizacija delovnih tokov s polnim nadzorom nad vašimi podatki.

Pregled

n8n je odprtokodno, samogostljivo orodje za avtomatizacijo. Ohranite foto podatke na svoji infrastrukturi, medtem ko avtomatizirate delovne tokove s 200+ integracijami.

Predpogoji

• Visiono račun z dostopom do API
• n8n instanca (samogostena ali v oblaku)
• API ključ iz Visiono

Zakaj n8n?

Funkcija	Prednost
Samogosteno	Poln nadzor nad podatki
Odprtokodno	Preglejte in spremenite kodo
Brez omejitev izvajanja	Neomejeni delovni tokovi
Prilagojeni vozlišči	Gradite integracije
Fair-code licenca	Brezplačno za večino uporab

Koraki nastavitve

1. Ustvarite vozlišče Webhook

1. Odprite n8n urejevalnik delovnih tokov
2. Dodajte vozlišče Webhook
3. Nastavite metodo: POST
4. Kopirajte webhook URL (Production ali Test)

2. Konfigurirajte v Visiono

1. Pojdite na Nastavitve delovnega prostora → Webhooks
2. Kliknite Dodaj webhook
3. Prilepite n8n webhook URL
4. Izberite dogodke za sprožitev
5. Shranite konfiguracijo

3. Preizkusite povezavo

1. V n8n kliknite Listen for Test Event
2. Oddajte testno fotografijo v Visiono
3. n8n prikaže prejete podatke
4. Kliknite Stop Listening

4. Zgradite svoj delovni tok

Dodajte vozlišča za obdelavo podatkov:

[Webhook] → [IF] → [HTTP Request] → [Email]
                 ↘ [Slack]

Primeri delovnih tokov

Delovni tok varnostne kopije fotografij

Shranite fotografije na lokalno shrambo ali S3:

{
  "nodes": [
    {
      "name": "Webhook",
      "type": "n8n-nodes-base.webhook",
      "parameters": {
        "path": "visiono-photos",
        "httpMethod": "POST"
      }
    },
    {
      "name": "Loop Photos",
      "type": "n8n-nodes-base.splitInBatches",
      "parameters": {
        "batchSize": 1
      }
    },
    {
      "name": "Download Photo",
      "type": "n8n-nodes-base.httpRequest",
      "parameters": {
        "url": "={{$json.url}}",
        "responseFormat": "file"
      }
    },
    {
      "name": "Save to S3",
      "type": "n8n-nodes-base.awsS3",
      "parameters": {
        "operation": "upload",
        "bucketName": "visiono-backups",
        "fileName": "={{$json.slot_name}}.jpg"
      }
    }
  ]
}

Delovni tok obvestil

Opozorite ekipo o novih oddajah:

Vozlišča:

1. Webhook - Prejmi Visiono dogodek
2. Set - Formatiraj podatke sporočila
3. Slack - Pošlji v kanal
4. Email - Pošlji povzetek

Beleženje v bazo podatkov

Zabeležite oddaje v PostgreSQL:

Vozlišča:

1. Webhook - Prejmi dogodek
2. Postgres - Vstavi zapis
3. IF - Preveri število fotografij
4. HTTP Request - Kliči zunanji API

Konfiguracija vozlišč

Vozlišče Webhook

HTTP Method: POST
Path: visiono-webhook
Response Mode: On Received
Response Data: Success

Vozlišče HTTP Request

Za prenos fotografij:

Method: GET
URL: ={{ $json.data.photos[0].url }}
Response Format: File

Vozlišče IF

Pogojno usmerjanje:

Condition: Number
Value 1: ={{ $json.data.photos.length }}
Operation: Larger
Value 2: 5

Referenca podatkov

Dostopajte do webhook podatkov v izrazih:

Izraz	Podatek
{{ $json.event }}	Vrsta dogodka
{{ $json.data.smart_link.name }}	Ime trajne povezave
{{ $json.data.photos[0].url }}	URL prve fotografije
{{ $json.data.photos.length }}	Število fotografij
{{ $json.data.metadata.full_name }}	Ime oddajnika
{{ $json.data.metadata.unique_field }}	Identifikator

Zanke in iteracija

Obdelajte vse fotografije

Uporabite vozlišče Split In Batches:

1. Dodajte za Webhook
2. Nastavite elemente: {{ $json.data.photos }}
3. Velikost paketa: 1
4. Povežite vozlišča za obdelavo
5. Dodajte Merge na koncu

Agregirajte rezultate

Zberite obdelane podatke:

1. Vozlišče Code za agregacijo
2. Shranite v statične podatke delovnega toka
3. Izpišite združene rezultate

Obravnava napak

Ponovitev ob neuspehu

Konfigurirajte za vsako vozlišče:

• Continue on Fail: Obdelajte naslednji element
• Retry on Fail: Poskusite znova
• Max Retries: 3

Sprožilec napak

Ujemite in obravnavajte napake:

1. Dodajte vozlišče Error Trigger
2. Povežite z vozliščem obvestil
3. Beležite ali opozorite ob neuspehih

Nasveti za samogostenje

Docker uvajanje

version: "3"
services:
  n8n:
    image: n8nio/n8n
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=varno-geslo
      - WEBHOOK_URL=https://n8n.vasadomena.com/
    volumes:
      - n8n_data:/home/node/.n8n

Webhook URL

Za produkcijske webhooks:

• Uporabite produkcijski URL (ne testnega)
• Konfigurirajte spremenljivko okolja WEBHOOK_URL
• Uporabite HTTPS z veljavnim certifikatom

Varnost

• Omogočite avtentikacijo
• Uporabite HTTPS
• Omejite omrežni dostop
• Redne varnostne kopije

Napredne funkcije

Prilagojena koda

Uporabite vozlišče Code za JavaScript:

const photos = items[0].json.data.photos;
const processed = photos.map(photo => ({
  url: photo.url,
  name: photo.slot_name,
  downloaded: new Date().toISOString()
}));
return [{ json: { photos: processed } }];

Poverilnice

Varno shranite API ključe:

1. Pojdite na Credentials
2. Dodajte novo poverilnico
3. Referencirajte v vozliščih

Pod-delovni tokovi

Modularizirajte delovne tokove:

1. Ustvarite ponovno uporaben delovni tok
2. Kličite prek vozlišča Execute Workflow
3. Prenašajte podatke med delovnimi tokovi

Odpravljanje težav

Webhook ne prejema

1. Preverite, ali n8n teče
2. Preverite, ali URL vključuje port, če je potrebno
3. Preverite, ali požarni zid dovoljuje promet
4. Preizkusite s curl

Napake izrazov

1. Preverite strukturo podatkov
2. Preverite poti lastnosti
3. Uporabite neobvezno veriženje: $json.data?.photos

Težave z izvajanjem

1. Preverite dnevnik izvajanja
2. Preglejte izpise vozlišč
3. Preizkusite posamezna vozlišča
4. Preverite poverilnice

Optimizacija zmogljivosti

Paketna obdelava

• Združite podobne operacije
• Uporabite množične API klice
• Omejite sočasna izvajanja

Upravljanje virov

• Spremljajte uporabo pomnilnika
• Omejite izvajanja delovnih tokov
• Arhivirajte stare podatke

Povezani viri

• Webhooks - Konfiguracija dogodkov
• API referenca - Neposreden dostop do API
• Zapier integracija - Alternativa v oblaku
• Make integracija - Vizualni graditelj