Een AI-model koppelen aan je n8n-workflow
In n8n koppel je een AI-model via de ingebouwde AI-nodes voor OpenAI, Anthropic (Claude) of andere providers. Je voegt je API-sleutel toe als credential, kiest het model en schrijft een prompt die data uit de workflow verwerkt. Het gegenereerde antwoord gebruik je als input voor de volgende stap in de workflow.
Door een AI-model te koppelen aan n8n automatiseer je taken die begrip van tekst vereisen, zoals categoriseren, samenvatten en beantwoorden.
Wat je nodig hebt
- Een actieve n8n-installatie
- Een API-sleutel van een AI-provider: Anthropic (Claude) of OpenAI (ChatGPT)
- Een concrete use case: de voorbeeldworkflow in deze gids verwerkt inkomende klantmails
Stap 1: Voeg je API-sleutel toe als credential
Ga in n8n naar Settings > Credentials en klik op Add Credential. Zoek naar de provider die je wilt gebruiken: “Anthropic” voor Claude of “OpenAI” voor GPT-modellen.
Plak je API-sleutel in het daarvoor bestemde veld. Geef de credential een herkenbare naam, zoals “Anthropic Productie” of “OpenAI Bedrijfsaccount”. Je kunt dezelfde credential hergebruiken in alle workflows.
Heb je nog geen API-sleutel? Maak een account aan via console.anthropic.com (Claude) of platform.openai.com (OpenAI) en genereer een sleutel via de API-sectie.
Stap 2: Voeg een Webhook-trigger toe
Voeg een Webhook-node toe als startpunt van je workflow. In ons voorbeeld stuurt een e-mailsysteem automatisch een webhook zodra een nieuwe klantmail binnenkomt, met de inhoud als JSON.
De webhook ontvangt onder andere {{ $json.afzender }}, {{ $json.onderwerp }} en {{ $json.inhoud }}. Stuur een testverzoek om deze velden te bevestigen voor de volgende stap. Meer over het instellen van webhooks lees je in webhook instellen in n8n.
Stap 3: Voeg een AI-node toe
Klik op het plusknopje na de Webhook-node en zoek op Anthropic of OpenAI. Voeg de node toe en selecteer de credential die je in stap 1 hebt aangemaakt.
Stel in:
- Model: kies je model, bijvoorbeeld
claude-haiku-4-5voor snelheid en lage kosten, ofclaude-sonnet-4-5voor betere kwaliteit - Messages: voeg een system-message toe met de taakomschrijving
Voorbeeldprompt voor categorisering en conceptantwoord:
Je bent een medewerker klantenservice voor een softwarebedrijf.
Ontvangen klantmail:
Afzender: {{ $json.afzender }}
Onderwerp: {{ $json.onderwerp }}
Inhoud: {{ $json.inhoud }}
Doe het volgende:
1. Categoriseer de mail als: "factuurvraag", "technisch probleem", "feature-verzoek" of "overig"
2. Schrijf een kort conceptantwoord van maximaal 100 woorden in het Nederlands
Antwoord uitsluitend in dit JSON-formaat:
{"categorie": "...", "concept_antwoord": "..."}
Stap 4: Verwerk de AI-output in de workflow
De AI-node geeft een tekststring terug. Als je het model om JSON hebt gevraagd, parseer je de output met een Code-node of de JSON Parse-node. Daarna heb je losse velden beschikbaar: {{ $json.categorie }} en {{ $json.concept_antwoord }}.
Voeg een Switch-node toe om op basis van de categorie te vertakken: factuurvragen gaan naar het boekhoudingsteam, technische problemen naar de support-queue, en de rest naar een algemene inbox.
Stap 5: Stuur het conceptantwoord door
Voeg een Gmail of Outlook-node toe op elke vertakking. Vul het conceptantwoord in als de e-mailbody. Je kunt kiezen of de e-mail automatisch verzonden wordt of als concept in de inbox staat voor menselijke goedkeuring.
Activeer de workflow en test met een echte inkomende mail. Controleer of de categorisering klopt en het conceptantwoord bruikbaar is. Pas de systeemprompt aan tot het resultaat consistent goed is.
Wil je meer leren over de Claude API die je hier via n8n gebruikt? Lees wat is de Claude API en waarvoor gebruik je hem?.
Onze tip: Vraag het AI-model altijd om gestructureerde output (JSON), ook als je de gestructureerde data nergens voor gebruikt. Gestructureerde output is consistenter en makkelijker te verwerken dan vrije tekst. Voeg een validatiestap toe die controleert of de verwachte velden aanwezig zijn, zodat je foutieve AI-output afvangt voordat die problemen veroorzaakt verderop in de workflow.
Veelgestelde vragen
Welke AI-modellen kan ik koppelen aan n8n?
n8n heeft ingebouwde nodes voor OpenAI (GPT-4, GPT-4o), Anthropic (Claude), Hugging Face, Google Gemini en Azure OpenAI. Via de HTTP Request-node kun je elk AI-model koppelen dat een REST-API biedt. Voor de meeste zakelijke toepassingen zijn de OpenAI en Anthropic-nodes het meest gebruikt, omdat die de beste combinatie bieden van prestaties en documentatie.
Hoe schrijf ik een goede systeemprompt voor een n8n-workflow?
Een systeemprompt in een geautomatiseerde workflow is anders dan een prompt voor interactief gebruik. Wees zeer expliciet over het gewenste outputformaat, want niemand corrigeert het resultaat handmatig. Vraag om JSON als je het antwoord wilt verwerken in volgende nodes. Beschrijf de taak, het doel, de toon en de beperkingen. Test de prompt eerst in de chatinterface van het model voordat je hem inbouwt in de workflow.
Wat kost het om een AI-model te gebruiken in n8n-workflows?
Je betaalt rechtstreeks aan de AI-provider per verwerkte token, niet aan n8n. De kosten hangen af van het model en het volume. Voor een workflow die honderden e-mails per dag verwerkt met GPT-4o Mini of Claude Haiku, zijn de kosten doorgaans een paar euro per maand. Zwaardere modellen zoals GPT-4o of Claude Sonnet kosten meer maar leveren betere resultaten voor complexe taken.