⚠️ Veraltet (Stand 2026-04-30)
Diese Dokumentation beschreibt das alte System vor dem Process-Engine-Refactor (Phase 4.7). Die zugrundeliegenden Tabellen (cascade_*, concept_instances/bausteine, crisis_scenarios/events/tasks, workflow_*) wurden gedroppt. Die hier dokumentierten Routen und Models existieren so nicht mehr.
Aktuelle Architektur: Process-Engine API — eine Engine, mehrere Apps (flow.*, concept.*, crisis.*).
Diese Datei bleibt als historische Referenz erhalten.
Prilog-Callbacks: API-Referenz
Wenn ein Workflow laeuft, kann er Prilog bitten, bestimmte Dinge zu tun. Das passiert ueber Callbacks — spezielle URLs, die n8n aufruft. Diese Seite listet alle verfuegbaren Endpoints fuer fortgeschrittene Workflows.
Bequemer Weg
Die meisten dieser Callbacks sind im Prilog-Node als vorkonfigurierte Operations verfuegbar — schneller und ohne URL-Tippen. Diese Seite ist die volle Referenz fuer Faelle in denen Sie HTTP Request direkt nutzen wollen.
Alle Callbacks beginnen mit: PRILOG_API_URL/api/platform/v1/n8n-callback/
Krisen-Workflows
| Callback | Was passiert |
|---|---|
POST /events/:eventId/create-tasks | Erstellt Aufgaben fuer ein Krisen-Event |
POST /events/:eventId/create-room | Erstellt einen Matrix-Krisenraum |
POST /events/:eventId/notify-matrix | Sendet eine Nachricht in den Krisenraum |
GET /events/:eventId/tasks | Fragt ab: Welche Aufgaben sind noch offen? |
POST /tasks/:taskId/escalate | Eskaliert eine ueberfaellige Aufgabe |
POST /events/:eventId/generate-report | Erstellt den Nachbericht |
Spaces, Benutzer, Mitgliedschaften
| Callback | Was passiert |
|---|---|
GET /tenant-info | Tenant-IDs ermitteln |
GET /spaces?tenantId=... | Alle Spaces eines Tenants |
POST /spaces/create | Neuen Space erstellen |
POST /spaces/:spaceId/members | Benutzer einem Space hinzufuegen |
GET /users?tenantId=... | Alle Benutzer eines Tenants |
Details und Beispiele: Spaces & Benutzer verwalten
Matrix-Chat
| Callback | Was passiert |
|---|---|
POST /matrix/send | Nachricht in einen Matrix-Raum senden |
GET /matrix/rooms?tenantId=... | Alle Matrix-Raeume des Tenants |
GET /matrix/credentials?tenantId=... | Matrix-Token fuer n8n-Setup |
Details und Beispiele: Chat-Nachrichten automatisieren
Beispiel: Tasks erstellen via HTTP Request
Im HTTP Request Node:
- URL:
PRILOG_API_URL/api/platform/v1/n8n-callback/events/[eventId]/create-tasks - Body (JSON):
{
"tasks": [
{ "id": "t1", "title": "Feuerwehr 112 anrufen", "assignedRole": "SCHOOL_PRINCIPAL" },
{ "id": "t2", "title": "Gebaeude raeumen", "assignedRole": "CUSTODIAN" },
{ "id": "t3", "title": "Vollstaendigkeit pruefen", "assignedRole": "SCHOOL_ADMIN" }
]
}Sie definieren die Aufgaben im Workflow — nicht in der Datenbank. Das bedeutet: verschiedene Workflows koennen verschiedene Aufgaben-Listen haben, und Sie koennen sie jederzeit anpassen.
Authentifizierung
Die Callback-Endpoints sind service-to-service — sie pruefen keinen User-Token. Schutz kommt aus drei Ebenen:
- Netzwerk: Backend laeuft auf api.prilog.chat, n8n auf dem Kundenserver. Beide ueber HTTPS.
- Tenant-Isolation: Jeder Callback bekommt explizit die Tenant-ID. Keine Cross-Tenant-Operationen moeglich.
- Read-only fuer kritische Operationen: Manche Endpoints sind absichtlich nicht als Callback verfuegbar (z.B. Loeschen).
Haeufige Fragen
Muss ich programmieren koennen?
Nein. Der n8n-Editor ist visuell — Sie ziehen Bausteine auf eine Leinwand und verbinden sie. Kein Code noetig.
Was passiert, wenn n8n nicht laeuft?
Die Krise wird trotzdem in Prilog erfasst (Event in der Datenbank). Nur die automatischen Aktionen (Matrix-Raum, Eskalation) laufen dann nicht. Sobald n8n wieder laeuft, koennen Workflows manuell nachgetriggert werden.
Kann ich einen Workflow wieder deaktivieren?
Ja — im n8n-Editor oben rechts gibt es einen Schalter. Gruen = aktiv, grau = inaktiv. Inaktive Workflows reagieren nicht auf Events.
Koennen mehrere Personen gleichzeitig Workflows bearbeiten?
Ja, n8n unterstuetzt das. Aenderungen werden gespeichert sobald Sie den Workflow speichern (Ctrl+S).
Wo finde ich Hilfe zu n8n?
- n8n Dokumentation: docs.n8n.io (englisch)
- n8n Community: community.n8n.io (englisch)
- Prilog-Support: Wir helfen Ihnen gerne bei der Einrichtung Ihrer Workflows