Czym jest integracja n8n w Task Managerze?
Integracja n8n w Task Managerze przenosi dane między zadaniami a innymi systemami. Zgłoszenie z formularza może stać się zadaniem bez przepisywania. Utworzenie zadania może uruchomić wpis w arkuszu Google albo powiadomienie na Slacku. Zespół pracuje w Task Managerze jak zwykle.
Integracja n8n należy do wariantu Pro. To funkcja eksperymentalna i domyślnie wyłączona. Administrator włącza ją w Ustawieniach → Zaawansowane → Inne. Gdy jest wyłączona, zakładka n8n nie pojawia się w interfejsie, a endpointy /api/n8n/* odrzucają żądania kodem 503. Rozdział instrukcji o n8n znika też z kontekstu Asystenta AI.
n8n to osobna platforma do budowania przepływów między aplikacjami. Task Manager wysyła do niej zdarzenia i przyjmuje wywołania z powrotem.
Jak to działa?
Z Task Managera do n8n dane wychodzą przez webhook. Podajesz jego nazwę, adres URL z node'a *Webhook* w n8n i wybierasz zdarzenia. Możesz też dodać sekret do podpisywania żądań (HMAC). Do wyboru jest 26 zdarzeń, między innymi task.created, task.status_changed, task.completed i chat.message_sent, przy czym zdarzenia systemowe (system.daily_summary i pozostałe system.*) oraz user.created trafiają wyłącznie do webhooków globalnych zakładanych przez administratora. Każde żądanie zawiera nazwę zdarzenia, znacznik czasu i dane kontekstowe. Przed zbudowaniem całego przepływu możesz wysłać testowy ping.
W drugą stronę działa klucz API. Token w formacie tm_live_<32hex> pokazuje się tylko raz. W n8n podajesz go w nagłówku Authorization: Bearer. Dostępne endpointy to ping.php, workspaces.php, users.php, tasks.php i messages.php. POST /api/n8n/tasks.php tworzy zadanie z tematem, opisem, priorytetem, terminem i listą przypisanych osób. PATCH aktualizuje istniejące zadanie. Wymaga task_id; pozostałe pola są opcjonalne. Jeśli node HTTP nie obsługuje PATCH, możesz wysłać body przez POST. Obecność task_id przełącza endpoint w tryb aktualizacji.
Zmiana statusu z n8n przechodzi tą samą ścieżką co zmiana w aplikacji. W wątku zadania pojawia się wpis „zmienił(a) status na…”, przypisane osoby dostają e-mail, a Task Manager wysyła task.status_changed (przy done także task.completed). Ponowne ustawienie tego samego statusu nie wysyła kolejnego zdarzenia. Nieudany webhook trafia do kolejki. Kolejka przewiduje odstępy 60, 300 i 1800 sekund oraz maksymalnie cztery próby, ale ponowienia wykonuje cron retry albo obsługa kolejki przy części żądań do aplikacji. Bez crona i ruchu w aplikacji ponowienie nie nastąpi w tych odstępach. Błąd integracji nie blokuje pracy w programie.
Klucz działa z uprawnieniami użytkownika, który go utworzył, i jego dostępem do workspace'ów. users.php jest dostępny wyłącznie dla kluczy administratora globalnego. Adresy webhooków w prywatnych i zarezerwowanych pulach IP są blokowane; polityka n8n_private_network_policy ma wartości off, admin i all, a przy błędnej wartości działa jak off.
Co zyskujesz?
Nie przepisujesz zgłoszenia klienta z formularza do zadania. Rano możesz zacząć od pracy nad zgłoszeniem zamiast od przenoszenia danych między oknami.
Nie musisz też pamiętać o aktualizowaniu dwóch systemów po zakończeniu pracy. Gdy zadanie zostaje zamknięte, informacja może trafić dalej przez przygotowany przepływ. Klient nie musi czekać, aż ktoś ręcznie odnotuje zmianę po drugiej stronie.
Twój zespół nie musi uczyć się n8n, żeby korzystać z gotowej integracji. Gdy zadanie zostaje zamknięte przez zewnętrzny przepływ, przypisane osoby dostają e-mail, a w wątku zostaje wpis o zmianie. Awaria integracji nie zatrzymuje pracy nad zadaniami.
Przykład z codziennej pracy
Firma serwisowa przyjmuje zgłoszenia w zewnętrznym systemie ticketowym. Przepływ w n8n odbiera nowy ticket i wysyła POST /api/n8n/tasks.php. Powstaje zadanie z adresem w opisie, priorytetem high i terminem w deadline_date - w workspace, do którego ma dostęp właściciel klucza, i z tymi osobami z listy assignees, które również mają do niego dostęp.
Gdy technik zamyka zadanie, Task Manager wysyła task.completed do webhooka, który ma zaznaczone to zdarzenie, a przepływ aktualizuje status w systemie klienta. Osobny webhook na task.deadline_approaching (zdarzenie emituje zadanie cykliczne „deadline”, więc wymaga włączonego crona) może uruchomić wysyłkę przypomnienia SMS o zbliżającym się terminie. Technik nie musi korzystać z n8n.
Najczęstsze pytania
Czy integracja n8n jest w wariancie Standard?
Nie, to funkcja wariantu Pro. W Standardzie przełącznika integracji w Ustawieniach nie ma, więc nie da się jej włączyć.
Czy integracja n8n działa od razu po instalacji?
Nie. To funkcja eksperymentalna i domyślnie wyłączona. Administrator włącza ją w Ustawieniach → Zaawansowane → Inne. Do tego czasu zakładka n8n jest ukryta, a endpointy /api/n8n/* zwracają kod 503.
Czy integracje wymagają programisty?
Do zbudowania przepływu w n8n przydaje się osoba techniczna. Trzeba skopiować adres webhooka, podać token i przygotować body JSON. Korzystanie z gotowego przepływu nie wymaga tej wiedzy.
Czy mogę zmienić status zadania z zewnątrz?
Tak. Wyślij żądanie PATCH na /api/n8n/tasks.php z task_id i statusem none, in_progress, done albo cancelled. Zmiana wywoła wpis w wątku zadania, e-mail do przypisanych osób i webhook wychodzący.
Co się dzieje, gdy n8n nie odpowiada?
Nieudany webhook trafia do kolejki. Kolejka przewiduje odstępy 60, 300 i 1800 sekund oraz maksymalnie cztery próby, ale ponowienia wykonuje cron retry albo obsługa kolejki przy części żądań do aplikacji. Bez crona i ruchu w aplikacji ponowienie nie nastąpi w tych odstępach. Błąd integracji nie blokuje pracy w programie.
Czy wyłączenie integracji kasuje konfigurację?
Nie. Webhooki i klucze API zostają w bazie i wracają po ponownym włączeniu integracji.