Experimentální funkce. Integrace n8n ještě není plně otestovaná. Administrátor ji vědomě zapíná v Nastavení → Pokročilé → Ostatní; dokud je vypnutá, záložka n8n a tato kapitola návodu jsou skryté a endpointy /api/n8n/* jsou neaktivní.

Co je n8n?

n8n je platforma pro automatizaci procesů. Integrace s Task Managerem funguje oběma směry:

  1. Odchozí webhooky (Task Manager → n8n) - aplikace sama odesílá oznámení do vašeho workflow v n8n, když se něco stane (vytvořen úkol, změněn stav, přidána zpráva, blíží se termín atd.).
  2. Příchozí API (n8n → Task Manager) - n8n může volat aplikaci, aby vytvořila úkoly, přidala zprávy nebo stáhla data.

Zapnutí integrace

Klikněte na ikonu ozubeného kola (⚙) → záložka n8n. Záložka se dělí na dvě části: „Osobní automatizace" - nastavení týkající se pouze vás, a „Globální automatizace" - systémová nastavení společná pro všechny uživatele, viditelná pouze administrátorovi. Aby se události odesílaly, musí administrátor zapnout přepínač „Zapnout integraci n8n" v globální části.

A. Odchozí webhooky - oznámení z aplikace do n8n

Nastavení

  1. V záložce n8n klikněte na „Nový webhook".
  2. Zadejte název webhooku a URL adresu webhooku zkopírovanou z n8n (node Webhook jako trigger, metoda POST).
  3. Zaškrtněte události, které se mají odesílat.
  4. (Volitelně) nastavte tajný klíč - aplikace jím podepíše požadavky (HMAC), aby n8n mohl ověřit pravost.
  5. Uložte. Můžete odeslat testovací ping, abyste ověřili připojení.

Dostupné události (výběr)

  • Úkoly: task.created, task.updated, task.status_changed, task.completed, task.deleted, task.deadline_approaching, task.overdue
  • Chaty / zprávy: chat.message_sent, chat.mention, chat.file_uploaded
  • Uživatelé / pracovní prostor: user.created, user.login, user.logout, workspace.created
  • Systémové: system.daily_summary, system.weekly_summary

Každý požadavek do n8n obsahuje název události a data (data) s kontextem (např. id úkolu, pracovní prostor, autor).

B. Příchozí API - n8n ovládá aplikaci

Nastavení

  1. V záložce n8n klikněte na „Nový API klíč".
  2. Zkopírujte vygenerovaný token (zobrazí se pouze jednou).
  3. V n8n použijte node HTTP Request s autorizační hlavičkou:
    Authorization: Bearer TWÓJ_TOKEN
    Akce se provádějí v kontextu uživatele, který klíč vytvořil (jeho oprávnění a přístup k pracovním prostorům).

Dostupné endpointy

  • GET /api/n8n/ping.php - test tokenu a healthcheck (vrací info o klíči a uživateli).
  • GET /api/n8n/workspaces.php - seznam dostupných pracovních prostorů.
  • GET /api/n8n/users.php - seznam uživatelů (pouze klíče vytvořené globálním administrátorem).
  • GET /api/n8n/tasks.php?workspace_id=&status=&limit= - seznam úkolů.
  • POST /api/n8n/tasks.php - vytvoření úkolu. Tělo 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 — aktualizace existujícího úkolu, mj. změna stavu. Tělo JSON (task_id povinné, ostatní pole jsou volitelná - uvádíte pouze to, co chcete změnit):
    {
"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. Změna stavu funguje přesně stejně jako z aplikace: ve vlákně úkolu se objeví záznam „změnil(a) stav na…", přiřazené osoby dostanou e-mailové upozornění a do n8n se odešle webhook task.status_changed (a task.completed při done).
    • deadline_date: null vymaže termín. Změna termínu posune připomenutí k němu připnutá.
    • Ostatní pole odesílají webhook task.updated.
    • Nastavení stejného stavu znovu nic neodešle (bezpečné při opakování v n8n).
    • Pokud váš HTTP node nepodporuje metodu PATCH - odešlete stejné tělo přes POST: přítomnost task_id přepne endpoint do režimu aktualizace.
    • Chybové kódy: 400 chybí task_id nebo chybí pole ke změně, 422 neplatná hodnota (stav/priorita/formát data), 404 úkol neexistuje nebo je mimo dosah klíče, 403 chybí oprávnění ke změně stavu/úpravě.
  • POST /api/n8n/messages.php - přidání zprávy do úkolu nebo chatu. Tělo JSON:
    {
"entity_type": "task",
"entity_id": 42,
"content": "Treść wiadomości"
}

Příklady automatizačních scénářů

  • Formulář Google → n8n → POST /api/n8n/tasks.php (nový úkol v Task Manageru)
  • E-mail z Gmailu s určeným předmětem → n8n → úkol s popisem z obsahu e-mailu
  • Změna stavu v Jira → n8n → zpráva/aktualizace souvisejícího úkolu
  • Odchozí webhook task.created → n8n → záznam v tabulce Google / oznámení na Slack
  • task.deadline_approaching → n8n → e-mailové/SMS připomenutí blížícího se termínu

Řešení problémů

  • Chybí oznámení v n8n - zkontrolujte, zda je integrace zapnutá, webhook aktivní a URL správná. Použijte „testovací ping".
  • Chybí autorizace (401) v příchozím API - token je neplatný nebo byl smazán. Vytvořte nový API klíč a aktualizujte hlavičku Authorization v n8n.
  • Úkol se nevytvoří - ujistěte se, že workspace_id existuje a že uživatel klíče k němu má přístup a oprávnění přidávat úkoly.