Mi az n8n-integráció a Task Managerben?
A Task Manager n8n-integrációja adatokat mozgat a feladatok és más rendszerek között. Egy űrlapon beérkező jelentésből átírás nélkül feladat lehet. Egy feladat létrehozása Google-táblázatba írt bejegyzést vagy Slack-értesítést indíthat el. A csapat a megszokott módon dolgozhat a Task Managerben.
Az n8n-integráció a Pro csomag része. Ez egy kísérleti funkció, amely alapértelmezetten ki van kapcsolva. Az adminisztrátor a Beállítások → Speciális → Egyéb menüben kapcsolhatja be. Ha ki van kapcsolva, az n8n fül nem jelenik meg a felületen, a /api/n8n/* végpontok pedig 503-as kóddal utasítják el a kéréseket. Az n8n-ről szóló fejezet ilyenkor az AI-asszisztens kontextusából is eltűnik.
Az n8n külön platform alkalmazások közötti folyamatok létrehozására. A Task Manager eseményeket küld neki, és fogadja az onnan érkező hívásokat.
Hogyan működik?
A Task Managerből webhookon keresztül kerülnek adatok az n8n-be. Add meg a nevét, az n8n *Webhook* node-jának URL-címét, és válaszd ki az eseményeket. A kérések aláírásához titkot is megadhatsz (HMAC). Összesen 26 esemény közül választhatsz, többek között task.created, task.status_changed, task.completed és chat.message_sent. A rendszeresemények (system.daily_summary és a többi system.*), valamint a user.created esemény kizárólag az adminisztrátor által létrehozott globális webhookokra érkeznek. Minden kérés tartalmazza az esemény nevét, az időbélyeget és a kontextuális adatokat. A teljes folyamat felépítése előtt teszt pinget küldhetsz.
A visszafelé irányuló kommunikációhoz API-kulcs használható. A tm_live_<32hex> formátumú token csak egyszer jelenik meg. Az n8n-ben az Authorization: Bearer fejlécben kell megadnod. Az elérhető végpontok: ping.php, workspaces.php, users.php, tasks.php és messages.php. A POST /api/n8n/tasks.php létrehoz egy feladatot, amelyhez megadható a téma, a leírás, a prioritás, a határidő és a hozzárendelt személyek listája. A PATCH meglévő feladatot frissít. Ehhez szükséges a task_id; a többi mező megadása opcionális. Ha a HTTP node nem támogatja a PATCH metódust, a body-t POST-tal is elküldheted. A task_id jelenléte frissítési módra állítja a végpontot.
Az n8n-ből érkező állapotmódosítás ugyanazon az útvonalon halad végig, mint az alkalmazásban végzett módosítás. A Feladat beszélgetésszálában megjelenik egy „megváltoztatta az állapotot erre: …” bejegyzés, a hozzárendelt személyek e-mailt kapnak, a Task Manager pedig elküldi a task.status_changed eseményt (done esetén a task.completed eseményt is). Ugyanannak az állapotnak az újbóli beállítása nem küld újabb eseményt. A sikertelen webhook a várólistára kerül. A várólista 60, 300 és 1800 másodperces időközökkel, legfeljebb négy próbálkozással számol, az újrapróbálkozást azonban a retry cron vagy az alkalmazás egyes kéréseihez kapcsolódó várólistakezelés hajtja végre. Cron és az alkalmazás forgalma nélkül az újrapróbálkozás nem ezekben az időközökben történik. Az integráció hibája nem akadályozza a program használatát.
A kulcs az azt létrehozó felhasználó jogosultságaival és a Munkaterületekhez való hozzáférésével működik. A users.php kizárólag globális rendszergazdai kulcsokkal érhető el. A privát és fenntartott IP-címtartományokban található webhookcímek blokkolva vannak; az n8n_private_network_policy szabályzat értéke off, admin vagy all lehet, hibás érték esetén pedig off szerint működik.
Mit nyersz vele?
Nem kell az ügyfél űrlapon beküldött bejelentését feladatba átmásolnod. Reggel rögtön a bejelentésen való munkával kezdhetsz, ahelyett hogy az adatok ablakok közötti átvitelével foglalkoznál.
A munka befejezése után arra sem kell emlékezned, hogy két rendszert is frissíts. Amikor lezárul egy feladat, az információ az előkészített folyamaton keresztül továbbítható. Az ügyfélnek nem kell megvárnia, hogy valaki manuálisan rögzítse a változást a másik rendszerben.
A csapatodnak nem kell megtanulnia az n8n használatát ahhoz, hogy igénybe vegye az előre elkészített integrációt. Ha egy külső folyamat lezár egy feladatot, a hozzárendelt személyek e-mailt kapnak, a beszélgetésszálban pedig megjelenik a módosításról szóló bejegyzés. Az integráció hibája nem állítja le a feladatokon végzett munkát.
Példa a mindennapi munkából
Egy szervizcég külső jegykezelő rendszerben fogadja a bejelentéseket. Az n8n-folyamat fogadja az új jegyet, és elküldi a POST /api/n8n/tasks.php kérést. Létrejön egy feladat a leírásban szereplő címmel, high prioritással és a deadline_date mezőben megadott határidővel - azon a Munkaterületen, amelyhez a kulcs tulajdonosa hozzáfér, valamint az assignees listán szereplő azon személyekkel, akik szintén hozzáférnek.
Amikor a technikus lezár egy Feladatot, a Task Manager elküldi a task.completed eseményt annak a webhooknak, amelynél ez az esemény be van jelölve, a folyamat pedig frissíti az állapotot az ügyfél rendszerében. Egy külön, task.deadline_approaching eseményre beállított webhook - ezt a „deadline” nevű ismétlődő Feladat bocsátja ki, ezért bekapcsolt cron szükséges hozzá - emlékeztető SMS-t küldhet a közelgő határidőről. A technikusnak nem kell n8n-t használnia.
Gyakori kérdések
Az n8n-integráció a Standard csomagban is elérhető?
Nem, ez a Pro csomag funkciója. A Standardban nincs integráció-kapcsoló a Beállításokban, így nem lehet bekapcsolni.
Az n8n-integráció közvetlenül a telepítés után működik?
Nem. Ez egy kísérleti funkció, amely alapértelmezés szerint ki van kapcsolva. A rendszergazda a Beállítások → Speciális → Egyéb menüpontban kapcsolhatja be. Addig az n8n lap rejtve marad, a /api/n8n/* végpontok pedig 503-as kódot adnak vissza.
Az integrációkhoz programozó kell?
Az n8n-folyamat összeállításához jól jön egy technikai szakember segítsége. Le kell másolni a webhook címét, meg kell adni egy tokent, és elő kell készíteni a JSON body-t. Egy kész folyamat használatához nincs szükség ilyen ismeretekre.
Kívülről is megváltoztathatom egy feladat állapotát?
Igen. Küldj PATCH-kérést a /api/n8n/tasks.php címre a task_id mezővel és a none, in_progress, done vagy cancelled állapottal. A módosítás bejegyzést hoz létre a feladat beszélgetésszálában, e-mailt küld a hozzárendelt személyeknek, és elindítja a kimenő webhookot.
Mi történik, ha az n8n nem válaszol?
A sikertelen webhook a várólistára kerül. A várólista 60, 300 és 1800 másodperces időközökkel és legfeljebb négy próbálkozással számol, de az újrapróbálkozásokat a retry cron vagy az alkalmazáshoz érkező egyes kérések során végzett várólistakezelés hajtja végre. Cron és az alkalmazás forgalma nélkül az újrapróbálkozás nem történik meg ezekkel az időközökkel. Az integráció hibája nem akadályozza a program használatát.
Az integráció kikapcsolásakor törlődik a konfiguráció?
Nem. A webhookok és az API-kulcsok az adatbázisban maradnak, és az integráció újbóli bekapcsolásakor ismét használhatók.