Kísérleti funkció. Az n8n-integráció még nincs teljesen letesztelve. A rendszergazda tudatosan kapcsolja be a Beállítások → Speciális → Egyéb menüben; amíg ki van kapcsolva, az n8n fül és az útmutató e fejezete rejtve van, a /api/n8n/* végpontok pedig nem aktívak.

Mi az n8n?

Az n8n egy folyamatautomatizálási platform. A Task Managerrel való integráció kétirányúan működik:

  1. Kimenő webhookok (Task Manager → n8n) - az alkalmazás magától küld értesítéseket az n8n workflow-dnak, amikor valami történik (feladat jött létre, állapot változott, üzenet érkezett, közeleg a határidő stb.).
  2. Bejövő API (n8n → Task Manager) - az n8n hívhatja az alkalmazást feladatok létrehozásához, üzenetek hozzáadásához vagy adatok lekéréséhez.

Az integráció bekapcsolása

Kattints a fogaskerék ikonra (⚙) → n8n fül. A fül két részre oszlik: „Személyes automatizálások" - a kizárólag rád vonatkozó beállítások, és „Globális automatizálások" - az összes felhasználó számára közös rendszerbeállítások, amelyek csak a rendszergazda számára láthatók. Ahhoz, hogy az események kiküldésre kerüljenek, a rendszergazdának be kell kapcsolnia az „n8n-integráció bekapcsolása" kapcsolót a globális részben.

A. Kimenő webhookok - értesítések az alkalmazásból az n8n felé

Beállítás

  1. Az n8n fülön kattints az „Új webhook" gombra.
  2. Add meg a webhook nevét és az n8n-ből másolt webhook URL-t (a Webhook node mint trigger, POST metódus).
  3. Jelöld be a küldendő eseményeket.
  4. (Opcionálisan) állíts be egy titkos kulcsot - az alkalmazás ezzel írja alá a kéréseket (HMAC), hogy az n8n ellenőrizhesse a hitelességet.
  5. Mentsd el. Küldhetsz egy teszt pinget a kapcsolat ellenőrzéséhez.

Elérhető események (válogatás)

  • Feladatok: task.created, task.updated, task.status_changed, task.completed, task.deleted, task.deadline_approaching, task.overdue
  • Csevegések / üzenetek: chat.message_sent, chat.mention, chat.file_uploaded
  • Felhasználók / munkaterület: user.created, user.login, user.logout, workspace.created
  • Rendszer: system.daily_summary, system.weekly_summary

Minden n8n-hez küldött kérés tartalmazza az esemény nevét és a kontextussal ellátott adatokat (data) (pl. feladatazonosító, munkaterület, szerző).

B. Bejövő API - az n8n vezérli az alkalmazást

Beállítás

  1. Az n8n fülön kattints az „Új API-kulcs" gombra.
  2. Másold ki a generált tokent (csak egyszer jelenik meg).
  3. Az n8n-ben használd a HTTP Request node-ot az autorizációs fejléccel:
    Authorization: Bearer TWÓJ_TOKEN
    A műveletek annak a felhasználónak a kontextusában futnak, aki létrehozta a kulcsot (az ő jogosultságai és munkaterület-hozzáférése alapján).

Elérhető végpontok

  • GET /api/n8n/ping.php - token teszt és healthcheck (a kulcsra és a felhasználóra vonatkozó adatokat adja vissza).
  • GET /api/n8n/workspaces.php - az elérhető munkaterületek listája.
  • GET /api/n8n/users.php - a felhasználók listája (csak a globális rendszergazda által létrehozott kulcsokkal).
  • GET /api/n8n/tasks.php?workspace_id=&status=&limit= - feladatok listája.
  • POST /api/n8n/tasks.php - feladat létrehozása. JSON body:
    {
"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 — meglévő feladat frissítése, többek között az állapot módosítása. JSON body (task_id kötelező, a többi mező opcionális - csak azt add meg, amit módosítani szeretnél):
    {
"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. Az állapot módosítása pontosan úgy működik, mint az alkalmazásban: a feladat beszélgetésszálában megjelenik egy bejegyzés „állapotot módosított erre…", a hozzárendelt személyek e-mail értesítést kapnak, az n8n felé pedig elindul a task.status_changed webhook (valamint done esetén a task.completed is).
    • deadline_date: null törli a határidőt. A határidő módosítása áthelyezi a hozzá kapcsolt emlékeztetőket.
    • A többi mező a task.updated webhookot küldi ki.
    • Ugyanannak az állapotnak az ismételt beállítása semmit nem küld ki (biztonságos az n8n-beli ismétlések esetén).
    • Ha a HTTP node-od nem támogatja a PATCH metódust - küldd ugyanazt a bodyt POST-tal: a task_id jelenléte frissítési módba kapcsolja az endpointot.
    • Hibakódok: 400 hiányzó task_id vagy nincs mit módosítani, 422 érvénytelen érték (állapot/prioritás/dátumformátum), 404 a feladat nem létezik vagy a kulcs hozzáférésén kívül esik, 403 nincs jogosultság az állapot módosításához/szerkesztéshez.
  • POST /api/n8n/messages.php - üzenet hozzáadása feladathoz vagy csevegéshez. JSON body:
    {
"entity_type": "task",
"entity_id": 42,
"content": "Treść wiadomości"
}

Példák automatizálási forgatókönyvekre

  • Google Űrlap → n8n → POST /api/n8n/tasks.php (új feladat a Task Managerben)
  • Gmail-e-mail meghatározott tárggyal → n8n → feladat, amelynek leírása az e-mail tartalmából származik
  • Állapotváltozás a Jirában → n8n → üzenet / a kapcsolódó feladat frissítése
  • Kimenő task.created webhook → n8n → bejegyzés a Google Táblázatban / Slack-értesítés
  • task.deadline_approaching → n8n → e-mail/SMS emlékeztető a közelgő határidőről

Hibaelhárítás

  • Nincsenek értesítések az n8n-ben - ellenőrizd, hogy az integráció be van-e kapcsolva, a webhook aktív-e, és az URL helyes-e. Használd a „teszt pinget".
  • Nincs jogosultság (401) a bejövő API-ban - a token érvénytelen vagy törölve lett. Hozz létre új API-kulcsot, és frissítsd az Authorization fejlécet az n8n-ben.
  • A feladat nem jön létre - győződj meg róla, hogy a workspace_id létezik, és a kulcs felhasználójának van hozzáférése hozzá, valamint jogosultsága feladatok hozzáadásához.