Vad är n8n-integrationen i Task Manager?
n8n-integrationen i Task Manager överför data mellan uppgifter och andra system. Ett formulärärende kan bli en uppgift utan att du behöver skriva in det igen. När en uppgift skapas kan en rad läggas till i ett Google-kalkylblad eller ett meddelande skickas till Slack. Teamet arbetar som vanligt i Task Manager.
n8n-integrationen tillhör Pro-varianten. Det är en experimentell funktion som är avstängd som standard. Administratören aktiverar den under Inställningar → Avancerat → Övrigt. När den är avstängd visas inte n8n-fliken i gränssnittet, och endpointerna /api/n8n/* avvisar förfrågningar med koden 503. Avsnittet om n8n i manualen försvinner då också från AI-assistentens kontext.
n8n är en separat plattform för att skapa flöden mellan applikationer. Task Manager skickar händelser till plattformen och tar emot anrop tillbaka.
Hur fungerar det?
Data skickas från Task Manager till n8n via en webhook. Du anger dess namn och URL:en från en *Webhook*-nod i n8n och väljer händelser. Du kan också lägga till en hemlighet för att signera begäranden (HMAC). Du kan välja mellan 26 händelser, bland annat task.created, task.status_changed, task.completed och chat.message_sent. Systemhändelser (system.daily_summary och övriga system.*) samt user.created skickas dock endast till globala webhooks som administratören har skapat. Varje begäran innehåller händelsens namn, en tidsstämpel och kontextdata. Du kan skicka en testping innan du bygger hela flödet.
I motsatt riktning används en API-nyckel. Token i formatet tm_live_<32hex> visas bara en gång. I n8n anger du den i headern Authorization: Bearer. Tillgängliga endpoints är ping.php, workspaces.php, users.php, tasks.php och messages.php. POST /api/n8n/tasks.php skapar en uppgift med ämne, beskrivning, prioritet, förfallodatum och en lista över tilldelade personer. PATCH uppdaterar en befintlig uppgift. task_id krävs; övriga fält är valfria. Om HTTP-noden inte stöder PATCH kan du skicka bodyn med POST. När task_id finns växlar endpointen till uppdateringsläge.
En statusändring från n8n följer samma flöde som en ändring i appen. I uppgiftens tråd visas ett inlägg om att statusen har ändrats, de tilldelade personerna får ett e-postmeddelande och Task Manager skickar task.status_changed (vid done även task.completed). Om samma status anges igen skickas ingen ny händelse. En misslyckad webhook läggs i kön. Kön har intervallen 60, 300 och 1800 sekunder och högst fyra försök, men återförsöken utförs av cron-jobbet retry eller av köhanteringen vid vissa förfrågningar till appen. Utan cron-jobbet och aktivitet i appen görs inga återförsök med dessa intervall. Ett integrationsfel hindrar inte arbetet i programmet.
Nyckeln har samma behörigheter som användaren som skapade den och tillgång till användarens arbetsytor. users.php är endast tillgänglig för globala administratörsnycklar. Webhookadresser i privata och reserverade IP-intervall blockeras. Policyn n8n_private_network_policy kan ha värdena off, admin och all. Om värdet är felaktigt fungerar den som off.
Vad vinner du?
Du behöver inte kopiera kundens ärende från formuläret till en uppgift. På morgonen kan du börja arbeta med ärendet i stället för att flytta information mellan fönster.
Du behöver inte heller komma ihåg att uppdatera två system när arbetet är klart. När en uppgift stängs kan informationen skickas vidare genom ett förberett flöde. Kunden behöver inte vänta på att någon manuellt registrerar ändringen i det andra systemet.
Ditt team behöver inte lära sig n8n för att använda den färdiga integrationen. När en uppgift stängs via ett externt flöde får de tilldelade personerna ett e-postmeddelande och ett inlägg om ändringen visas i tråden. Ett integrationsfel stoppar inte arbetet med uppgifterna.
Exempel från vardagen
Ett serviceföretag tar emot ärenden i ett externt ärendehanteringssystem. Ett flöde i n8n tar emot ett nytt ärende och skickar POST /api/n8n/tasks.php. En uppgift skapas med adressen i beskrivningen, prioriteten high och förfallodatumet i deadline_date - på den arbetsyta som nyckelägaren har tillgång till och med de personer i listan assignees som också har tillgång till den.
När teknikern slutför uppgiften skickar Task Manager task.completed till en webhook som har markerat den här händelsen, och flödet uppdaterar statusen i kundens system. En separat webhook för task.deadline_approaching (händelsen skickas av den återkommande uppgiften ”deadline”, så cron måste vara aktiverat) kan starta ett flöde som skickar en SMS-påminnelse om att förfallodatumet närmar sig. Teknikern behöver inte använda n8n.
Vanliga frågor
Ingår n8n-integrationen i Standard-varianten?
Nej, det är en funktion i Pro-varianten. I Standard finns det ingen reglage för integrationen i Inställningar, så den går inte att aktivera.
Fungerar n8n-integrationen direkt efter installationen?
Nej. Funktionen är experimentell och avstängd som standard. En administratör aktiverar den under Inställningar → Avancerat → Övrigt. Fram till dess är fliken n8n dold och endpointsen /api/n8n/* returnerar statuskod 503.
Kräver integrationerna en utvecklare?
Det är bra att ha någon med teknisk kompetens när du bygger ett flöde i n8n. Du behöver kopiera webhookadressen, ange en token och förbereda en JSON-body. Du behöver inte den kunskapen för att använda ett färdigt flöde.
Kan jag ändra status för en uppgift utifrån?
Ja. Skicka en PATCH-förfrågan till /api/n8n/tasks.php med task_id och statusen none, in_progress, done eller cancelled. Ändringen skapar ett inlägg i uppgiftens tråd, skickar e-post till de tilldelade personerna och utlöser en utgående webhook.
Vad händer när n8n inte svarar?
En misslyckad webhook läggs i kön. Kön har intervallen 60, 300 och 1800 sekunder och högst fyra försök, men återförsöken utförs av cron-jobbet retry eller av köhanteringen vid vissa förfrågningar till appen. Utan cron-jobbet och aktivitet i appen görs inga återförsök med dessa intervall. Ett integrationsfel hindrar inte arbetet i programmet.
Raderas konfigurationen om jag inaktiverar integrationen?
Nej. Webhookar och API-nycklar finns kvar i databasen och återkommer när integrationen aktiveras igen.