PKR-Lab

40040 - Planung: Zammad-Kalendereinladung → n8n → Nextcloud-Kalender (+ iOS-Sync)

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/4-planung/40040-zammad-kalender-n8n-nextcloud-ios-sync.md

Planung: Zammad-Kalendereinladung → n8n → Nextcloud-Kalender (+ iOS-Sync)

Ziel: Kommt an [email protected] eine Kalendereinladung (E-Mail mit
.ics-Anhang) an und landet dadurch als Ticket in Zammad, soll n8n den
Termin automatisch in einen Nextcloud-Kalender eintragen — ohne manuellen
Zwischenschritt. Von dort soll der Termin auch auf dem iPhone erscheinen.

Ergebnis vorweg: Technisch sind das zwei getrennte Bausteine, kein
einzelner "in beide eintragen"-Schritt: n8n schreibt nur nach Nextcloud
(per CalDAV). Das iPhone bekommt den Termin passiv, weil es als
CalDAV-Account mit genau diesem Nextcloud-Kalender verbunden ist — iOS
synct dann automatisch, ganz ohne dass n8n oder sonst etwas aktiv auf das
Telefon schreibt (das geht serverseitig auch gar nicht; siehe unten). Die
iPhone-Anbindung ist deshalb ein einmaliger, manueller Setup-Schritt
auf dem Gerät, keine wiederkehrende Automatisierung.


Offene Vorfrage, vor der Umsetzung zu klären

[email protected] läuft über welche Zammad-Instanz? Im Repo sind
laut 30070-n8n.md zwei bekannt:

Instanz Erreichbar unter Bereits n8n-Credential vorhanden?
Interne Instanz (dieses Repo) zammad.homeserver nein, müsste neu angelegt werden
Externe Instanz (bereits an n8n angebunden) https://ticket.emue365.de ja — Credential „Zammad ticket.emue365" (Zammad Basic Auth API)

Der Domainname edv-kretzer.de passt zu keiner der beiden 1:1 — welche
Instanz den E-Mail-Kanal für dieses Postfach führt (oder ob er neu
eingerichtet werden muss), lässt sich aus dem Repo nicht ableiten. Die
Architektur unten funktioniert für beide identisch (nur Basis-URL +
Credential im n8n-Workflow ändern sich), aber Gruppe und
Trigger-Bedingung in Zammad müssen auf die richtige Instanz gesetzt
werden, bevor Baustein 3 umgesetzt wird.


Architektur (Zielbild)

E-Mail an [email protected] (Terminanfrage/-einladung, .ics-Anhang)
        │
        ▼
Zammad E-Mail-Channel → neues Ticket
        │
        ▼
Zammad-Trigger  (Bedingung: Gruppe = <Ziel-Postfach-Gruppe>,
                 Artikel-Typ = email, "Ticket neu erstellt")
        │  Aktion: Webhook → n8n
        ▼
n8n-Workflow  (Webhook-Trigger)
  ├─ Zammad-Node „Ticket: Get"        → volles Ticket inkl. articles/attachments
  ├─ Code-Node „Anhänge filtern"      → sucht Attachment mit .ics-Endung /
  │                                      Content-Type text/calendar
  │        kein Treffer → Workflow endet hier (kein Termin, normales Ticket
  │        bleibt unangetastet)
  ├─ HTTP-Request-Node „CalDAV PUT"   → schreibt die Original-.ics-Datei
  │                                      unverändert in den Nextcloud-Kalender
  ├─ Zammad-Node „Ticket: Update"     → interne Notiz "Termin übernommen",
  │                                      optional Status-Wechsel
  └─ ntfy-Node                        → Push-Bestätigung (oder Fehler-Push)

Nextcloud-Kalender (CalDAV)
        │   passiver Sync — kein weiterer Automatisierungsschritt nötig
        ▼
iPhone „Kalender"-App — einmalig als CalDAV-Account mit Nextcloud verbunden

Warum "iOS-Kalender" kein eigener Workflow-Schritt ist

Es gibt keine Server-API, mit der n8n (oder irgendein Dienst) direkt in
die Kalender-App eines bestimmten iPhones schreiben kann — Apple erlaubt
das nur lokal auf dem Gerät selbst (EventKit, braucht eine installierte
App) oder indirekt über ein Protokoll, das iOS nativ unterstützt:
CalDAV. Nextcloud spricht CalDAV bereits nativ. Der einzig
realistische Weg ist daher: n8n schreibt den Termin einmal nach Nextcloud,
das iPhone ist dauerhaft als CalDAV-Client an denselben Kalender
angebunden und holt sich neue Termine automatisch — technisch identisch
zu "ich trage den Termin von Hand in der Nextcloud-Kalender-Web-UI ein und
er erscheint auf dem iPhone", nur dass n8n das Eintragen übernimmt.

Alternative (nicht empfohlen): die .ics-Datei per E-Mail an eine mit dem
iPhone verknüpfte Adresse weiterleiten — iOS Mail erkennt .ics-Anhänge
und bietet "Zum Kalender hinzufügen" an. Das bräuchte aber weiterhin einen
manuellen Tap pro Termin und wäre damit keine vollautomatische Lösung wie
gefordert — deshalb hier verworfen.


Baustein 1 — Nextcloud: Kalender-App + CalDAV-Zugang

  1. Kalender-App aktivieren (falls noch nicht geschehen): Nextcloud →
    Apps → Büro & Text → "Kalender" installieren/aktivieren. Nicht im
    Repo-Doc 300b0-nextcloud.md
    als bereits aktiv dokumentiert — vor der Umsetzung prüfen.
  2. Zielkalender anlegen, z. B. „Termine EDV Kretzer" — eigener
    Kalender statt des Standard-Kalenders, damit sich die Termine sauber
    trennen und das iPhone gezielt nur diesen einen abonnieren kann.
  3. CalDAV-URL notieren:
    https://nextcloud-prod.pke-lab.de/remote.php/dav/calendars/<nutzername>/<kalender-uri>/
    (extern, für iPhone) bzw. intern für n8n direkt über den
    Cluster-Service http://nextcloud.nextcloud.svc.cluster.local/remote.php/dav/calendars/<nutzername>/<kalender-uri>/
    — analog zum bestehenden Muster interner Service-Calls in
    30070-n8n.md (Ollama-Beispiel).
  4. App-Passwort für n8n erzeugen: Nextcloud → Einstellungen →
    Sicherheit → „Neues App-Passwort erzeugen" — nicht das echte
    Account-Passwort im n8n-Credential hinterlegen, ein separates
    App-Passwort lässt sich unabhängig widerrufen.

Baustein 2 — iPhone: Kalender abonnieren (einmalig, manuell)

  1. Einstellungen → Kalender → Accounts → Account hinzufügen → Andere →
    CalDAV-Account.
  2. Server: nextcloud-prod.pke-lab.de (öffentlich über Cloudflare Tunnel
    erreichbar, siehe
    300b0-nextcloud.md —
    funktioniert damit auch außerhalb von LAN/Tailscale).
  3. Benutzername + eigenes App-Passwort (separat von dem für n8n erzeugten,
    sauberer für Audit/Widerruf — beide erzeugt man in Baustein 1.4 nach
    demselben Muster).
  4. In den Kalender-Einstellungen des iPhones nur den Zielkalender aus
    Baustein 1.2 zum Sync auswählen, nicht alle Nextcloud-Kalender.

Baustein 3 — Zammad: Trigger für eingehende Kalendereinladungen


Baustein 4 — n8n-Workflow

Empfohlener Dateiname (passend zum bestehenden Muster importierbarer
Workflows unter argocd/apps/tech/n8n/workflows/, siehe
30070-n8n.md):
zammad-termin-zu-nextcloud.json

Node Zweck
Webhook (Trigger) empfängt den Zammad-Trigger-Call
Zammad-Node „Ticket: Get" lädt Ticket inkl. articles-Array (liefert die API automatisch mit, kein separater Attachment-Call nötig — bereits so beobachtet in den bestehenden externen-Zammad-Workflows)
Code-Node „Anhänge filtern" sucht Attachment mit .ics-Endung bzw. Content-Type: text/calendar; kein Treffer → Workflow endet (NoOp/IF)
HTTP-Request-Node „CalDAV PUT" PUT der unveränderten .ics-Bytes an <CalDAV-URL>/<UID-aus-ics>.ics, Basic Auth mit dem App-Passwort aus Baustein 1.4
Zammad-Node „Ticket: Update" interne Notiz „Termin automatisch in Nextcloud übernommen", optional Status auf „pending close"/„closed"
ntfy-Node Push-Bestätigung bzw. Fehler-Push, analog zum Muster in 30070-n8n.md

Idempotenz: Ein CalDAV-PUT auf dieselbe <UID>.ics-Resource
überschreibt den bestehenden Termin statt ihn zu duplizieren — die UID
kommt direkt aus der .ics-Datei (Feld UID:), muss also nicht selbst
generiert werden. Ein erneuter Trigger-Lauf für dasselbe Ticket (z. B.
nach einem n8n-Neustart) legt den Termin dadurch nicht doppelt an.


Was das NICHT tut / Grenzen der ersten Iteration


Umsetzungsschritte (Reihenfolge)

  1. Vorfrage klären: welche Zammad-Instanz/Gruppe empfängt
    [email protected] (siehe oben).
  2. Nextcloud: Kalender-App aktivieren, Zielkalender anlegen, App-Passwort
    für n8n erzeugen (Baustein 1).
  3. iPhone: CalDAV-Account einrichten, Zielkalender abonnieren
    (Baustein 2).
  4. Zammad: Trigger + Webhook-Aktion anlegen (Baustein 3).
  5. n8n: Workflow bauen (Baustein 4), mit einer echten Test-Einladung
    (z. B. aus der eigenen Kalender-App an [email protected]
    verschickt) end-to-end testen.
  6. Nach erfolgreichem Testlauf: produktive Doku unter
    docs/3-apps-workloads/ ergänzen (analog zu den bestehenden
    Workflow-Abschnitten in
    30070-n8n.md) — dieses Dokument
    bleibt die Planungsgrundlage, nicht die Betriebsdoku.