n8n integracija

Samostalno hostirana automatizacija tijekova rada s potpunom kontrolom nad vašim podacima.

Pregled

n8n je open-source, samostalno hostabilan alat za automatizaciju. Zadržite podatke o fotografijama na svojoj infrastrukturi dok automatizirate tijekove rada s 200+ integracija.

Preduvjeti

Visiono račun s pristupom API-ju
n8n instanca (samostalno hostirana ili u oblaku)
API ključ iz Visiona

Zašto n8n?

Značajka	Prednost
Samostalno hostirano	Potpuna kontrola nad podacima
Open source	Pregledajte i modificirajte kod
Bez ograničenja izvršavanja	Neograničeni tijekovi rada
Prilagođeni čvorovi	Izgradite integracije
Fair-code licenca	Besplatno za većinu korištenja

Koraci postavljanja

1. Kreirajte Webhook čvor

Otvorite n8n editor tijekova rada
Dodajte Webhook čvor
Postavite metodu: POST
Kopirajte webhook URL (Produkcijski ili Testni)

2. Konfigurirajte u Visionu

Idite na Postavke radnog prostora → Webhooks
Kliknite Dodaj webhook
Zalijepite n8n webhook URL
Odaberite događaje za okidanje
Spremite konfiguraciju

3. Testirajte vezu

U n8n-u, kliknite Listen for Test Event
Pošaljite testnu fotografiju u Visionu
n8n prikazuje primljene podatke
Kliknite Stop Listening

4. Izgradite svoj tijek rada

Dodajte čvorove za obradu podataka:

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

Primjeri tijekova rada

Tijek rada za sigurnosnu kopiju fotografija

Spremite fotografije na lokalnu pohranu ili S3:

json

{
  "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": "=&#123;&#123;$json.url&#125;&#125;",
        "responseFormat": "file"
      }
    },
    {
      "name": "Save to S3",
      "type": "n8n-nodes-base.awsS3",
      "parameters": {
        "operation": "upload",
        "bucketName": "visiono-backups",
        "fileName": "=&#123;&#123;$json.slot_name&#125;&#125;.jpg"
      }
    }
  ]
}

Tijek rada za obavijesti

Obavijestite tim o novim slanjima:

Čvorovi:

Webhook - Primi Visiono događaj
Set - Formatiraj podatke poruke
Slack - Pošalji na kanal
Email - Pošalji sažetak

Zapisivanje u bazu podataka

Zabilježite slanja u PostgreSQL:

Čvorovi:

Webhook - Primi događaj
Postgres - Umetni zapis
IF - Provjeri broj fotografija
HTTP Request - Pozovi vanjski API

Konfiguracija čvorova

Webhook čvor

yaml

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

HTTP Request čvor

Za preuzimanje fotografija:

yaml

Method: GET
URL: =&#123;&#123; $json.data.photos[0].url &#125;&#125;
Response Format: File

IF čvor

Uvjetno usmjeravanje:

yaml

Condition: Number
Value 1: =&#123;&#123; $json.data.photos.length &#125;&#125;
Operation: Larger
Value 2: 5

Referenca podataka

Pristupite webhook podacima u izrazima:

Izraz	Podaci
`{{ $json.event }}`	Vrsta događaja
`{{ $json.data.smart_link.name }}`	Naziv Trajnog linka
`{{ $json.data.photos[0].url }}`	URL prve fotografije
`{{ $json.data.photos.length }}`	Broj fotografija
`{{ $json.data.metadata.full_name }}`	Ime pošiljatelja
`{{ $json.data.metadata.unique_field }}`	Identifikator

Petlje i iteracija

Obradi sve fotografije

Koristite Split In Batches čvor:

Dodajte nakon Webhooka
Postavite stavke: {{ $json.data.photos }}
Veličina serije: 1
Povežite čvorove za obradu
Dodajte Merge na kraju

Agregiraj rezultate

Prikupite obrađene podatke:

Code čvor za agregaciju
Pohranite u statične podatke tijeka rada
Izlaz kombiniranih rezultata

Rukovanje greškama

Ponovni pokušaj pri neuspjehu

Konfigurirajte po čvoru:

Continue on Fail: Obradi sljedeću stavku
Retry on Fail: Pokušaj ponovno
Max Retries: 3

Error Trigger

Hvatajte i rukujte greškama:

Dodajte Error Trigger čvor
Povežite s čvorom za obavijesti
Zabilježite ili upozorite na neuspjehe

Savjeti za samostalno hostiranje

Docker deployment

yaml

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=sigurna-lozinka
      - WEBHOOK_URL=https://n8n.vasadomena.com/
    volumes:
      - n8n_data:/home/node/.n8n

Webhook URL

Za produkcijske webhookove:

Koristite produkcijski URL (ne testni)
Konfigurirajte WEBHOOK_URL varijablu okruženja
Koristite HTTPS s valjanim certifikatom

Sigurnost

Omogućite autentifikaciju
Koristite HTTPS
Ograničite mrežni pristup
Redovite sigurnosne kopije

Napredne značajke

Prilagođeni kod

Koristite Code čvor za JavaScript:

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 } }];

Vjerodajnice

Sigurno pohranite API ključeve:

Idite na Credentials
Dodajte novu vjerodajnicu
Referencirajte u čvorovima

Pod-tijekovi rada

Modularizirajte tijekove rada:

Kreirajte višekratni tijek rada
Pozovite putem Execute Workflow čvora
Proslijedite podatke između tijekova rada

Rješavanje problema

Webhook ne prima

Provjerite da n8n radi
Provjerite da URL uključuje port ako je potrebno
Provjerite da vatrozid dopušta promet
Testirajte s curl-om

Greške izraza

Provjerite strukturu podataka
Provjerite putanje svojstava
Koristite opcionalno ulančavanje: $json.data?.photos

Problemi s izvršavanjem

Provjerite zapisnik izvršavanja
Pregledajte izlaze čvorova
Testirajte pojedinačne čvorove
Provjerite vjerodajnice

Optimizacija performansi

Skupna obrada

Grupirajte slične operacije
Koristite bulk API pozive
Ograničite istovremena izvršavanja

Upravljanje resursima

Pratite korištenje memorije
Ograničite izvršavanja tijeka rada
Arhivirajte stare podatke

Povezani resursi

Webhooks - Konfiguracija događaja
API referenca - Direktan pristup API-ju
Zapier integracija - Alternativa u oblaku
Make integracija - Vizualni alat

n8n integracija ​

Pregled ​

Preduvjeti ​

Zašto n8n? ​

Koraci postavljanja ​

1. Kreirajte Webhook čvor ​

2. Konfigurirajte u Visionu ​

3. Testirajte vezu ​

4. Izgradite svoj tijek rada ​

Primjeri tijekova rada ​

Tijek rada za sigurnosnu kopiju fotografija ​

Tijek rada za obavijesti ​

Zapisivanje u bazu podataka ​

Konfiguracija čvorova ​

Webhook čvor ​

HTTP Request čvor ​

IF čvor ​

Referenca podataka ​

Petlje i iteracija ​

Obradi sve fotografije ​

Agregiraj rezultate ​

Rukovanje greškama ​

Ponovni pokušaj pri neuspjehu ​

Error Trigger ​

Savjeti za samostalno hostiranje ​

Docker deployment ​

Webhook URL ​

Sigurnost ​

Napredne značajke ​

Prilagođeni kod ​

Vjerodajnice ​

Pod-tijekovi rada ​

Rješavanje problema ​

Webhook ne prima ​

Greške izraza ​

Problemi s izvršavanjem ​

Optimizacija performansi ​

Skupna obrada ​

Upravljanje resursima ​

Povezani resursi ​

n8n integracija

Pregled

Preduvjeti

Zašto n8n?

Koraci postavljanja

1. Kreirajte Webhook čvor

2. Konfigurirajte u Visionu

3. Testirajte vezu

4. Izgradite svoj tijek rada

Primjeri tijekova rada

Tijek rada za sigurnosnu kopiju fotografija

Tijek rada za obavijesti

Zapisivanje u bazu podataka

Konfiguracija čvorova

Webhook čvor

HTTP Request čvor

IF čvor

Referenca podataka

Petlje i iteracija

Obradi sve fotografije

Agregiraj rezultate

Rukovanje greškama

Ponovni pokušaj pri neuspjehu

Error Trigger

Savjeti za samostalno hostiranje

Docker deployment

Webhook URL

Sigurnost

Napredne značajke

Prilagođeni kod

Vjerodajnice

Pod-tijekovi rada

Rješavanje problema

Webhook ne prima

Greške izraza

Problemi s izvršavanjem

Optimizacija performansi

Skupna obrada

Upravljanje resursima

Povezani resursi