Čo je integrácia n8n v Task Manageri?
Integrácia n8n v Task Manageri prenáša údaje medzi úlohami a ďalšími systémami. Podanie z formulára sa môže zmeniť na úlohu bez prepisovania. Vytvorenie úlohy môže spustiť zápis do tabuľky Google alebo upozornenie na Slacku. Tím pracuje v Task Manageri ako zvyčajne.
Integrácia n8n patrí do variantu Pro. Ide o experimentálnu funkciu, ktorá je predvolene vypnutá. Administrátor ju zapína v sekcii Nastavenia → Pokročilé → Iné. Keď je vypnutá, záložka n8n sa v rozhraní nezobrazuje a endpointy /api/n8n/* odmietajú požiadavky s kódom 503. Kapitola návodu o n8n sa tiež stráca z kontextu Asistenta AI.
n8n je samostatná platforma na vytváranie pracovných tokov medzi aplikáciami. Task Manager do nej odosiela udalosti a prijíma volania späť.
Ako to funguje?
Údaje z Task Managera do n8n odchádzajú cez webhook. Zadáte jeho názov, adresu URL z node *Webhook* v n8n a vyberiete udalosti. Môžete tiež pridať tajný kľúč na podpisovanie požiadaviek (HMAC). Na výber je 26 udalostí vrátane task.created, task.status_changed, task.completed a chat.message_sent, pričom systémové udalosti (system.daily_summary a ostatné system.*) a user.created sa odosielajú výhradne do globálnych webhookov vytvorených správcom. Každá požiadavka obsahuje názov udalosti, časovú značku a kontextové údaje. Pred zostavením celého toku môžete odoslať testovací ping.
V opačnom smere funguje kľúč API. Token vo formáte tm_live_<32hex> sa zobrazí iba raz. V n8n ho zadáte do hlavičky Authorization: Bearer. Dostupné endpointy sú ping.php, workspaces.php, users.php, tasks.php a messages.php. POST /api/n8n/tasks.php vytvorí úlohu s názvom, opisom, prioritou, termínom a zoznamom priradených osôb. PATCH aktualizuje existujúcu úlohu. Vyžaduje task_id; ostatné polia sú voliteľné. Ak node HTTP nepodporuje PATCH, môžete odoslať body cez POST. Prítomnosť task_id prepne endpoint do režimu aktualizácie.
Zmena stavu z n8n prebieha rovnako ako zmena v aplikácii. Vo vlákne úlohy sa zobrazí záznam „zmenil(a) stav na…“, priradené osoby dostanú e-mail a Task Manager odošle task.status_changed (pri stave done aj task.completed). Opätovné nastavenie rovnakého stavu neodošle ďalšiu udalosť. Neúspešný webhook sa zaradí do frontu. Front počíta s intervalmi 60, 300 a 1800 sekúnd a maximálne štyrmi pokusmi, opakovanie však vykonáva cron retry alebo spracovanie frontu pri niektorých požiadavkách do aplikácie. Bez cronu a aktivity v aplikácii sa opakovanie v týchto intervaloch neuskutoční. Chyba integrácie neblokuje prácu v programe.
Kľúč funguje s oprávneniami používateľa, ktorý ho vytvoril, a s jeho prístupom k pracovným priestorom. Súbor users.php je dostupný výhradne pre kľúče globálneho správcu. Adresy webhookov v súkromných a rezervovaných rozsahoch IP sú blokované; politika n8n_private_network_policy má hodnoty off, admin a all, pri nesprávnej hodnote sa použije off.
Čo získate?
Nemusíte prepisovať hlásenie zákazníka z formulára do úlohy. Ráno sa môžete rovno pustiť do riešenia hlásenia namiesto prenášania údajov medzi oknami.
Nemusíte ani pamätať na aktualizáciu dvoch systémov po dokončení práce. Keď sa úloha uzavrie, informácia môže pokračovať ďalej cez pripravený workflow. Zákazník nemusí čakať, kým niekto zmenu ručne zaznamená aj na druhej strane.
Váš tím sa nemusí učiť pracovať s n8n, aby mohol využívať hotovú integráciu. Keď sa úloha uzavrie prostredníctvom externého workflow, priradené osoby dostanú e-mail a vo vlákne sa zobrazí záznam o zmene. Výpadok integrácie nezastaví prácu na úlohách.
Príklad z každodennej práce
Servisná firma prijíma hlásenia v externom ticketovacom systéme. Tok v n8n prijme nový ticket a odošle POST /api/n8n/tasks.php. Vznikne úloha s adresou v popise, prioritou high a termínom v deadline_date - v pracovnom priestore, ku ktorému má prístup vlastník kľúča, a s tými osobami zo zoznamu assignees, ktoré k nemu majú tiež prístup.
Keď technik úlohu uzavrie, Task Manager odošle webhooku, ktorý má túto udalosť označenú, task.completed a tok aktualizuje stav v systéme zákazníka. Samostatný webhook pre task.deadline_approaching (udalosť generuje opakujúca sa úloha „deadline“, takže vyžaduje zapnutý cron) môže spustiť odoslanie SMS pripomienky blížiaceho sa termínu. Technik nemusí používať n8n.
Najčastejšie otázky
Je integrácia n8n súčasťou variantu Standard?
Nie, je to funkcia variantu Pro. V Standarde prepínač integrácie v Nastaveniach nie je, takže ju nie je možné zapnúť.
Funguje integrácia n8n hneď po inštalácii?
Nie. Ide o experimentálnu funkciu, ktorá je predvolene vypnutá. Správca ju zapne v Nastaveniach → Rozšírené → Ostatné. Dovtedy je karta n8n skrytá a endpointy /api/n8n/* vracajú kód 503.
Vyžadujú integrácie programátora?
Na vytvorenie pracovného toku v n8n sa hodí technicky zdatná osoba. Treba skopírovať adresu webhooku, zadať token a pripraviť JSON body. Používanie hotového pracovného toku tieto znalosti nevyžaduje.
Môžem zmeniť stav úlohy zvonka?
Áno. Odošlite požiadavku PATCH na /api/n8n/tasks.php s údajmi task_id a stavom none, in_progress, done alebo cancelled. Zmena vyvolá záznam vo vlákne úlohy, e-mail pre priradené osoby a odchádzajúci webhook.
Čo sa stane, keď n8n neodpovedá?
Neúspešný webhook sa zaradí do frontu. Front počíta s intervalmi 60, 300 a 1800 sekúnd a maximálne štyrmi pokusmi, opakovanie však vykonáva cron retry alebo spracovanie frontu pri niektorých požiadavkách do aplikácie. Bez cronu a aktivity v aplikácii sa opakovanie v týchto intervaloch neuskutoční. Chyba integrácie neblokuje prácu v programe.
Vymaže vypnutie integrácie konfiguráciu?
Nie. Webhooky a kľúče API zostávajú v databáze a po opätovnom zapnutí integrácie sa znovu zobrazia.