Co je integrace n8n v Task Manageru?
Integrace n8n v Task Manageru přenáší data mezi úkoly a dalšími systémy. Z podnětu z formuláře může vzniknout úkol bez ručního přepisování. Vytvoření úkolu může spustit záznam v tabulce Google nebo upozornění na Slacku. Tým pracuje v Task Manageru jako obvykle.
Integrace n8n patří do varianty Pro. Jde o experimentální funkci, která je ve výchozím nastavení vypnutá. Administrátor ji zapíná v Nastavení → Pokročilé → Jiné. Když je vypnutá, záložka n8n se v rozhraní nezobrazuje a endpointy /api/n8n/* odmítají požadavky s kódem 503. Kapitola návodu o n8n také zmizí z kontextu AI asistenta.
n8n je samostatná platforma pro vytváření workflow mezi aplikacemi. Task Manager do ní odesílá události a přijímá volání zpět.
Jak to funguje?
Data z aplikace Task Manager do n8n odcházejí přes webhook. Zadáte jeho název, adresu URL z uzlu *Webhook* v n8n a vyberete události. Můžete také přidat tajný klíč pro podepisování požadavků (HMAC). Na výběr je 26 událostí, mimo jiné task.created, task.status_changed, task.completed a chat.message_sent. Systémové události (system.daily_summary a další system.*) a také user.created se odesílají výhradně do globálních webhooků vytvořených správcem. Každý požadavek obsahuje název události, časové razítko a kontextová data. Než sestavíte celý tok, můžete odeslat testovací ping.
Opačným směrem funguje klíč API. Token ve formátu tm_live_<32hex> se zobrazí jen jednou. V n8n jej zadáte do hlavičky Authorization: Bearer. K dispozici jsou endpointy ping.php, workspaces.php, users.php, tasks.php a messages.php. POST /api/n8n/tasks.php vytvoří úkol s názvem, popisem, prioritou, termínem a seznamem přiřazených osob. PATCH aktualizuje existující úkol. Vyžaduje task_id; ostatní pole jsou nepovinná. Pokud node HTTP nepodporuje PATCH, můžete odeslat body metodou POST. Přítomnost task_id přepne endpoint do režimu aktualizace.
Změna stavu z n8n probíhá stejnou cestou jako změna v aplikaci. Ve vlákně úkolu se objeví záznam „změnil(a) stav na…“, přiřazené osoby dostanou e-mail a Task Manager odešle task.status_changed (při stavu done také task.completed). Opětovné nastavení stejného stavu neodešle další událost. Neúspěšný webhook se zařadí do fronty. Fronta počítá s intervaly 60, 300 a 1800 sekund a maximálně čtyřmi pokusy, opakování ale provádí cron retry nebo zpracování fronty při některých požadavcích na aplikaci. Bez cronu a provozu v aplikaci k opakování v těchto intervalech nedojde. Chyba integrace neblokuje práci v programu.
Klíč funguje s oprávněními uživatele, který ho vytvořil, a s jeho přístupem k pracovním prostorům. users.php je dostupný pouze pro klíče globálního administrátora. Adresy webhooků v soukromých a rezervovaných rozsazích IP jsou blokovány; zásada n8n_private_network_policy má hodnoty off, admin a all, při neplatné hodnotě se použije off.
Co získáte?
Nemusíte přepisovat požadavek klienta z formuláře do úkolu. Ráno můžete začít pracovat na požadavku místo přenášení údajů mezi okny.
Nemusíte také pamatovat na aktualizaci dvou systémů po dokončení práce. Po uzavření úkolu se informace může předat dál prostřednictvím připraveného workflow. Klient nemusí čekat, až někdo změnu ručně zaznamená na druhé straně.
Váš tým se nemusí učit n8n, aby mohl používat hotovou integraci. Když se úkol uzavře prostřednictvím externího workflow, přiřazené osoby dostanou e-mail a ve vlákně se objeví záznam o změně. Výpadek integrace nezastaví práci na úkolech.
Příklad z každodenní práce
Servisní firma přijímá požadavky v externím ticketovacím systému. Workflow v n8n přijme nový ticket a odešle POST /api/n8n/tasks.php. Vznikne úkol s adresou v popisu, prioritou high a termínem v deadline_date - v pracovním prostoru, ke kterému má přístup vlastník klíče, a s těmi lidmi ze seznamu assignees, kteří k němu mají také přístup.
Když technik úkol uzavře, Task Manager odešle task.completed na webhook, u kterého je tato událost zaškrtnutá, a workflow aktualizuje stav v systému klienta. Samostatný webhook pro task.deadline_approaching (událost emituje opakující se úkol „deadline“, takže vyžaduje zapnutý cron) může spustit odeslání SMS připomínky blížícího se termínu. Technik nemusí n8n používat.
Nejčastější dotazy
Je integrace n8n součástí varianty Standard?
Ne, je to funkce varianty Pro. Ve Standardu přepínač integrace v Nastavení není, takže ji nelze zapnout.
Funguje integrace n8n hned po instalaci?
Ne. Jde o experimentální funkci, která je ve výchozím nastavení vypnutá. Administrátor ji zapne v Nastavení → Pokročilé → Ostatní. Do té doby je karta n8n skrytá a endpointy /api/n8n/* vracejí kód 503.
Vyžadují integrace programátora?
Při vytváření workflow v n8n se hodí technicky zdatný člověk. Je třeba zkopírovat adresu webhooku, zadat token a připravit JSON body. Používání hotového workflow tyto znalosti nevyžaduje.
Mohu změnit stav úkolu zvenčí?
Ano. Odešlete požadavek PATCH na /api/n8n/tasks.php s task_id a stavem none, in_progress, done nebo cancelled. Změna vyvolá záznam ve vlákně úkolu, e-mail přiřazeným osobám a odchozí webhook.
Co se stane, když n8n neodpovídá?
Neúspěšný webhook se zařadí do fronty. Fronta počítá s intervaly 60, 300 a 1800 sekund a maximálně čtyřmi pokusy, opakování ale provádí cron retry nebo zpracování fronty při některých požadavcích na aplikaci. Bez cronu a provozu v aplikaci k opakování v těchto intervalech nedojde. Chyba integrace neblokuje práci v programu.
Smaže vypnutí integrace konfiguraci?
Ne. Webhooky a klíče API zůstávají v databázi a po opětovném zapnutí integrace se znovu zpřístupní.