n8n od zera: automatyzacja bez kodu krok po kroku

• Zacznij od procesu, który potrafisz opisać jednym zdaniem.
• Najpierw przetestuj dane i warunek, później podłącz zewnętrzną aplikację.
• Użyj osobnego arkusza testowego i fikcyjnych zgłoszeń.
• Przed automatycznym uruchamianiem sprawdź obie ścieżki oraz skutki ponowienia.
• Zachowaj kopię workflow i ustal, kto będzie reagować na błędy.

Przykład w poradniku ma wyłapać zgłoszenia z kategorią „pomoc”. Zanim zaczniesz, zapisz oczekiwany wynik: takie zgłoszenie trafia do wybranej ścieżki, a inna kategoria do drugiej.

Wyzwalacz, po angielsku trigger, rozpoczyna workflow. Węzeł, czyli node, jest pojedynczym blokiem na planszy edytora, nazywanej canvas. Węzły łączysz w proces; ich role wyjaśnia dokumentacja podstawowych pojęć.

Rozróżniaj projekt procesu i jego wykonanie. Execution, czyli wykonanie, to pojedyncze uruchomienie workflow, zgodnie z dokumentacją wykonań. Do oceny wyniku potrzebujesz konkretnego uruchomienia i danych, które przez nie przeszły.

Nasz przykład wygląda tak:

flowchart TD
    A["Ręczny start"] --> B["Fikcyjne zgłoszenie"]
    B --> C{"Kategoria: pomoc?"}
    C -->|Tak| D["Ścieżka pomocy"]
    C -->|Nie| E["Pozostałe zgłoszenia"]
    D --> F["Opcjonalnie: arkusz"]

Traktuj diagram jako plan ćwiczenia. Na pierwszym etapie zakończymy proces na warunku i obejrzymy wynik. Zapis w arkuszu dodamy osobno, żeby łatwiej znaleźć przyczynę ewentualnego błędu.

n8n oferuje usługę Cloud, w której zarządza infrastrukturą, oraz self-hosting, czyli uruchomienie na własnej infrastrukturze. Różnice przedstawia porównanie sposobów korzystania z n8n.

Moja rekomendacja dla początkujących: najpierw naucz się budować workflow w Cloud. Własny serwer dołóż później, gdy będziesz umieć rozpoznać, czy problem dotyczy procesu, czy środowiska.

Bezpłatny okres próbny Cloud trwa 14 dni i ma limit 1000 wykonań. Jeśli po jego zakończeniu nie przejdziesz na płatny plan, okres próbny wygaśnie, a przestrzeń robocza zostanie usunięta, zgodnie z warunkami próby. Pobierz workflow przed tym terminem.

Jeśli wybierzesz własną instalację, zacznij od podstaw Dockera i Compose. Docker uruchamia aplikacje w kontenerach, czyli wydzielonych środowiskach, a Compose opisuje współpracujące usługi. Następnie skorzystaj z instrukcji instalacji n8n przez Docker Compose.

Do głównego ćwiczenia przygotuj:

• dostęp do edytora n8n;
• przeglądarkę i fikcyjne dane;
• zapisany cel: „rozdziel zgłoszenia według kategorii”.

Dalszy przykład z arkuszem zakłada n8n Cloud, konto Google oraz osobny arkusz do testów. Ćwiczenie wykonujesz w przeglądarce, bez poleceń systemowych.

Jeśli nie masz jeszcze konta n8n, oficjalny przewodnik pierwszego workflow prowadzi do rejestracji Cloud. Nazwy elementów interfejsu poniżej zostawiam po angielsku, tak jak w dokumentacji.

Przed budową odpowiedz na dwa pytania: skąd przyjdą dane i po czym poznasz poprawny wynik? „Zautomatyzować obsługę” jest zbyt ogólne. „Zgłoszenie kategorii pomoc zapisać w arkuszu testowym” daje jasny cel.

1. Utwórz pusty proces

Na stronie Overview użyj przycisku tworzenia w prawym górnym rogu i wybierz workflow. Następnie wybierz Add first step..., zgodnie z instrukcją tworzenia procesu.

Oczekiwany wynik: pusta plansza, na której możesz umieścić pierwszy węzeł. Zostaw proces nieopublikowany podczas ćwiczenia.

2. Dodaj ręczny start

Wyszukaj Manual Trigger i dodaj go jako początek procesu. Ten wyzwalacz uruchamia workflow po wybraniu Execute Workflow; służy także do testowania przed dodaniem automatycznego startu, jak opisuje dokumentacja Manual Trigger.

Oczekiwany wynik: pierwszy blok na planszy. Sam ręczny start nie tworzy jeszcze użytecznego zgłoszenia.

3. Przygotuj fikcyjne dane

Dodaj za nim Edit Fields (Set). W Mode wybierz JSON Output. Ten tryb pozwala ustawić dane przez zapis JSON, zgodnie z dokumentacją Edit Fields.

JSON to tekstowy format danych zapisanych jako pary nazwy i wartości. Wklej do pola JSON Output cały przykład:

{
  "id": "TEST-001",
  "imie": "Anna",
  "kategoria": "pomoc",
  "tresc": "Nie mogę zalogować się do konta testowego."
}

To dane wymyślone na potrzeby poradnika. Uruchom workflow przyciskiem Execute Workflow i obejrzyj OUTPUT węzła. Powinien zawierać pola zgłoszenia; sposób uruchamiania i sprawdzania wyjścia pokazuje oficjalny samouczek.

4. Dodaj warunek

Dodaj węzeł If za Edit Fields (Set). W Conditions wybierz typ String, czyli tekst, i porównanie is equal to. Możliwości porównań opisuje dokumentacja If.

Przeciągnij pole kategoria z INPUT do pierwszej wartości warunku. Takie przeciąganie tworzy odwołanie do danych, zgodnie z instrukcją mapowania. Jako drugą wartość wpisz pomoc.

Uruchom proces ponownie. Oczekiwany wynik: zgłoszenie przechodzi na wyjście true, czyli warunek jest spełniony. Samouczek pokazuje sprawdzanie wyników true i false w panelu OUTPUT.

5. Sprawdź drugi wariant

W danych wejściowych zmień kategoria na sprzedaz i uruchom workflow ponownie. Oczekiwany wynik naszego porównania: zgłoszenie pojawia się na false, czyli nie spełnia warunku.

Przywróć pomoc przed następnym ćwiczeniem. Zapisz oba przypadki w notatkach: dzięki temu po zmianie procesu odtworzysz sprawdzenie bez zgadywania.

Mapowanie oznacza wskazanie, skąd następny węzeł ma wziąć wartość. W n8n możesz przeciągnąć pole z panelu INPUT do ustawienia węzła; edytor wygeneruje wyrażenie, czyli odwołanie obliczane podczas wykonania. Opisuje to dokumentacja mapowania danych.

Dla naszego zgłoszenia odwołanie do kategorii wygląda tak:

{{ $json.kategoria }}

To składnia wyrażenia n8n do wpisania w pole ustawione na Expression, a nie samodzielny program JavaScript. $json odwołuje się do danych bieżącego elementu; analogiczny przykład zawiera opis struktury danych.

Porównaj wpisane na stałe pomoc z odwołaniem do kategorii. Stała wartość jest naszym kryterium, odwołanie pobiera wartość zgłoszenia.

Dane mogą być zagnieżdżone, czyli schowane wewnątrz innego obiektu. Dla pola kategoria umieszczonego w body trzeba użyć {{ $json.body.kategoria }}, tak jak w przykładzie odczytu danych webhooka.

Ten etap wykonaj w n8n Cloud. Przygotuj pusty arkusz testowy z nagłówkami id, imie, kategoria i tresc w pierwszym wierszu.

1. Do wyjścia true węzła If dodaj Google Sheets.
2. W Credential to connect with utwórz lub wybierz poświadczenie, czyli zapisane dane pozwalające połączyć usługę. Tworzenie poświadczenia z poziomu węzła opisuje dokumentacja credentials.
3. Przy tworzeniu poświadczenia Google w Cloud użyj Sign in with Google. To obsługiwane połączenie OAuth2, czyli autoryzacja dostępu przez konto Google; Managed OAuth2 nie wymaga dodatkowej konfiguracji w Google Cloud Console.
4. Ustaw Resource na Sheet Within Document, a Operation na Append Row.
5. W Document wskaż dokument, a w Sheet właściwą kartę arkusza.
6. W Mapping Column Mode wybierz Map Automatically. Nazwy pól naszego przykładu odpowiadają nagłówkom. Taki warunek oraz działanie Append Row, które dopisuje wiersz, opisuje dokumentacja operacji Google Sheets.
7. Uruchom workflow dla kategorii pomoc i sprawdź arkusz.

Oczekiwany wynik: nowy wiersz z fikcyjnym zgłoszeniem. Każde kolejne wykonanie tej operacji dopisuje kolejny wiersz. Wykonaj próbę drugi raz i sprawdź powtórzenie.

To ćwiczenie tworzy testowy wpis w zewnętrznej usłudze. Do regularnego użycia polecam dopracować sprawdzanie identyfikatora id, zanim podłączysz prawdziwe zgłoszenia.

Harmonogram

Schedule Trigger uruchamia proces w ustalonych odstępach lub godzinach. Korzysta ze strefy czasowej workflow, a jeśli jej nie ustawisz, ze strefy instancji, czyli działającej instalacji n8n. Opisuje to dokumentacja harmonogramu.

Polecam przećwiczyć harmonogram na procesie bez zapisu do arkusza:

1. Zastąp ręczny wyzwalacz węzłem Schedule Trigger i połącz go z przygotowaniem danych.
2. Ustaw Trigger Interval na Weeks, Weeks Between Triggers na 1, Trigger on Weekdays na Monday, Trigger at Hour na 9am i Trigger at Minute na 0. To ustawienia oficjalnego przykładu.
3. Otwórz menu trzech kropek, wybierz Settings i ustaw Timezone na strefę dla Polski. Dostęp do ustawień i rolę tego pola opisuje dokumentacja ustawień workflow.
4. Przetestuj proces ręcznie, a potem kliknij Publish. W oknie publikowania ponownie wybierz Publish, zgodnie z instrukcją publikacji.

Oczekiwany wynik: opublikowany proces uruchamia się według harmonogramu. Nadal przetwarza te same fikcyjne dane, więc potraktuj go jako ćwiczenie, a przed regularnym użyciem zmień źródło danych.

Edycja zapisuje wersję roboczą, natomiast automatyczne wykonania korzystają z wersji opublikowanej. Po zmianie węzłów trzeba ją ponownie opublikować, zgodnie z zasadami zapisywania i publikacji.

Zdarzenie z innej aplikacji

Webhook to adres odbierający dane wysłane przez inną usługę po zdarzeniu, na przykład zgłoszeniu z formularza. Węzeł Webhook może rozpocząć workflow i ma osobne adresy do testów oraz pracy produkcyjnej.

Do testów służy Test URL, a do opublikowanego procesu Production URL. Sprawdź, który adres wpisałeś w aplikacji wysyłającej zgłoszenie, zanim zaczniesz zmieniać warunek.

Gdy potrzebujesz połączyć usługę przez jej API, czyli interfejs komunikacji między programami, węzeł HTTP Request pozwala skonfigurować żądanie. Przed takim rozszerzeniem przejdź przez poradnik API, JSON i HTTP.

Sprawdzaj proces od początku, węzeł po węźle. Porównuj rzeczywiste dane z zapisanym oczekiwaniem, zamiast od razu przebudowywać cały workflow.

• Brakuje pola w INPUT. Najpierw uruchom wcześniejszy węzeł. Samouczek n8n wskazuje, że bez wcześniejszego wykonania nie zobaczysz danych do konfiguracji warunku.
• Warunek wybiera inną ścieżkę. Sprawdź faktyczną kategorię, typ porównania i odwołanie. Zacznij od dokładnie tych danych, które podano w ćwiczeniu.
• Proces działa po kliknięciu, ale nie automatycznie. Sprawdź publikację. Instrukcja uruchamiania wymaga jej dla automatycznych wyzwalaczy.
• Arkusz zawiera powtórzenia. Sprawdź, ile razy uruchomiłeś dopisywanie. Przed ponowieniem ustal, które wcześniejsze operacje zakończyły się poprawnie.

Historię otworzysz przez Overview > Executions. Możesz filtrować ją według statusu, między innymi Failed i Success, zgodnie z instrukcją przeglądania wykonań.

n8n obsługuje też osobny workflow błędów rozpoczynający się od Error Trigger, który przypisujesz w ustawieniach procesu. Można użyć go do powiadomień o niepowodzeniu, co opisuje dokumentacja obsługi błędów. Polecam dodać takie powiadomienie przed regularną pracą.

Klucz API to sekret umożliwiający dostęp do usługi. Polecam trzymać klucze w poświadczeniach, zamiast wpisywać je w zwykłe pola danych. n8n przechowuje dane uwierzytelniające jako credentials.

Szablon to gotowy workflow do dostosowania. Bibliotekę otwiera Templates, zgodnie z instrukcją korzystania z szablonów. Przed uruchomieniem przeczytaj każdy węzeł i sprawdź, gdzie proces wysyła dane.

Aby zachować kopię naszego procesu:

1. Otwórz menu trzech kropek w prawym górnym rogu.
2. Wybierz Download, aby pobrać workflow jako JSON.
3. Przed udostępnieniem obejrzyj plik. Eksport zawiera nazwy i identyfikatory poświadczeń; węzły HTTP Request mogą zawierać nagłówki uwierzytelniające zaimportowane z cURL. Wyjaśnia to dokumentacja eksportu.

Zachowaj także krótką notatkę: cel procesu, potrzebne połączenia i oczekiwany wynik testu.

AI, czyli sztuczną inteligencję, polecam dodawać tam, gdzie potrzebujesz przetworzyć swobodny tekst: przygotować szkic odpowiedzi albo zaproponować kategorię zgłoszenia. Zacznij od przykładu, w którym człowiek ocenia propozycję przed dalszym działaniem.

Agent AI to system używający modelu językowego do podejmowania decyzji i korzystania z narzędzi; pojęcie wyjaśnia słownik n8n. W n8n można wymagać zatwierdzenia przez człowieka przed wykonaniem wybranego narzędzia agenta. Workflow wtedy czeka na zgodę lub odrzucenie, zgodnie z dokumentacją human-in-the-loop.

Polecam taki punkt kontroli przed wysyłaniem wiadomości lub zmianą danych. Przygotuj przykładowe zgłoszenia, oceń wyniki i zapisz przypadki wymagające poprawy. Dla prostego sprawdzenia kategorii z naszego ćwiczenia pozostań przy warunku If.

Czy n8n jest darmowe?

Bezpłatna edycja Community jest dostępna do samodzielnego hostowania. Cloud oferuje okres próbny, a później płatne plany, co wyjaśnia porównanie opcji n8n. Przy własnej instalacji uwzględnij w budżecie także utrzymanie infrastruktury.

Czy do n8n trzeba umieć programować?

Opisany przykład zbudujesz przez konfigurację węzłów i dane JSON. Najpierw opanuj odczytywanie wejścia i wyjścia. Gdy dojdziesz do własnych żądań API, uzupełnij podstawy komunikacji między aplikacjami.

Dlaczego workflow nie uruchamia się automatycznie?

Sprawdź, czy ma automatyczny wyzwalacz i czy został opublikowany. Nieopublikowany workflow trzeba uruchamiać ręcznie, zgodnie z instrukcją tworzenia i uruchamiania. Przy harmonogramie sprawdź również ustawienia czasu.

Czy można połączyć Google Sheets z własną instalacją n8n?

Tak, ale Managed OAuth2 jest dostępne dla użytkowników Cloud. We własnej instalacji trzeba skonfigurować Custom OAuth2, czyli własne połączenie autoryzacyjne. Pełną procedurę opisuje dokumentacja poświadczeń Google.

Przejdź do API od zera: JSON i HTTP w praktyce, aby przygotować się do pobierania prawdziwych danych. Wróć potem do naszego workflow i wymień fikcyjne zgłoszenie na wybrane źródło, zachowując te same przypadki testowe.

Jeśli planujesz własny serwer, kolejnymi tematami są Docker i Compose oraz hosting i VPS. VPS to wirtualny serwer prywatny. Przejdź do tego etapu po opanowaniu danych, warunków i diagnozowania wykonań.