# n8n: podstawowe pojęcia, węzły i automatyzacja

> Kompletny praktyczny przewodnik po n8n: od instalacji i podstawowych koncepcji (wyzwalacze, węzły, zmienne) po tworzenie autonomicznych przepływów pracy AI bez ograniczeń.

n8n to potężne narzędzie open-source, które umożliwia automatyzację rutynowych zadań i integrację aplikacji bez konieczności posiadania głębokiej wiedzy programistycznej. Wyobraź sobie: dane z Google Sheets są automatycznie wysyłane do Telegrama, a powiadomienia z Trello trafiają na e-mail – wszystko to bez zbędnego wysiłku. Rozwiązanie jest idealne zarówno dla początkujących, jak i profesjonalistów chcących zoptymalizować swoje procesy robocze.

Ten poradnik pomoże Ci opanować podstawy n8n: od instalacji po tworzenie pierwszych workflowów. Omówimy kluczowe koncepcje i kroki, abyś mógł natychmiast zacząć automatyzować swoją pracę!

## 1. Interfejs edytora n8n

### Przegląd ogólny

Edytor koncentruje się wokół canvasu (płótna) – głównej przestrzeni roboczej służącej do konstruowania łańcuchów automatyzacji. Stąd dostępny jest podgląd wszystkich workflowów, danych uwierzytelniających oraz materiałów pomocniczych.

![Przegląd interfejsu edytora workflow n8n](/api/guides-media/automation/n8n-basics/images/945a2957d9ceafa9b50e624b97ee0467b809b7cf3af2f31b6e24d2d144721935.webp)

### Lewy panel

1. Znajdź logo n8n w lewym górnym rogu.

2. Kliknij ikonę z kołem i strzałką pod logo.

3. Otworzy się menu składające się z sześciu sekcji:

● Panel administratora (Admin Panel): dla użytkowników n8n.cloud, zarządzanie ustawieniami platformy.

● Workflowy (Workflows): tworzenie, zapisywanie i edycja procesów.

● Dane uwierzytelniające (Credentials): konfiguracja autoryzacji i kluczy API dla zewnętrznych serwisów.

● Wykonania (Executions): dziennik pełnych uruchomień procesów (otwiera się w nowym oknie; przerwane uruchomienia nie są tu uwzględniane).

● Pomoc (Help): dostęp do oficjalnej dokumentacji, forum, biblioteki szablonów oraz informacji o wersji.

● Aktualizacje (Updates): informacje o bieżącej wersji i dostępnych release’ach.

W sekcji Help znajduje się również link do oficjalnej społeczności deweloperskiej na Discordzie – tam można znaleźć praktyczne odpowiedzi na pytania, których brak w podstawowej dokumentacji.

### Górny pasek

1. W lewym górnym rogu wpisz nazwę bieżącego workflowu:

```
00n8n + Personal My workflow + Add tag
Inactive Share Save
```

2. Dodaj tagi obok nazwy, aby ułatwić sortowanie według tematów lub projektów.

3. W prawym górnym rogu kliknij **Save**, aby zapisać workflow.

4. Użyj przełącznika obok, aby aktywować/dezaktywować proces (dostępne tylko przy obecności węzła triggera).

Uwaga: niezapisany workflow może zostać utracony po zamknięciu przeglądarki – zawsze ręcznie zapisuj zmiany przed zamknięciem karty.

### Canvas (Płótno)

1. Canvas to szare tło z siatką współrzędnych:

![Panel nawigacyjny i sterowanie elementami na płótnie n8n](/api/guides-media/automation/n8n-basics/images/2d1fe67e701cc13b428c977cd6eeace6e5bc264d990d25ce51f010c7986745f6.webp)

2. Znajdź pięć głównych przycisków sterujących:

● **+** oraz **-** w lupie do regulacji skali widoku.

● **←** do szybkiego resetowania skali do 100%.

● **Execute Workflow** do ręcznego uruchomienia procesu od Start lub triggerów do końcowego węzła lub błędu.

● Pomarańczowy **+** do otwarcia biblioteki dostępnych węzłów.

3. Na środku znajduje się początkowy węzeł **Start** z zieloną ikoną „Play”.

### Przesuwanie canvasu

1. Przytrzymaj `Ctrl` (lub `Cmd` na Macu) + lewy przycisk myszy i przeciągnij canvas.

2. Lub użyj dwóch palców na touchpadzie do płynnego przesuwania.

3. Canvas w pełni obsługuje sterowanie myszą: kółko myszy – zoom, prawy przycisk myszy – wywołanie szybkiego menu kontekstowego. Znacznie przyspiesza to nawigację w dużych schematach.

## 2. Architektura i typy węzłów (Nodes)

### Podstawy węzłów

1. Węzły to podstawowe bloki konstrukcyjne do przetwarzania danych (wejście, transformacja, wyjście).

2. Wyróżnia się dwa główne typy:

● **Zwykłe węzły (Regular node)**: edytują, transformują, pobierają lub wysyłają dane.

● **Węzły triggerujące (Trigger node)**: inicjują proces i dostarczają dane wejściowe na podstawie zdarzenia lub harmonogramu.

Każdy węzeł można precyzyjnie skonfigurować pod kątem zadania: ustawić parametry, zmienić pola, podłączyć zmienne środowiskowe. Po najechaniu na strzałkę wyjścia wyświetlana jest liczba elementów danych przekazanych dalej w łańcuchu.

Węzły łączą się w sekwencyjne łańcuchy – wykonanie zawsze przebiega od lewej do prawej strony.

### Węzły rdzeniowe (Core nodes)

1. Używaj ich do podstawowych operacji: planowania (**Schedule**, **Interval**) lub pisania własnego kodu (**Code**, **Function**).

Węzły Code i Function pozwalają na wykonywanie niestandardowego JavaScript lub Python, jeśli gotowe standardowe węzły są niewystarczające.

Schedule definiuje harmonogram (np. codziennie o 09:00), a Interval uruchamia proces co N minut. Te węzły stanowią fundament automatyzacji niezależnych od zewnętrznych webhooków.

### Węzeł startowy (Start node)

1. Pojawia się automatycznie w każdym nowym workflowie.

2. Nie można go usunąć ani zdublować.

3. Jeśli nie jest potrzebny, po prostu wyłącz go i przesuń na bok, usuwając linię połączenia.

4. Aby mieć kilka punktów startowych, dodaj dodatkowe węzły triggerujące lub stwórz osobny workflow.

Nawet jeśli Start nie jest używany w trybie produkcyjnym, pomaga on ręcznie testować poszczególne gałęzie łańcucha na etapie rozwoju.

### Wyszukiwanie i dodawanie węzłów

1. Otwórz panel dodawania węzłów na jeden z trzech sposobów:

● Kliknij **+** w prawym górnym rogu canvasu.

● Kliknij **+** po prawej stronie wyjścia dowolnego węzła.

● Przeciągnij linię połączenia od punktu wyjścia węzła w prawo lub naciśnij klawisz `Tab`.

2. Panel zawiera filtry według kategorii: All, Regular, Trigger.

3. Węzły są pogrupowane według dziedzin: Analytics, Communication, Development, Marketing, Sales itd.

4. Wpisz nazwę potrzebnego serwisu w polu wyszukiwania.

Jeśli nie znasz dokładnej nazwy serwisu, wprowadzaj ogólne słowa kluczowe: `email`, `webhook`, `sheets`, `telegram` – n8n automatycznie zaproponuje odpowiednie integracje.

### Dodawanie węzłów

1. Kliknij odpowiedni węzeł na liście w panelu.

2. Węzeł natychmiast pojawi się na canvasie i połączy się z wcześniej zaznaczonym blokiem.

### Przyciski na węźle

1. Najedź kursorem myszy na węzeł:

![Menu kontekstowe szybkich akcji na węźle (aktywacja, usuwanie, testowanie)](/api/guides-media/automation/n8n-basics/images/26e3b4d4948dfbe72a35ac527e7536f998d6b30be54ca0e21821a4fee0db08f7.webp)

2. Skorzystaj ze szybkich ikon:

● **Kosz**: usuń węzeł.

● **Pauza**: dezaktywuj/aktywuj węzeł bez usuwania.

● **Kopiuj**: utwórz duplikat ze wszystkimi ustawieniami.

● **Play**: wykonaj tylko ten konkretny węzeł do szybkiego testu.

Po wykonaniu węzła otwiera się zakładka **Output**, gdzie wizualnie widać strukturę zwróconych danych.

### Przesuwanie workflowu

1. Zaznacz wszystkie węzły kombinacją `Ctrl + A` (lub `Cmd + A`).

2. Przeciągnij dowolny zaznaczony węzeł w nowe miejsce na canvasie.

## 3. Praca z danymi: JSON, tablice i Binary

W tym rozdziale omówimy, jak dokładnie n8n strukturyzuje i przetwarza przepływy informacji.

### Jakie są rodzaje danych?

W n8n dane dzielą się na dwa formaty: **JSON** oraz **Binary**.

1. **JSON** – ustrukturyzowany format tekstowy, przypominający słownik. Jest używany do przekazywania parametrów między serwisami (imiona, ceny, daty, listy zamówień).

2. **Binary** – binarne dane nietekstowe: obrazy, dokumenty PDF, nagrania audio lub archiwa.

Przez zdecydowaną większość czasu w automatyzacjach będziesz pracować z JSON. Wynik jest zawsze widoczny na prawym panelu wyników dowolnego węzła w zakładce „JSON”.

### Czym jest JSON?

JSON przechowuje informacje w formacie par `«klucz: wartość»`:

● Wszystkie obiekty są ujmowane w klamry faliste `{}`.

● Klucz i wartość są oddzielone dwukropkiem `:`, a poszczególne pary – przecinkami `,`.

### Prosty przykład

```json
{
    "name": "Емма"
}
```

Tutaj `"name"` to nazwa pola (klucz), a `"Emma"` to jego wartość. Wszystkie ciągi tekstowe muszą być ujęte w cudzysłowy.

### Dodawanie szczegółów

```json
{
  "name": "Емма",
  "age": 27,
  "is_smoking": false,
  "car": {
    "model": "Chevrolet Camaro",
    "color": "бежевий"
  },
  "pets": [
    {
      "type": "собака",
      "name": "Чарлі"
    },
    {
      "type": "хом'як",
      "name": "Ніксон"
    }
  ]
}
```

● `"age": 27` – liczba, zapisywana bez cudzysłowów.

● `"is_smoking": false` – wartość logiczna (true/false), również bez cudzysłowów.

● `"car"` – zagnieżdżony obiekt JSON.

● `"pets"` – tablica (lista), która jest obramowana nawiasami kwadratowymi `[]`.

### Czym jest tablica?

Tablica to uporządkowana lista elementów. Zapisuje się ją w nawiasach kwadratowych `[]` i może zawierać teksty, liczby lub inne obiekty.

### Jak dane są przekazywane między węzłami?

n8n zawsze przekazuje dane jako **tablicę obiektów**. Na przykład:

```json
[
    {
        "name": "Емма",
        "age": 27
    },
    {
        "name": "Петро",
        "city": "Київ"
    }
]
```

Każdy element tablicy jest przetwarzany przez kolejny węzeł sekwencyjnie lub równolegle.

### Czym jest Binary?

Dane binarne są przechowywane w specjalnym obiekcie systemowym:

```json
"binaryKeyName": {
  "data": "...",
  "mimeType": "image/png",
  "fileExtension": "png",
  "fileName": "example.png"
}
```

Same bajty pliku są zakodowane w formacie Base64.

## 4. Łączenie i interakcja węzłów

### Co może robić węzeł?

Węzeł to blok funkcjonalny wykonujący konkretną operację:

● Pobranie danych z API zewnętrznego serwisu.

● Wysłanie powiadomienia na czat Telegram, Discord lub e-mail.

● Załadowanie, edycja lub zapisanie pliku.

Tak wygląda interfejs otwartego węzła:

![Okno szczegółowych parametrów i ustawień pojedynczego węzła](/api/guides-media/automation/n8n-basics/images/2b2be28c4a62a182c63844ae7fed81d3bc2a99e65d25ac54aed907c8ec9da527.webp)

Wewnątrz znajdują się zakładki: **Parameters** (ustawienia logiki), **Output** (dane wyjściowe), **Settings** (timeouty, ponowne próby przy błędach).

### Łączenie węzłów

Węzły łączy się strzałkami. To trasy, którymi poruszają się informacje:

● Strzałka może rozgałęziać się od jednego węzła do kilku (równoległe wysyłanie).

● Kilka gałęzi może zbiegać się do węzła scalającego (**Merge**).

Schemat interakcji kilku węzłów:

![Schemat interakcji węzłów w łańcuchu automatyzacji n8n](/api/guides-media/automation/n8n-basics/images/a4a27cc18966b75486e57469136f1d4ffdb47e77b246a6a26bdf1995ad1f344b.webp)

## 5. Triggery: Webhook, Schedule i zdarzenia

### Czym jest trigger?

Trigger (Wyzwalacz) to węzeł startowy, który „obudza” workflow w momencie wystąpienia określonego zdarzenia zewnętrznego.

### Główne rodzaje triggerów

1. **Webhook**: uruchamia się, gdy nadchodzi żądanie HTTP (GET, POST itp.) z zewnętrznej strony lub aplikacji.

2. **Schedule Trigger**: cykliczne uruchomienie zgodnie z harmonogramem lub wyrażeniem CRON:

![Konfiguracja węzła triggerującego Schedule Trigger dla cyklicznego uruchamiania](/api/guides-media/automation/n8n-basics/images/f498e65a269b87f0ac7c2dd49d2649d44c85a92f806fb9e58b4454d2e6858833.webp)

3. **App Triggers**: monitorowanie zdarzeń w konkretnych serwisach (nowy wiersz w Google Sheets, nowy lead w CRM lub reakcja na wiadomość w Telegramie).

## 6. Tryby pracy: Test vs Production

W n8n przewidziano dwa fundamentalne tryby:

1. **Tryb testowy (Test)** – interaktywne debugowanie z wizualizacją każdego kroku.

2. **Tryb produkcyjny (Production)** – autonomiczna, całodobowa praca w tle.

## 7. Krok po kroku: Konfiguracja i testowanie Webhook

1. Dodaj na canvas węzeł **Webhook**.

![Przegląd interfejsu edytora workflow n8n](/api/guides-media/automation/n8n-basics/images/945a2957d9ceafa9b50e624b97ee0467b809b7cf3af2f31b6e24d2d144721935.webp)

2. Dodaj węzeł **Edit Fields (Set)** do modyfikacji danych:

![Wybór i dodanie węzła Edit Fields (Set) do transformacji danych](/api/guides-media/automation/n8n-basics/images/2bda08fce1411acf15aae4e73e3afef4a3826381e86feb6d80206ba0267b6bc9.webp)

3. Skonfiguruj pole `success` z wartością `true`:

![Konfiguracja pól wejściowych i przypisywanie wartości w węźle Set](/api/guides-media/automation/n8n-basics/images/861631d521613a4684ff9841ae60e409b4ba6ec6f686763abfeff957b95097e4.webp)

4. Kliknij **Test step / Listen for test event**:

![Testowe uruchomienie węzła Webhook i generowanie URL do odbioru danych wejściowych](/api/guides-media/automation/n8n-basics/images/96467279ae2b961ef1398cf07def9245f5fad26722d6fc8f51354c6c2d08deef.webp)

5. Skopiuj wygenerowany **Test URL**:

![Kopiowanie testowego URL webhooka do wysłania żądania przez przeglądarkę lub curl](/api/guides-media/automation/n8n-basics/images/46a18e8ca341a5ba5f5d09bfdabdd828291abb120f2986a78ec379e4efde26ad.webp)

6. Wyślij żądanie przez przeglądarkę, Postman lub cURL. W odpowiedzi n8n zwróci wygenerowany JSON:

![Wyświetlenie udanej odpowiedzi JSON n8n w oknie przeglądarki](/api/guides-media/automation/n8n-basics/images/8cdcd70d7e337cfa1e48698c298e7807d3022e6777d7a3d6aeb698ef66e898de.webp)

7. Zmień parametry i uruchom test ponownie, upewniając się, że transformacja działa poprawnie:

![Ponowny test ze zmienionymi wartościami parametrów i walidacja zaktualizowanych danych](/api/guides-media/automation/n8n-basics/images/4c2be16352c2179afa475af6ee5b08420c03ca0755bc7c4ade41b6d5858d8962.webp)

## 8. Przejście w tryb produkcyjny (Production)

Gdy workflow zostanie przetestowany:

1. Otwórz węzeł Webhook i skopiuj **Production URL**:

![Pozyskanie działającego Production URL do produkcyjnego uruchomienia webhooka w n8n](/api/guides-media/automation/n8n-basics/images/4b429613856c10cd6548da729388b9715e6393c267f22db2055da47ee148bc21.webp)

2. Przełącz suwak w górnym pasku w pozycję **Active**:

![Aktywacja workflow za pomocą przełącznika w górnym panelu sterowania n8n](/api/guides-media/automation/n8n-basics/images/197596a4c909ccae9482a36bfa6e9ac719bae2099230ee7545e27e0d347167da.webp)

3. Teraz n8n będzie obsługiwać wszystkie rzeczywiste przychodzące wywołania w tle, a historię wykonania można przeglądać w sekcji **Executions**.

## 9. Podsumowanie i praktyczne wskazówki

Opanowałeś podstawowe koncepcje n8n: architekturę canvasu, typy węzłów, przesyłanie struktur JSON, trigery oraz przełączanie między środowiskiem testowym a produkcyjnym. To solidny fundament do budowania złożonych agentów AI i automatyzacji dowolnych procesów biznesowych!