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.

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 selbst Benachrichtigungen an Ihren Workflow in n8n, wenn etwas passiert (eine Aufgabe wurde erstellt, der Status geändert, eine Nachricht hinzugefügt, ein Termin rückt näher 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 (⚙) → Reiter n8n. Der Reiter gliedert sich in zwei Teile: „Persönliche Automatisierungen" - Konfiguration, die nur Sie betrifft, sowie „Globale Automatisierungen" - Systemeinstellungen, die für alle Benutzer gemeinsam gelten, sichtbar nur für den Administrator. 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 im Reiter 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 Secret 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 im Reiter 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 (liefert 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]
}
  • PATCH /api/n8n/tasks.php — Aktualisierung einer bestehenden Aufgabe, u. a. Statusänderung. JSON-Body (task_id erforderlich, die übrigen Felder sind optional - Sie geben nur 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 Thread der Aufgabe erscheint der Eintrag „hat den Status geändert auf…", die zugewiesenen Personen erhalten eine E-Mail-Benachrichtigung, und an n8n wird der 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.
    • Das erneute Setzen desselben Status sendet nichts (sicher bei Wiederholungen in n8n).
    • Wenn Ihr HTTP-Node die Methode PATCH nicht unterstützt - senden Sie denselben Body per POST: Das Vorhandensein von task_id schaltet den Endpunkt in den Aktualisierungsmodus.
    • Fehlercodes: 400 task_id fehlt oder keine zu ändernden Felder, 422 ungültiger Wert (Status/Priorität/Datumsformat), 404 Aufgabe existiert nicht oder liegt außerhalb des Zugriffs des Schlüssels, 403 keine Berechtigung zur Status-/Bearbeitungsänderung.
  • 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, der Webhook aktiv und die URL korrekt ist. Verwenden Sie den „Test-Ping".
  • Keine Autorisierung (401) bei der eingehenden API - das Token ist ungültig oder wurde gelöscht. Erstellen Sie einen neuen API-Schlüssel und aktualisieren Sie den Header Authorization 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.