Experimentálna funkcia. Integrácia n8n ešte nie je plne otestovaná. Administrátor ju vedome zapína v Nastavenia → Rozšírené → Iné; kým je vypnutá, záložka n8n a táto kapitola návodu sú skryté a endpointy /api/n8n/* sú neaktívne.

Čo je n8n?

n8n je platforma na automatizáciu procesov. Integrácia s Task Manager funguje obojsmerne:

  1. Odchádzajúce webhooky (Task Manager → n8n) - aplikácia sama odosiela oznámenia do vášho workflow v n8n, keď sa niečo stane (vytvorila sa úloha, zmenil sa stav, pridala sa správa, blíži sa termín atď.).
  2. Prichádzajúce API (n8n → Task Manager) - n8n môže volať aplikáciu, aby vytváralo úlohy, pridávalo správy alebo získavalo dáta.

Zapnutie integrácie

Kliknite na ikonu ozubeného kolesa (⚙) → záložka n8n. Záložka sa delí na dve časti: „Osobné automatizácie" - konfigurácia týkajúca sa iba vás, a „Globálne automatizácie" - systémové nastavenia spoločné pre všetkých používateľov, viditeľné iba pre administrátora. Aby sa udalosti odosielali, administrátor musí zapnúť prepínač „Zapnúť integráciu n8n" v globálnej časti.

A. Odchádzajúce webhooky - oznámenia z aplikácie do n8n

Konfigurácia

  1. V záložke n8n kliknite na „Nový webhook".
  2. Zadajte názov webhooku a URL adresu webhooku skopírovanú z n8n (node Webhook ako trigger, metóda POST).
  3. Označte udalosti, ktoré sa majú odosielať.
  4. (Voliteľné) nastavte tajný kľúč - aplikácia ním podpíše požiadavky (HMAC), aby n8n mohol overiť pravosť.
  5. Uložte. Môžete odoslať testovací ping, aby ste overili pripojenie.

Dostupné udalosti (výber)

  • Úlohy: task.created, task.updated, task.status_changed, task.completed, task.deleted, task.deadline_approaching, task.overdue
  • Chaty / správy: chat.message_sent, chat.mention, chat.file_uploaded
  • Používatelia / pracovný priestor: user.created, user.login, user.logout, workspace.created
  • Systémové: system.daily_summary, system.weekly_summary

Každá požiadavka na n8n obsahuje názov udalosti a dáta (data) s kontextom (napr. id úlohy, pracovný priestor, autor).

B. Prichádzajúce API - n8n riadi aplikáciu

Konfigurácia

  1. V záložke n8n kliknite na „Nový API kľúč".
  2. Skopírujte vygenerovaný token (zobrazený iba raz).
  3. V n8n použite node HTTP Request s hlavičkou autorizácie:
    Authorization: Bearer TWÓJ_TOKEN
    Akcie sa vykonávajú v kontexte používateľa, ktorý vytvoril kľúč (jeho oprávnenia a prístup k pracovným priestorom).

Dostupné endpointy

  • GET /api/n8n/ping.php - test tokenu a healthcheck (vráti info o kľúči a používateľovi).
  • GET /api/n8n/workspaces.php - zoznam dostupných pracovných priestorov.
  • GET /api/n8n/users.php - zoznam používateľov (iba kľúče vytvorené globálnym administrátorom).
  • GET /api/n8n/tasks.php?workspace_id=&status=&limit= - zoznam úloh.
  • POST /api/n8n/tasks.php - vytvorenie úlohy. Telo JSON:
    {
"workspace_id": 1,
"subject": "Nowe zadanie z n8n",
"description": "Opcjonalny opis",
"priority": "high",
"deadline_date": "2025-12-31",
"status": "none",
"assignees": [2, 5]
}
  • PATCH /api/n8n/tasks.php — aktualizácia existujúcej úlohy, okrem iného zmena stavu. Body JSON (task_id povinné, zvyšné polia sú voliteľné - uvádzate iba to, čo chcete zmeniť):
    {
"task_id": 42,
"status": "in_progress",
"priority": "high",
"deadline_date": "2026-08-01",
"subject": "Nowy temat",
"description": "Nowy opis"
}
    • status: none | in_progress | done | cancelled. Zmena stavu funguje presne tak ako z aplikácie: vo vlákne úlohy sa zobrazí záznam „zmenil(a) stav na…", priradené osoby dostanú e-mailové upozornenie a do n8n odíde webhook task.status_changed (a task.completed pri done).
    • deadline_date: null vymaže termín. Zmena termínu presunie pripomienky pripnuté k nemu.
    • Ostatné polia odošlú webhook task.updated.
    • Nastavenie rovnakého stavu znova nič neodošle (bezpečné pri opakovaniach v n8n).
    • Ak váš node HTTP nepodporuje metódu PATCH - odošlite rovnaké telo cez POST: prítomnosť task_id prepne endpoint do režimu aktualizácie.
    • Chybové kódy: 400 chýba task_id alebo chýbajú polia na zmenu, 422 neplatná hodnota (stav/priorita/formát dátumu), 404 úloha neexistuje alebo je mimo dosahu kľúča, 403 chýba oprávnenie na zmenu stavu/úpravu.
  • POST /api/n8n/messages.php - pridanie správy do úlohy alebo chatu. Telo JSON:
    {
"entity_type": "task",
"entity_id": 42,
"content": "Treść wiadomości"
}

Príklady scenárov automatizácie

  • Formulár Google → n8n → POST /api/n8n/tasks.php (nová úloha v Task Manager)
  • E-mail z Gmailu s určeným predmetom → n8n → úloha s popisom z obsahu e-mailu
  • Zmena stavu v Jire → n8n → správa/aktualizácia súvisiacej úlohy
  • Odchádzajúci webhook task.created → n8n → záznam v tabuľke Google / oznámenie na Slacku
  • task.deadline_approaching → n8n → pripomienka e-mailom/SMS o blížiacom sa termíne

Riešenie problémov

  • Žiadne oznámenia v n8n - skontrolujte, či je integrácia zapnutá, webhook aktívny a URL správna. Použite „testovací ping".
  • Chýbajúca autorizácia (401) v prichádzajúcom API - token je neplatný alebo bol vymazaný. Vytvorte nový API kľúč a aktualizujte hlavičku Authorization v n8n.
  • Úloha sa nevytvorí - uistite sa, že workspace_id existuje a že používateľ kľúča má k nemu prístup a oprávnenie na pridávanie úloh.