n8n-Workflows
AI-School kann n8n-Workflows über einen Production Webhook starten. Das ist nützlich, wenn Sie außerhalb von AI-School einen automatisierten Prozess auslösen möchten, zum Beispiel eine Aufgabe erstellen, einen CRM-Datensatz aktualisieren, einen Reporting-Workflow starten oder Formulardaten an ein anderes System weiterleiten.
Beispiel: Newsbeitrag auf der Schulwebsite
Angenommen, die Schule hat einen n8n-Workflow erstellt, der einen Newsbeitrag auf der WordPress-Website veröffentlicht. In AI-School gibt der Benutzer nur einen kurzen Text ein, zum Beispiel einige Sätze über eine Projektwoche, einen Sporttag oder einen Tag der offenen Tür. Mit diesem Text wird der Workflow in n8n gestartet.
Der n8n-Workflow kann danach zum Beispiel:
- Aus dem kurzen Text mit einem LLM-Node und einem zur Tonalität der Schule passenden Prompt einen sauberen Entwurf erstellen.
- Mit einem zweiten LLM-Node eine passende Illustration erstellen lassen, zum Beispiel in den Farben der Schule und in einem wiedererkennbaren illustrativen Stil.
- Text und Bild als Blogbeitrag auf der WordPress-Website vorbereiten oder veröffentlichen.
So arbeiten AI-School und n8n zusammen: In AI-School wählt der Benutzer den Workflow aus und gibt die benötigten Informationen ein. n8n führt anschließend die automatisierten Schritte aus und sorgt dafür, dass der Newsbeitrag sauber auf der Website landet.
Was macht diese Integration?
Sie starten einen n8n-Workflow aus der Workflow-Übersicht. Wenn der Workflow Felder hat, füllen Sie diese zuerst aus. Ohne Felder wird der Workflow sofort gestartet.
- Wenn der Workflow keine Felder hat, wird der Webhook sofort ausgelöst.
- Wenn der Workflow Felder hat, öffnet sich zuerst ein Dialog. Der Benutzer füllt das Formular aus und startet danach den Workflow über die Schaltfläche.
- Die eingegebenen Werte werden als JSON in einem POST-Request an den n8n Webhook gesendet.
n8n-Workflow in AI-School erstellen
Ein Administrator registriert den Workflow wie folgt:
- Gehen Sie zu Assistenten.
- Öffnen Sie Workflows.
- Wählen Sie Neuer n8n workflow.
- Geben Sie den Workflow-Namen und die n8n Production URL ein.
- Richten Sie Header authentication mit einem Header-Namen und einem geheimen Header-Wert ein.
- Fügen Sie optional die Felder hinzu, die im POST-Request gesendet werden sollen.
- Speichern Sie den Workflow.
Felder
- Felder sind optional.
- Jedes Feld hat genau einen Feldnamen und einen Typ.
- Unterstützte Feldtypen sind kurzer Text, langer Text, Zahl, Ja/Nein und Datum.
- Pflichtfelder müssen ausgefüllt sein, bevor der Workflow gestartet werden kann.
- Der Feldname wird zum Key im JSON Body, der an n8n gesendet wird.
Kompatiblen Workflow in n8n erstellen
- Erstellen Sie in n8n einen neuen Workflow.
- Fügen Sie als ersten Node einen Webhook Trigger hinzu.
- Setzen Sie HTTP Method auf POST.
- Konfigurieren Sie Header authentication in n8n. Verwenden Sie denselben Header-Namen und Wert wie in der Anwendung.
- Kopieren Sie die Production URL des Webhooks. Verwenden Sie nicht die Test-URL.
- Aktivieren Sie den Workflow in n8n.
- Verwenden Sie den empfangenen JSON Body in den folgenden n8n Nodes.
Beispiel für den JSON Body
Wenn Sie Felder mit den Namen prompt, customerName und date definieren, erhält n8n zum Beispiel diesen JSON Body:
{
"prompt": "Create a short summary of the request.",
"customerName": "Example organization",
"date": "2026-09-22"
}
Wichtige Einschränkungen
- Es werden nur Webhook Trigger unterstützt.
- Es werden nur Production Webhook URLs unterstützt.
- Test Webhook URLs mit
/webhook-test/werden abgelehnt. - Es wird nur POST unterstützt.
- Es wird nur generic header authentication unterstützt.
- Der Header-Wert wird in der Anwendung als Geheimnis behandelt.
- Der Tenant wird serverseitig anhand des angemeldeten Benutzers bestimmt, nicht anhand eines Werts aus dem Browser.
Probleme beheben
- 404 oder Webhook nicht registriert: Aktivieren Sie den Workflow in n8n und verwenden Sie die Production URL.
- Authentifizierungsfehler: Prüfen Sie, ob Header-Name und Wert in beiden Systemen exakt gleich sind.
- Fehlende Daten: Prüfen Sie, ob die Feldnamen in der Anwendung den Keys entsprechen, die n8n erwartet.
- Kein Request in n8n: Prüfen Sie, ob der Workflow mit einem Webhook Trigger beginnt und POST verwendet.