n8n workflows

AI-School kan n8n workflows starten via een productie-webhook. Dit is handig wanneer je buiten AI-School een geautomatiseerd proces wilt starten, bijvoorbeeld het aanmaken van een taak, bijwerken van een CRM-record, starten van een rapportageflow of doorzetten van formuliergegevens naar een ander systeem.

Voorbeeld: nieuwsartikel op de schoolwebsite

Stel dat de school een n8n workflow heeft gemaakt die een nieuwsartikel publiceert op de WordPress website van de school. In AI-School vul je dan alleen een kort stukje tekst in, bijvoorbeeld een paar zinnen over een projectweek, sportdag of open dag. Met die tekst start je de workflow in n8n.

De n8n workflow kan daarna bijvoorbeeld:

1. Van de korte tekst een nette concepttekst maken met een LLM node en een prompt die goed past bij de toon van de school.
2. Een passende illustratie laten maken met een tweede LLM node, bijvoorbeeld in de kleuren van de school en in een herkenbare illustratieve stijl.
3. De tekst en afbeelding als blogbericht klaarzetten of publiceren op de WordPress website.

Zo werken AI-School en n8n samen: in AI-School kiest de gebruiker de workflow en vult de benodigde informatie in. n8n voert daarna de geautomatiseerde stappen uit en zorgt dat het nieuwsartikel netjes op de website terechtkomt.

Wat doet deze integratie?

Je start een n8n workflow vanuit het workflow-overzicht. Als de workflow velden heeft, vul je die eerst in. Zonder velden wordt de workflow meteen gestart.

• Heeft de workflow geen velden, dan wordt de webhook meteen aangeroepen.
• Heeft de workflow wel velden, dan opent eerst een formulier. De gebruiker vult de velden in en start daarna de workflow met de knop.
• De ingevulde waarden worden als JSON meegestuurd in een POST-request naar de n8n webhook.

n8n workflow aanmaken in AI-School

Een beheerder registreert de workflow als volgt:

1. Ga naar Assistenten.
2. Open Workflows.
3. Kies Nieuwe n8n workflow.
4. Vul de naam van de workflow en de n8n productie-url in.
5. Stel Header authentication in met een header name en geheime header value.
6. Voeg eventueel de velden toe die moeten worden meegestuurd in het POST-request.
7. Sla de workflow op.

Velden

• Velden zijn optioneel.
• Elk veld heeft één veldnaam en een type.
• Ondersteunde veldtypes zijn korte tekst, lange tekst, getal, ja/nee en datum.
• Verplichte velden moeten zijn ingevuld voordat de workflow kan worden gestart.
• De veldnaam wordt de key in de JSON body die naar n8n wordt gestuurd.

Compatibele workflow maken in n8n

1. Maak in n8n een nieuwe workflow.
2. Voeg als eerste node een Webhook Trigger toe.
3. Zet HTTP Method op POST.
4. Configureer header authentication in n8n. Gebruik dezelfde header name en value als in de applicatie.
5. Kopieer de Production URL van de webhook. Gebruik niet de test-url.
6. Activeer de workflow in n8n.
7. Gebruik de ontvangen JSON body in de volgende n8n nodes.

Voorbeeld van de JSON body

Als je velden definieert met de namen prompt, klantnaam en datum, ontvangt n8n bijvoorbeeld deze JSON body:

{
  "prompt": "Maak een korte samenvatting van de aanvraag.",
  "klantnaam": "Voorbeeldorganisatie",
  "datum": "2026-09-22"
}

Belangrijke beperkingen

• Alleen webhook triggers worden ondersteund.
• Alleen productie-webhook-urls worden ondersteund.
• Test-webhook-urls met /webhook-test/ worden geweigerd.
• Alleen POST wordt ondersteund.
• Alleen generic header authentication wordt ondersteund.
• De header value wordt in de applicatie als geheim behandeld.
• De tenant wordt server-side bepaald vanuit de ingelogde gebruiker, niet vanuit een waarde die de browser meestuurt.

Problemen oplossen

• 404 of webhook niet geregistreerd: activeer de workflow in n8n en gebruik de productie-url.
• Authenticatiefout: controleer of header name en value in beide systemen exact gelijk zijn.
• Ontbrekende data: controleer of de veldnamen in de applicatie overeenkomen met de keys die n8n verwacht.
• Geen request in n8n: controleer of de workflow begint met een webhook trigger en POST gebruikt.