Experimentelle Funktion. Die n8n-Integration ist noch nicht vollständig getestet. Der Administrator aktiviert sie bewusst unter Einstellungen → Erweitert → Sonstiges; solange sie deaktiviert ist, sind der n8n-Reiter und dieses Kapitel der Anleitung ausgeblendet, und die Endpunkte /api/n8n/* sind inaktiv. Die n8n-Integration gehört zum Pro-Plan. Im Standard-Plan gibt es die Karte „Sonstiges" mit ihrem Schalter nicht, sodass die Integration nicht aktiviert werden kann.

Was ist n8n?

n8n ist eine Plattform zur Prozessautomatisierung. Die Integration mit Task Manager funktioniert in beide Richtungen:

  1. Ausgehende Webhooks (Task Manager → n8n) - die Anwendung sendet selbstständig Benachrichtigungen an Ihren Workflow in n8n, wenn etwas passiert (eine Aufgabe wurde erstellt, der Status geändert, eine Nachricht hinzugefügt, eine Frist naht usw.).
  2. Eingehende API (n8n → Task Manager) - n8n kann die Anwendung aufrufen, um Aufgaben zu erstellen, Nachrichten hinzuzufügen oder Daten abzurufen.

Aktivieren der Integration

Klicken Sie auf das Zahnrad-Symbol (⚙) → Registerkarte n8n. Die Registerkarte gliedert sich in zwei Teile: „Persönliche Automatisierungen" - Einstellungen, die nur Sie betreffen, und „Globale Automatisierungen" - systemweite Einstellungen, die für alle Benutzer gelten und nur für den Administrator sichtbar sind. Damit Ereignisse gesendet werden, muss der Administrator den Schalter „n8n-Integration aktivieren" im globalen Teil einschalten.

A. Ausgehende Webhooks - Benachrichtigungen von der Anwendung an n8n

Konfiguration

  1. Klicken Sie auf der Registerkarte n8n auf „Neuer Webhook“.
  2. Geben Sie den Namen des Webhooks sowie die aus n8n kopierte Webhook-URL ein (Node Webhook als Trigger, Methode POST).
  3. Markieren Sie die Ereignisse, die gesendet werden sollen.
  4. (Optional) legen Sie ein Geheimnis fest - die Anwendung signiert damit die Anfragen (HMAC), damit n8n die Echtheit überprüfen kann.
  5. Speichern. Sie können einen Test-Ping senden, um die Verbindung zu prüfen.

Verfügbare Ereignisse (Auswahl)

  • Aufgaben: task.created, task.updated, task.status_changed, task.completed, task.deleted, task.deadline_approaching, task.overdue
  • Chats / Nachrichten: chat.message_sent, chat.mention, chat.file_uploaded
  • Benutzer / Arbeitsbereich: user.created, user.login, user.logout, workspace.created
  • System: system.daily_summary, system.weekly_summary

Jede Anfrage an n8n enthält den Namen des Ereignisses sowie Daten (data) mit Kontext (z. B. Aufgaben-ID, Arbeitsbereich, Autor).

B. Eingehende API - n8n steuert die Anwendung

Konfiguration

  1. Klicken Sie auf der Registerkarte n8n auf „Neuer API-Schlüssel“.
  2. Kopieren Sie das generierte Token (wird nur einmal angezeigt).
  3. Verwenden Sie in n8n den Node HTTP Request mit dem Autorisierungsheader:
    Authorization: Bearer TWÓJ_TOKEN
    Die Aktionen werden im Kontext des Benutzers ausgeführt, der den Schlüssel erstellt hat (seine Berechtigungen und sein Zugriff auf Arbeitsbereiche).

Verfügbare Endpunkte

  • GET /api/n8n/ping.php - Token-Test und Healthcheck (gibt Informationen zum Schlüssel und Benutzer zurück).
  • GET /api/n8n/workspaces.php - Liste der verfügbaren Arbeitsbereiche.
  • GET /api/n8n/users.php - Liste der Benutzer (nur Schlüssel, die vom globalen Administrator erstellt wurden).
  • GET /api/n8n/tasks.php?workspace_id=&status=&limit= - Liste der Aufgaben.
  • POST /api/n8n/tasks.php - Erstellen einer Aufgabe. 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]
}
    Die Beschreibung wird genauso von gefährlichem HTML bereinigt wie in der Anwendung und unterliegt demselben Größenlimit.
  • PATCH /api/n8n/tasks.php - Aktualisierung einer bestehenden Aufgabe, u. a. Statusänderung. JSON-Body (task_id erforderlich, die restlichen Felder optional - geben Sie nur das an, was Sie ändern möchten):
    {
"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. Die Statusänderung funktioniert genau wie in der App: Im Aufgaben-Thread erscheint ein Eintrag wie „hat den Status geändert in …“, zugewiesene Personen erhalten eine E-Mail-Benachrichtigung und an n8n wird ein Webhook task.status_changed gesendet (sowie task.completed bei done).
    • deadline_date: null löscht den Termin. Eine Terminänderung verschiebt die daran geknüpften Erinnerungen.
    • Die übrigen Felder lösen den Webhook task.updated aus.
    • description wird genauso gespeichert wie bei der Bearbeitung im Aufgabenfenster: gefährliches HTML wird entfernt, bei aktivierter Verschlüsselung landet die Beschreibung verschlüsselt in der Datenbank, und die Häkchen in der To-do-Liste bleiben an ihren Positionen, auch wenn sich in der neuen Beschreibung die Reihenfolge der Positionen geändert hat. Die Aufgabe erhält die Kennzeichnung „(bearbeitet)“ nur, wenn sich der Titel oder der Inhalt der Beschreibung tatsächlich geändert hat.
    • Wenn die neue Beschreibung eine To-do-Liste entfernt, der jemand eigene Einträge hinzugefügt hat, wird nichts gespeichert (auch der Status aus derselben Anfrage nicht), und Sie erhalten 409 mit dem Code DOPISKI_BEZ_LISTY sowie dem Feld indeksy. Um die Liste trotzdem zusammen mit den Einträgen zu löschen, senden Sie dieselbe Änderung noch einmal mit dem Feld "usun_dopiski", das der Liste aus dem Feld indeksy entspricht.
    • Zuerst werden Titel, Fälligkeitsdatum, Priorität und Beschreibung gespeichert, erst danach der Status - eine Ablehnung beim Speichern der Beschreibung hinterlässt keinen geänderten Status.
    • Das erneute Setzen desselben Status sendet nichts (sicher bei Wiederholungen in n8n).
    • Wenn Ihr HTTP-Node die PATCH-Methode nicht unterstützt - senden Sie denselben Body per POST: Das Vorhandensein von task_id schaltet den Endpunkt in den Aktualisierungsmodus.
    • Fehlercodes: 400 fehlende task_id, keine zu ändernden Felder oder zu viele Positionen der To-do-Liste (TOO_MANY), 413 zu große Beschreibung (PAYLOAD_TOO_LARGE, meist ein eingefügtes Bild), 422 ungültiger Wert (Status/Priorität/Datumsformat), 404 Aufgabe existiert nicht oder liegt außerhalb des Zugriffs des Schlüssels, 403 keine Berechtigung zum Ändern des Status/zur Bearbeitung, 409 die Beschreibung entfernt eine Liste mit fremden Einträgen.
  • POST /api/n8n/messages.php - Hinzufügen einer Nachricht zu einer Aufgabe oder einem Chat. JSON-Body:
    {
"entity_type": "task",
"entity_id": 42,
"content": "Treść wiadomości"
}

Beispielhafte Automatisierungsszenarien

  • Google-Formular → n8n → POST /api/n8n/tasks.php (neue Aufgabe in Task Manager)
  • E-Mail aus Gmail mit bestimmtem Betreff → n8n → Aufgabe mit Beschreibung aus dem E-Mail-Inhalt
  • Statusänderung in Jira → n8n → Nachricht/Aktualisierung der verknüpften Aufgabe
  • Ausgehender Webhook task.created → n8n → Eintrag in Google Tabellen / Slack-Benachrichtigung
  • task.deadline_approaching → n8n → E-Mail-/SMS-Erinnerung an einen nahenden Termin

Fehlerbehebung

  • Keine Benachrichtigungen in n8n - prüfen Sie, ob die Integration aktiviert ist, der Webhook aktiv ist und die URL korrekt ist. Nutzen Sie den „Test-Ping“ und die Diagnose im n8n-Tab: Sie zeigt, ob die Webhook-Adresse antwortet (sie wird genauso geprüft wie beim Versand - ohne Weiterleitungen und mit Zertifikatsprüfung, daher erscheint n8n mit einem selbstsignierten Zertifikat als nicht erreichbar), wie viele Ereignisse in der Wiederholungswarteschlange warten und wann der letzte Versand erfolgreich war.
  • Das Webhook-Secret wird verschlüsselt in der Datenbank gespeichert. Nach Änderung des Schlüssels ENCRYPTION_KEY in config.php werden gespeicherte Secrets unlesbar - die Anwendung sendet dann Ereignisse ohne Signatur. Erzeugen Sie daher ein neues Secret beim Webhook und tragen Sie es in n8n ein.
  • Keine Autorisierung (401) bei der eingehenden API - der Token ist ungültig oder wurde gelöscht. Erstellen Sie einen neuen API-Schlüssel und aktualisieren Sie den Authorization-Header in n8n.
  • Die Aufgabe wird nicht erstellt - stellen Sie sicher, dass workspace_id existiert und der Benutzer des Schlüssels Zugriff darauf sowie die Berechtigung zum Hinzufügen von Aufgaben hat.