Formularz do CRM w n8n: gotowy proces bez duplikatów

Test i publikacja: 24 października 2026. n8n 2.44.6 na Windows. Wszystkie zgłoszenia w przykładzie są fikcyjne.

Formularz może sam przekazywać zgłoszenia do CRM. Ale samo połączenie dwóch aplikacji nie rozwiązuje jeszcze duplikatów, błędnych danych i przerw w działaniu.

Przygotowałem kompletny przykład do uruchomienia lokalnie: formularz w n8n, sprawdzenie danych i prosty CRM demonstracyjny. Możesz pobrać pliki i przejść ten sam test u siebie, bez płatnego konta CRM.

Co przygotować do automatyzacji formularza i CRM?

• Działające n8n. Jeśli jeszcze go nie masz, zacznij od poradnika instalacji n8n lokalnie.
• Python 3.10 lub nowszy do uruchomienia załączonego CRM. Program korzysta z biblioteki standardowej i nie wymaga instalowania modułów pip.
• Pliki z pakietu oraz fikcyjne dane do prób.

W przykładzie nie ma modelu językowego. Przeniesienie formularza do określonych pól i sprawdzenie duplikatu nie potrzebuje AI.

CRM działa pod adresem http://127.0.0.1:4198. Nasłuchuje wyłącznie na komputerze, na którym go uruchomisz. Służy do odtworzenia procesu i testów, a nie do publicznej obsługi danych klientów.

1. Uruchom CRM demonstracyjny

Rozpakuj ZIP do osobnego folderu. Zostaw obok siebie pliki crm_demo.py i index.html. Otwórz w tym folderze terminal i wpisz:

python --version
python crm_demo.py

W Windows możesz też użyć py -3 crm_demo.py, jeśli tak uruchamiasz Pythona. Gdy polecenie nie jest dostępne, zainstaluj Pythona z oficjalnego źródła wskazanego na końcu artykułu.

Otwórz w przeglądarce http://127.0.0.1:4198. Zobaczysz pustą listę kontaktów, powiadomienia i kontrolę testowej awarii.

Po pierwszym uruchomieniu powstanie plik crm-demo.sqlite3. To lokalna baza demonstratora. Zamknięcie okna przeglądarki jej nie usuwa. Aby zatrzymać serwer, użyj Ctrl+C w terminalu.

2. Zaimportuj gotowy workflow do n8n

Utwórz pusty workflow i w menu jego działań wybierz Import from File. Wskaż formularz-crm.json, a potem zapisz proces.

Proces ma siedem węzłów. Nazwy na planszy są po polsku, ale nazwy funkcji w interfejsie n8n mogą pozostać angielskie.

Na tym etapie nie musisz dodawać żadnych kluczy API. Adres w HTTP Request prowadzi do CRM, który przed chwilą uruchomiłeś na tym samym komputerze.

3. Sprawdź pola formularza i mapowanie

Rozdzielamy etykietę widoczną dla człowieka od technicznej nazwy pola. Dzięki temu zmiana napisu „Opis sprawy” nie musi zmieniać mapowania w kolejnych węzłach.

W HTTP Request ustawione są:

• Method: POST.
• URL: http://127.0.0.1:4198/api/leads.
• Send Body: włączone, treść JSON.
• Timeout: 3000 ms w tym lokalnym teście.

={{ {name:$json.name,email:$json.email,company:$json.company,message:$json.message} }}

4. Sprawdź dane przed zapisem

Formularz pilnuje wymaganych pól i podstawowej poprawności adresu. Węzeł Code wykonuje dodatkowe sprawdzenie już w procesie: imię i opis nie mogą być puste, adres musi mieć podstawową strukturę e-maila, a pola mieszczą się w ustalonych długościach.

To dwa różne miejsca kontroli. Sam widoczny na stronie formularz nie powinien być jedyną ochroną danych trafiających do systemu.

W przykładzie e-mail jest przycinany i zamieniany na małe litery. ANNA@EXAMPLE.TEST oraz anna@example.test trafiają do tego samego kontaktu. Nie usuwam kropek ani fragmentów adresu po znaku „+”.

Jak unikamy duplikatów w CRM?

W tej demonstracji kluczem kontaktu jest uporządkowany e-mail. CRM wykonuje zapis typu upsert: dodaje kontakt, jeśli go nie ma, lub aktualizuje istniejący.

Reguła działa w bazie, która ma ograniczenie UNIQUE(email). Nie polegamy wyłącznie na dwóch oddzielnych krokach „wyszukaj” i „utwórz”. Między nimi mogłyby pojawić się dwa równoczesne zgłoszenia.

Kontakt i pierwsze powiadomienie powstają w jednej transakcji bazy. Powiadomienie ma dodatkowo unikalne przypisanie do kontaktu. Ponowiony zapis nie dodaje go jeszcze raz.

W firmowym CRM zwykle warto odróżnić kontakt od sprawy lub szansy sprzedażowej. Ta sama osoba może zamawiać kilka różnych usług. W takim procesie nie blokujemy kolejnego zapytania tylko dlatego, że znamy już jej e-mail. Ustalamy osobny identyfikator sprawy i historię wiadomości.

Co, jeśli CRM nie odpowie?

Węzeł HTTP Request ma włączone Retry On Fail: maksymalnie trzy próby z odstępem jednej sekundy. Po niepowodzeniu korzysta z osobnego wyjścia błędu, zamiast udawać poprawny zapis.

Są dwa istotne przypadki:

1. CRM nie zapisał danych. Po trzech nieudanych próbach formularz informuje, że nie może potwierdzić zapisu.
2. CRM zapisał kontakt, ale nie dostarczyło się potwierdzenie. n8n ponawia operację. Upsert odnajduje istniejący kontakt, więc nie powstaje drugi rekord ani drugie powiadomienie.

W panelu CRM znajdziesz dwa tryby symulacji: awaria przed zapisem oraz jednorazowy błąd po zapisie. Używaj ich wyłącznie do prób na fikcyjnych danych.

To nie jest trwała kolejka oczekująca do skutku. Przy dłuższej awarii potrzebna jest ustalona procedura odzyskania zgłoszeń, kolejka lub ręczna obsługa. Błędów autoryzacji czy mapowania nie naprawi samo zwiększenie liczby prób.

5. Zapisz, opublikuj i uruchom formularz

1. Upewnij się, że lokalny CRM i n8n działają.
2. Otwórz węzeł Formularz zgłoszenia.
3. Do próby z obserwacją w edytorze użyj Test URL i uruchom nasłuchiwanie przez Execute workflow.
4. Do samodzielnego działania zapisz proces, kliknij Publish i wybierz Production URL.
5. Otwórz podany adres formularza, wypełnij go fikcyjnymi danymi i sprawdź wynik w CRM.

W gotowym pliku ścieżka formularza to exaity-formularz-crm. Dla lokalnej instalacji na porcie 5678 adres produkcyjny ma postać:

http://localhost:5678/form/exaity-formularz-crm

„Production” to nazwa rodzaju adresu w n8n. Nie oznacza, że lokalny demonstrator jest gotowym wdrożeniem firmowym. Jeśli zmienisz port, domenę lub ścieżkę, korzystaj z adresu widocznego w swoim węźle.

Po zgłoszeniu wróć do panelu CRM i kliknij „Odśwież dane”. Nie musisz odświeżać samego ekranu potwierdzenia formularza. Kolejny test zaczynaj od głównego adresu formularza.

Wyniki dziesięciu prób

Po dziesięciu próbach w CRM zostało pięć kontaktów i pięć powiadomień. Sprawdziłem proces w przeglądarce i porównałem wynik z lokalną bazą. Test zacząłem od pustego CRM.

Brakujący i błędny e-mail zatrzymał formularz przed zapisem. Kod walidacji przeszedł też dziesięć osobnych testów, m.in. pustych i zbyt długich pól.

Jak podłączyć firmowy CRM lub formularz WordPress?

Schemat pozostaje podobny, ale nie wystarczy zamienić adresu w HTTP Request na domenę swojego CRM.

Co przygotować przed wdrożeniem w firmie?

Demonstracja pozwala prześledzić dane i reakcję na błąd. Dla prawdziwego obiegu potrzebne są jeszcze decyzje dotyczące środowiska, danych i utrzymania.

• Dostępność: gdzie działa n8n i co się dzieje po restarcie, awarii lub wygaśnięciu dostępu.
• Zakres danych: które pola są potrzebne, jak długo zapisujesz wykonania i kto może je odczytać.
• Uprawnienia: konta integracyjne, bezpieczne przechowywanie sekretów i sposób ich wymiany.
• Wyjątki: kto dostaje informację o błędzie i gdzie trafia zgłoszenie wymagające człowieka.
• Odtworzenie: kopie, procedura ponowień i test po aktualizacji.

Demonstrator nie ma kont zespołu, rozbudowanej historii spraw ani produkcyjnego mechanizmu kolejkowania. Jego API jest lokalne i nie należy go wystawiać publicznie. Te elementy dobieramy do rzeczywistego systemu.

Najczęstsze pytania