n8n workflow dla początkujących: zbuduj i opublikuj pierwszą automatyzację

Żeby opanować n8n workflow, zbuduj jeden mały przykład od początku do końca: wyzwalacz, który odbiera dane, jeden węzeł, który coś z nimi robi, uruchomienie testowe i krok Publish, dzięki któremu całość działa bez Ciebie. Wszystko, co w n8n większe, to ten sam wzorzec z większą liczbą węzłów. Ten n8n tutorial prowadzi przez pierwszy workflow, przez pułapkę adresu testowego, w którą wpada wielu początkujących, przez obsługę błędów i przez drugi workflow, który wysyła zapytania ze strony do CRM.

Jeśli chcesz połączyć n8n z MCP, porównanie dróg n8n MCP wraz z przykładem w przypiętej wersji rozróżnia dwa kierunki: podłączenie n8n do serwera danych klientów oraz udostępnienie samego n8n klientowi AI. Wybierz kierunek, zanim skonfigurujesz poświadczenia.

Czym jest n8n i czym jest workflow?

n8n to narzędzie do automatyzacji, w którym łączysz aplikacje i usługi w przepływy pracy (workflow) w edytorze wizualnym. Workflow to ciąg kroków uruchamianych automatycznie: coś się dzieje (wpada zapytanie, nadchodzi godzina z harmonogramu), a n8n wykonuje po kolei kroki ułożone na kanwie, na przykład sprawdza dane, zapisuje kontakt w CRM i wysyła wiadomość. Dobrze zaczynać od jednego prostego przykładu, bo każdy większy workflow to ten sam wzorzec z większą liczbą węzłów.

Jak działa n8n: sześć pojęć, które musisz znać

Dokumentacja n8n posługuje się małym słownikiem. Gdy te pojęcia staną się jasne, edytor też przestaje być zagadką.

Ostatni wiersz ma znaczenie dla kosztów. Strona z cennikiem n8n definiuje wykonanie jako „pojedyncze uruchomienie całego workflow”, bez względu na liczbę kroków i ilość przetwarzanych danych. Workflow z dziesięcioma węzłami uruchomiony raz to jedno wykonanie.

Cloud czy self-hosting: gdzie uruchomić n8n

Masz dwie możliwości. n8n Cloud wymaga tylko konta. Community Edition jest darmowa i działa na Twoim komputerze albo serwerze, który potem sam utrzymujesz.

Ceny sprawdzone 8 października 2026 na stronie z cennikiem n8n. Dostępne jest też rozliczanie miesięczne, które kosztuje więcej; strona przedstawia opcję roczną jako oszczędność 17%. Okres próbny Cloud daje funkcje Pro z limitem 1000 wykonań i nie wymaga karty kredytowej.

Dwie różnice zmieniają to, co może zrobić początkujący:

• Węzły społeczności. n8n Cloud instaluje tylko zweryfikowane węzły społeczności. Niezweryfikowane wymagają własnej instancji, według dokumentacji n8n o węzłach społeczności.
• Licencja. Community Edition jest publikowana na Sustainable Use License, która pozwala na użycie „do własnych wewnętrznych celów biznesowych albo do użytku niekomercyjnego lub osobistego”. Automatyzacja własnej firmy jest objęta licencją. Odsprzedawanie n8n jako usługi hostowanej już nie.

Wybierz Cloud, jeśli chcesz zacząć dziś i nikt w zespole nie chce utrzymywać serwera. Postaw własną instancję, jeśli potrzebujesz niezweryfikowanych węzłów społeczności, chcesz mieć dane na własnej infrastrukturze albo spodziewasz się tylu uruchomień, że limity wykonań kosztowałyby więcej niż mały serwer.

Żeby wypróbować Community Edition lokalnie, najkrócej jest użyć Dockera. To minimalna wersja polecenia z przewodnika n8n po Dockerze:

docker volume create n8n_data
docker run -it --rm --name n8n -p 5678:5678 \
  -v n8n_data:/home/node/.n8n n8nio/n8n

Potem otwórz http://localhost:5678. Przewodnik dodaje ustawienia strefy czasowej, a dla serwera działającego bez przerwy n8n odsyła do konfiguracji z Docker Compose i HTTPS. Lokalna instancja wystarcza do nauki. Nie jest dostępna z internetu, co ma znaczenie, gdy usługa w chmurze musi wywołać Twój webhook.

Zbuduj pierwszy workflow: zapytanie, które wysyła Ci e-mail

Workflow odbiera ładunek JSON, taki jak wysłałby formularz ze strony, sprawdza, czy zawiera adres e-mail, i wysyła Ci szczegóły e-mailem. Ma trzy węzły i uczy każdego podstawowego pojęcia.

1. Utwórz workflow i dodaj wyzwalacz Webhook

   Utwórz nowy workflow i dodaj węzeł Webhook jako wyzwalacz. Ustaw metodę HTTP na POST i nadaj ścieżce czytelną nazwę, na przykład inquiry. Węzeł pokazuje dwa adresy: testowy i produkcyjny. Skopiuj adres testowy.

2. Wyślij mu dane testowe

   Kliknij Listen for test event. n8n czeka teraz na wywołanie. Z terminala wyślij przykładowe zapytanie na adres testowy:

   curl -X POST "<your test URL>" \
     -H "Content-Type: application/json" \
     -d '{"firstName":"Lisa","lastName":"Meyer","email":"lisa@example.com","message":"Czy możemy porozmawiać o stałej współpracy?"}'

   Panel wyjściowy węzła pokazuje teraz cztery pola. Przypnij ten wynik (pin), żeby kolejne testy używały go bez ponownego wywoływania curl.

3. Dodaj węzeł If

   Połącz węzeł If i dodaj jeden warunek: {{ $json.body.email }} nie jest pusty. Dane z webhooka przychodzą w polu body i to jest szczegół, na którym potyka się wielu piszących pierwsze wyrażenie. Elementy, które spełnią warunek, wychodzą gałęzią true.

4. Dodaj węzeł e-mail na gałęzi true

   Dodaj węzeł Gmail (albo Send Email z poświadczeniami SMTP). Utwórz poświadczenie, gdy węzeł o to poprosi. W temacie wpisz Nowe zapytanie od {{ $json.body.firstName }} {{ $json.body.lastName }}, a w treści umieść wiadomość i adres e-mail.

5. Uruchom cały workflow

   Kliknij Execute workflow i wyślij to samo wywołanie curl jeszcze raz. Każdy węzeł, który się wykonał, pokazuje liczbę elementów, a po kliknięciu węzła widzisz dokładnie, co do niego weszło i co z niego wyszło. Jeśli e-mail dotrze, logika działa.

6. Opublikuj go i przełącz się na adres produkcyjny

   Kliknij Publish. Od tej chwili workflow nasłuchuje pod adresem produkcyjnym i to ten adres ma wywoływać Twój formularz. Uruchomienia produkcyjne nie pojawiają się na kanwie; znajdziesz je na karcie Executions.

Webhook n8n: adres testowy czy produkcyjny?

Pomylenie tych dwóch adresów to częsta przyczyna pytań w stylu „mój n8n webhook nie działa”. Dokumentacja węzła Webhook w n8n je rozróżnia:

Jeśli wywołanie adresu produkcyjnego zwraca błąd, sprawdź najpierw, czy workflow jest opublikowany, a potem, czy wywołujący używa właściwej metody (tutaj POST).

Dodaj obsługę błędów, zanim zaczniesz na nim polegać

Opublikowany workflow nikogo nie powiadomi o porażce, dopóki nie powiesz n8n, gdzie zgłaszać błędy. Większość przypadków pokrywają dwa ustawienia.

1. Workflow błędów. Utwórz osobny workflow, który zaczyna się od węzła Error Trigger i wysyła Ci e-mail z nazwą workflow, który zawiódł, i komunikatem błędu. Potem otwórz oryginalny workflow, przejdź do Options > Settings i wybierz go w polu Error workflow. Dokumentacja obsługi błędów wymienia dane, które odbiera Error Trigger.
2. Ustawienia węzłów. Każdy węzeł ma kartę ustawień. Przy wywołaniach zewnętrznych API włącz Retry On Fail. Dla kroków, które mogą się nie udać bez szkody, jak krok zapisujący log, ustaw On Error na Continue, żeby reszta uruchomienia i tak się zakończyła.

Przy okazji nadawaj rzeczom nazwy. „Zapytanie: formularz ze strony do CRM” w e-mailu o błędzie mówi, gdzie szukać. „My workflow 3” nie mówi.

Drugi workflow: zapytanie ze strony do CRM

Użyteczna wersja pierwszego workflow zapisuje zapytanie tam, gdzie pracuje Twój zespół. Wzorzec jest taki sam dla każdego CRM z REST API: uwierzytelnij się kluczem API, zmapuj pola formularza na nazwy pól w CRM, wyślij jedno żądanie HTTP. Poniższy przykład używa Customermates, czyli CRM, który publikuje ten poradnik, bo szczegóły jego API są publiczne.

1. Utwórz klucz API

   W Customermates otwórz Ustawienia → Klucze API i konektory, kliknij Dodaj i wybierz Standardowy klucz API. Klucz działa z uprawnieniami użytkownika, który go utworzył, więc utwórz go jako użytkownik, który może tworzyć kontakty. Szczegóły znajdziesz w kluczach API.

2. Zapisz go jako poświadczenie n8n

   W n8n utwórz poświadczenie Header Auth z nazwą nagłówka x-api-key i kluczem jako wartością. Korzysta z niego każdy węzeł rozmawiający z CRM, więc zmieniony klucz podmieniasz w jednym miejscu.

3. Zastąp węzeł e-mail węzłem HTTP Request

   Najpierw jednorazowo sprawdź identyfikatory: POST <your Customermates address>/api/v1/model/discover z {} zwraca identyfikator typu Kontakty, a POST /api/v1/model/read z tym identyfikatorem w typeIds zwraca identyfikatory pól i bieżącą rewizję schematu. Potem na gałęzi true węzła If dodaj węzeł HTTP Request: metoda POST, adres URL <your Customermates address>/api/v1/records/mutate, uwierzytelnianie przez poświadczenie Header Auth i treść JSON:

   {
     "expectedRevision": 12,
     "idempotencyKey": "inquiry-{{ $execution.id }}",
     "mutation": {
       "action": "create",
       "typeId": "<Contacts type ID>",
       "fields": [
         { "fieldId": "<First name field ID>", "value": { "kind": "text", "value": "{{ $json.body.firstName }}" } },
         { "fieldId": "<Last name field ID>", "value": { "kind": "text", "value": "{{ $json.body.lastName }}" } }
       ],
       "identities": [{ "provider": "mail", "value": "{{ $json.body.email }}" }]
     }
   }

   Zastąp 12 i identyfikatory w nawiasach ostrych wartościami z model/read. Adres e-mail trafia do identities z dostawcą mail, w ten sposób Customermates łączy kontakt z jego rozmowami e-mailowymi. Klucz idempotentności sprawia, że ponowione uruchomienie zwraca pierwszy wynik zamiast tworzyć drugi kontakt. Żeby zachować wiadomość, dopisz ją potem do notatek kontaktu mutacją update.

4. Zostaw powiadomienie

   Po węźle HTTP Request zostaw węzeł e-mail, żeby ktoś zobaczył nowy kontakt. Potem przetestuj na przypiętych danych, sprawdź kontakt w CRM i opublikuj.

Działa też kierunek odwrotny. W Ustawienia → Webhooki → Dodaj Customermates wysyła POST do węzła Webhook w n8n, gdy zajdzie subskrybowane zdarzenie, na przykład record.created dla listy Kontakty albo record.updated dla listy Szanse sprzedaży. Ustaw sekret, żeby n8n mogło zweryfikować podpis. Dokumentacja webhooków pokazuje ładunek. Jedna praktyczna pułapka: Customermates Cloud nie dotrze do instancji n8n pod localhost, więc ten kierunek wymaga n8n Cloud albo własnej instancji n8n z publicznym adresem HTTPS.

Kilka szczegółów z dokumentacji integracji z n8n oszczędzi Ci czasu na debugowaniu:

• Powiązania zmieniają się wyłącznie mutacjami link i unlink. Starsze tablice relacji, takie jak organizationIds, nie są akceptowane.
• updateMany i deleteMany przyjmują najwyżej 100 rekordów na żądanie, więc większe partie podziel.
• Dostarczanie webhooków nie jest ściśle uporządkowane. Do ustalenia kolejności użyj timestamp z ładunku, a do odrzucania duplikatów identyfikatora zdarzenia.

Istnieje też węzeł społeczności Customermates, @customermates/n8n-nodes-crm, z węzłem akcji dla rekordów CRM i węzłem wyzwalacza dla zdarzeń webhooków. Ma własny harmonogram wydań, więc zanim użyjesz jego akcji CRM, sprawdź, czy obsługuje aktualne API rekordów. Ponieważ n8n Cloud instaluje tylko zweryfikowane węzły społeczności, tam postaw na drogę przez węzeł HTTP Request, a węzła społeczności używaj na własnej instancji n8n.

Węzły AI w workflow n8n

n8n ma węzły do modeli językowych, między innymi węzeł AI Agent, do którego podłączasz model czatu i opcjonalnie narzędzia. Dzięki nim w workflow może się znaleźć krok wymagający rozumienia tekstu: sklasyfikowanie zapytania, wyciągnięcie z wiadomości nazwy firmy albo przygotowanie szkicu odpowiedzi. Reszta workflow zostaje deterministyczna: wyzwalacz, sprawdzenie danych i zapis w CRM wykonują się zawsze tak samo.

Kilka zasad dla początkujących:

• Dodaj AI dopiero do działającego workflow. Najpierw zbuduj wersję bez modelu, potem wstaw jeden węzeł AI w miejsce, gdzie dziś czytasz tekst samodzielnie.
• Przetestuj na przypiętych danych. Odpowiedź modelu bywa różna przy tych samych danych wejściowych, więc sprawdź kilka przypadków, także dziwnych.
• Człowiek zatwierdza wysyłkę. Niech workflow zapisze szkic odpowiedzi, a nie wysyła go sam. To samo dotyczy usuwania rekordów.
• Pamiętaj o kosztach i danych. Wywołania modelu rozlicza jego dostawca według własnego cennika, a dane z workflow trafiają do tego dostawcy.

Jeśli chcesz, żeby klient AI sam wybierał narzędzia zamiast stałego workflow, zobacz poradnik o n8n MCP, a o różnicy między tymi podejściami piszemy w poradniku MCP vs API.

Szablony i gotowe przykłady workflow

Zamiast budować każdy workflow od zera, możesz zaczynać od szablonu: workflow w n8n da się wyeksportować i zaimportować jako plik JSON, więc w sieci znajdziesz biblioteki szablonów i przykłady od społeczności; część twórców i agencji sprzedaje też gotowe konfiguracje albo budowę workflow na zamówienie. Szablon oszczędza czas, ale nie zdejmuje z Ciebie odpowiedzialności:

1. Przeczytaj każdy węzeł, zanim go uruchomisz. Sprawdź, dokąd wysyła dane i co zapisuje.
2. Podmień poświadczenia na własne. Szablon nie powinien zawierać cudzych kluczy API, a Ty nie wklejaj swoich do plików, które udostępniasz.
3. Przetestuj na przypiętych danych, a dopiero potem opublikuj.
4. Dodaj obsługę błędów z sekcji wyżej, bo szablon zwykle jej nie ma.

Gdzie pasuje Customermates, a gdzie nie

n8n to osobny produkt. Nie wchodzi w skład żadnego planu Customermates: sam go uruchamiasz albo wykupujesz subskrypcję n8n Cloud. REST i MCP działają w każdym planie Customermates Cloud, webhooki w każdym płatnym planie, który zaczyna się od 12 € za użytkownika miesięcznie (zobacz cennik), a wszystkie trzy działają w samodzielnie hostowanej edycji open source.

Nie każda automatyzacja CRM potrzebuje n8n. Jeśli zadanie brzmi „w każdy poniedziałek przejrzyj szanse sprzedaży, które się nie ruszyły, i przygotuj notatkę do każdej”, wymaga to raczej osądu niż okablowania. W Customermates Cloud rutyna uruchamia Mate, asystenta w aplikacji, według harmonogramu albo przy zdarzeniu na rekordzie, z zapisaną instrukcją, i zużywa kredyty hostowanej AI. Jeśli wolisz, żeby w CRM pracował Twój własny klient AI, podłącz go przez MCP. Użyj n8n, gdy zadanie jest deterministyczne i przechodzi przez kilka systemów: formularz, CRM, arkusz, czat zespołu.

Jednego n8n za Ciebie nie zrobi: samego wracania do rozmowy z klientem. Gdy zapytanie stanie się kontaktem, rozmowa z tą osobą może leżeć na tym samym rekordzie: podłącz LinkedIn i e-mail w Customermates Cloud od planu Pro, a Mate albo Twój własny agent AI przygotuje odpowiedź i następny krok do przejrzenia i wysłania przez Ciebie. Żeby wypróbować to na własnych zapytaniach, zacznij okres próbny: 14 dni planu Pro bez karty kredytowej.

Jeśli potrzebujesz tylko kontaktów w arkuszu i jednego e-maila na zapytanie, do tego poradnika w ogóle nie potrzebujesz CRM. Robi to węzeł Google Sheets na gałęzi true.

Najczęstsze pytania