n8n

Es gibt zwei Wege, Orimora und n8n zu verbinden — je nachdem, welche Seite den Ablauf startet:

Du willst…	Nutze
Einen Workflow bei Änderungen starten oder Inhalte lesen/schreiben	Den Community-Node n8n-nodes-orimora (Trigger + Action)
Ein bestimmtes Dokument bedarfsweise oder bei Publish pushen	Einen „Senden an”-Push-Endpunkt auf einen n8n-Webhook

Option A — der Community-Node

n8n-nodes-orimora liefert einen Orimora Trigger (Workflow bei einem Änderungs-Event starten) und eine Orimora Action (Dokumente und Kollektionen aus jedem Schritt lesen/schreiben). Der Trigger registriert seinen Webhook automatisch, wenn du den Workflow aktivierst/deaktivierst.

1. Installiere n8n-nodes-orimora. Das npm-Registry-Release folgt in der Open Beta; bis dahin aus dem Quellcode (Repository) installieren. Nach der Veröffentlichung: Einstellungen → Community Nodes → n8n-nodes-orimora installieren.
2. Gehe in Orimora zu Einstellungen → Developer → API-Schlüssel und erstelle einen Schlüssel mit den Scopes read + write.
3. Lege in n8n eine Orimora API-Credential mit diesem API-Schlüssel und deiner Orimora-Basis-URL an.
4. Füge einen Orimora-Trigger-Node (Events auswählen) oder einen Orimora-Action-Node (Operation auswählen) zu deinem Workflow hinzu.

Trigger-Events: document.created, document.updated, document.deleted, document.published, collection.created, collection.updated, collection.deleted, notification.created.

Action-Operationen: Dokument — Get, Get Many (Filter nach Kollektion, Eltern-Dokument, Titel, Status, Tags, Papierkorb oder updatedSince), Create, Update, Delete, Restore · Kollektion — Get, Get Many, Create, Export (ZIP) · Tag — Get Many, Create.

Hinweis

Der Trigger nutzt intern Orimoras team-weite Webhooks — er abonniert Events für den gesamten Workspace, nicht einen einzelnen Ordner. Schränke im Workflow ein, worauf du reagierst.

Option B — ein „Senden an”-Push-Endpunkt

Wenn du ein ausgewähltes Dokument pushen willst (manuell oder automatisch bei Publish), statt auf jedes Workspace-Event zu reagieren, nutze einen Senden-an-Endpunkt, der auf einen n8n-Webhook-Trigger-Node zeigt.

1. Füge in n8n einen Webhook-Node hinzu und kopiere dessen URL.
2. Gehe in Orimora zu Einstellungen → Senden-an-Endpunkte → Neuer Endpunkt, trage die n8n-Webhook-URL ein und speichere das erzeugte Signatur-Secret.
3. Sende ein Dokument aus seinem Menü („Senden an…”), oder aktiviere „Automatisch bei Publish”, um es bei jedem Veröffentlichen zu senden.

Der Payload ist ein POST mit dem Dokument als Markdown plus HMAC-Signatur — den genauen Body und die Verifikation findest du unter Senden an → Payload & Signatur.

Auto-Send idempotent machen

Auto-bei-Publish feuert bei jedem document.published-Event, nicht nur beim ersten. Dedupliziere in deinem n8n-Workflow über den Header X-Orimora-Delivery-Id (oder das Feld delivery_id), oder vergleiche den updated_at des Dokuments, damit ein erneutes Publizieren keine doppelten Downstream-Datensätze erzeugt.

Welche Option?

• Community-Node — bidirektional, reagiert auf jede Workspace-Änderung und kann auch zurück nach Orimora lesen/schreiben. Am besten für allgemeine Automatisierung.
• Senden-an-Endpunkt — einseitig, dokumentbezogen, signiert. Am besten für „dieses eine Dokument in meine Pipeline veröffentlichen”, ohne alles zu abonnieren.

Siehe auch

• Webhooks — das team-weite Event-Modell, auf dem der Trigger aufbaut
• Senden an (Webhook / n8n) — Push pro Dokument, Payload + Signatur
• REST-API Überblick — die API, die der Action-Node aufruft