Handleidingen · n8n

n8n koppelen aan de OpenAI API: je eerste AI-workflow in 30 minuten (2026)

Koppel de OpenAI API in 30 minuten aan n8n. Bouw drie praktische AI-workflows: e-mailsamenvatting, ticket-categorisering en FAQ-beantwoorder. Inclusief kosten

🟢 Beginner — geen code vereist ⏱ 30 minuten
Tools: n8nOpenAI API (GPT-5)GmailGoogle Sheets
n8n koppelen aan de OpenAI API: je eerste AI-workflow in 30 minuten (2026)

Wat je leert in deze handleiding

  • Een OpenAI API-sleutel aanmaken en koppelen aan n8n
  • De OpenAI-node configureren met systeem- en gebruikersprompts
  • Een Gmail-trigger instellen die e-mails automatisch verwerkt
  • AI-output opslaan in Google Sheets via n8n
  • Je workflow live zetten en monitoren via de n8n-dashboard
  • Kosten beheersen met token-limieten en modelselectie

In het kort

  1. 1. OpenAI API-sleutel aanmaken
  2. 2. n8n starten en OpenAI-credential koppelen
  3. 3. Eerste workflow met OpenAI-node
  4. 4. Gmail-trigger toevoegen
  5. 5. Resultaten opslaan in Google Sheets
  6. 6. Workflow activeren en kosten beheren

Automatisering en AI zijn in 2026 geen nice-to-have meer, maar een concurrentievoordeel. Toch schrikken veel ondernemers terug voor de technische complexiteit. n8n lost dat op: het is een visuele workflow-builder waarmee je zonder programmeerkennis krachtige automatiseringen bouwt. Koppel je daar de OpenAI API aan, dan heb je een AI-assistent die 24/7 werkt, nooit moe wordt en per verwerkte e-mail slechts een paar eurocent kost.

Wat je nodig hebt

Voordat je begint, zorg dat je het volgende hebt: - Een n8n-account (cloud op n8n.io of zelfgehoste Docker-installatie) - Een OpenAI-account met geldig betaalmiddel (platform.openai.com) - Een Gmail-account dat je wilt automatiseren - Een Google Sheets-spreadsheet om resultaten op te slaan - Ongeveer 30 minuten de tijd Je hebt geen programmeerervaring nodig. De stappen zijn zo ingedeeld dat een absolute beginner ze kan volgen.

Stap 1: OpenAI API-sleutel aanmaken

Ga naar platform.openai.com en log in op je account. Klik rechtsboven op je avatar en kies 'API keys'. Klik op de knop 'Create new secret key' en geef de sleutel een beschrijvende naam, bijvoorbeeld 'n8n-workflows'. Kopieer de sleutel direct, want je kunt hem maar eenmalig bekijken. Belangrijk: sla je API-sleutel veilig op in een wachtwoordmanager. Deel hem nooit via e-mail of Slack. Voeg in OpenAI direct een uitgavenlimiet in ('Settings' > 'Billing' > 'Usage limits'). Een limiet van 20 euro per maand is voor de meeste startende workflows ruim voldoende.

Stap 2: n8n installeren of starten via de cloud

Je hebt twee opties: Optie A: n8n Cloud (aanbevolen voor beginners) Ga naar n8n.io/cloud en maak een gratis proefaccount aan. Je hebt binnen 2 minuten een werkende n8n-omgeving zonder technische setup. Optie B: Zelfhosten via Docker (voor gevorderden) Als je meer controle wilt of kosten wilt besparen bij hoge volumes, kun je n8n zelfhosten. Je hebt dan Docker nodig op je server of lokale machine.

Stap 3: OpenAI-credential aanmaken in n8n

Open n8n en ga naar 'Credentials' in het linker menu (het sleutelpictogram). Klik op 'Add credential' en zoek op 'OpenAI'. Plak je API-sleutel in het veld 'API Key'. Klik op 'Save' en daarna op 'Test connection'. Je ziet een groen vinkje als de verbinding werkt. Geef de credential een herkenbare naam zoals 'OpenAI Productie'. Je kunt meerdere credentials aanmaken, bijvoorbeeld een voor testen en een voor productie.

Stap 4: Je eerste workflow aanmaken

Ga naar 'Workflows' en klik op 'New workflow'. Je ziet een leeg canvas met een startnode. Klik op de plusknop om een node toe te voegen. We beginnen met de eenvoudigste trigger: 'Manual Trigger'. Daarmee kun je de workflow handmatig starten om te testen. Sleep nu een 'OpenAI' node vanuit de zoekbalk naar het canvas. Verbind de Manual Trigger met de OpenAI node door een lijn te trekken van het kleine bolletje rechts op de trigger naar de OpenAI node. Klik op de OpenAI node om hem te configureren: - Resource: Text - Operation: Message a model - Model: gpt-5 (of gpt-4o als GPT-5 nog niet beschikbaar in je regio) - Credential: selecteer de OpenAI-credential die je net aanmaakte

Stap 5: Systeem- en gebruikersprompt instellen

De kwaliteit van je AI-output staat of valt met je prompt. In de OpenAI node heb je twee prompts: 1. Systeemprompt: de vaste instructie die het gedrag van het model bepaalt. Schrijf hier wat de AI moet zijn en hoe het moet reageren. 2. Gebruikersprompt: de variabele input, de taak die de AI per workflow-run uitvoert. Klik in de OpenAI node op 'Messages'. Voeg een systeem-bericht toe met de onderstaande tekst. Voeg daarna een gebruikers-bericht toe dat verwijst naar de dynamische input van je trigger.

Stap 6: Test de OpenAI-verbinding

Klik op de Manual Trigger node en klik daarna op 'Execute node'. Er verschijnt een groene checkmark als alles werkt. Klik op de OpenAI node om de output te zien. Je ziet het antwoord van GPT-5 in het rechterpaneel onder 'Output'. Als je een foutmelding ziet zoals 'Insufficient quota', controleer dan je OpenAI-dashboard: ga naar 'Billing' en check of je tegoed actief is. Een nieuw account heeft soms tot 24 uur nodig voordat de API actief is.

Stap 7: Gmail-trigger toevoegen voor echte e-mails

Nu koppelen we een echte trigger. Verwijder de Manual Trigger en voeg een 'Gmail Trigger' node toe. Configureer hem als volgt: - Resource: Message - Event: Message Received - Filters: label 'INBOX', eventueel een specifiek label zoals 'ai-verwerken' - Poll interval: elke 5 minuten (of 1 minuut voor urgente workflows) Voeg een Gmail-credential toe via 'Add credential'. n8n leidt je door de OAuth2-flow: je geeft toestemming via je Google-account en n8n krijgt leestoegang tot je inbox. Na de Gmail Trigger voeg je een 'Set' node toe om de e-mailtekst op te schonen voordat die naar OpenAI gaat. Verwijder HTML-tags en stel het veld 'emailTekst' in.

Stap 8: Resultaten opslaan in Google Sheets

Na de OpenAI node voeg je een 'Google Sheets' node toe. Configureer hem als volgt: - Operation: Append Row - Credential: voeg een Google Sheets OAuth2-credential toe - Spreadsheet: kies je spreadsheet - Sheet: kies het tabblad De kolommen in je spreadsheet stel je in als kolomnamen in de node. Gebruik de volgende kolommen: - Datum: {{ $now.toFormat('dd-MM-yyyy HH:mm') }} - Afzender: {{ $('Gmail Trigger').item.json.from }} - Onderwerp: {{ $('Gmail Trigger').item.json.subject }} - Samenvatting: {{ $json.choices[0].message.content }} Zo bouw je automatisch een logboek van alle verwerkte e-mails, gesorteerd op datum.

Stap 9: Workflow activeren en monitoren

Als je tevreden bent met de testresultaten, activeer je de workflow. Klik rechtsboven op de schakelaar 'Active'. De workflow draait nu automatisch op de achtergrond. Monitor je workflow via de 'Executions' tab in het linker menu. Je ziet hier elke run, inclusief succes of foutmelding. Bij een fout klik je op de run om te zien welke node gefaald heeft en wat de foutmelding is. Stel ook een fout-melding in: ga naar 'Settings' in de workflow en activeer 'Error workflow'. Kies 'Send email on error' zodat je een bericht krijgt als de workflow crasht.

Stap 10: Kosten beheren en model kiezen

OpenAI rekent per 1.000 tokens (woorden en leestekens). Een gemiddelde e-mail van 300 woorden kost met GPT-5 ongeveer 0,01 tot 0,03 euro per verwerking. Voor de meeste MKB-workflows blijf je ruim onder 20 euro per maand. Modelkeuze in 2026: - GPT-5: beste kwaliteit, hogere kosten. Gebruik voor kritieke taken. - GPT-4o mini: 90% kwaliteit, 10% van de kosten van GPT-5. Uitstekend voor bulk-taken. - gpt-4o: balans tussen kwaliteit en prijs. Goede keuze voor dagelijkse e-mailverwerking. Tip: gebruik de OpenAI Tokenizer op platform.openai.com/tokenizer om te berekenen hoeveel tokens je prompts gebruiken.

Veelgemaakte fouten en oplossingen

Fout: 'You exceeded your current quota' Oplossing: Controleer je OpenAI-dashboard onder 'Billing'. Je gratis tegoed kan verlopen zijn. Voeg een betaalmiddel toe en stel een maandlimiet in. Fout: 'Invalid API Key' Oplossing: Kopieer de sleutel opnieuw vanuit platform.openai.com/api-keys. Zorg dat er geen spaties voor of na de sleutel zitten in het n8n-credential veld. Fout: 'Context length exceeded' Oplossing: Je e-mail is te lang voor het model. Voeg de Set node toe (zie Stap 7) en beperk de tekst tot 4.000 tekens via substring(0, 4000). Fout: Gmail Trigger geeft geen data Oplossing: Controleer of je workflow actief is (de schakelaar staat op 'Active'). Stuur een test-e-mail en wacht het poll-interval af. Check ook of je Gmail-credential nog geldig is via 'Credentials'. Fout: Google Sheets rij wordt niet toegevoegd Oplossing: Controleer of de kolomnamen in n8n exact overeenkomen met de headers in je spreadsheet (inclusief hoofdletters). Gebruik 'Append or Update' in plaats van 'Append' als je al data in het sheet hebt.

Uitbreidingen: wat bouw je daarna?

Je hebt nu de basisworkflow. Dit zijn logische volgende stappen om er meer uit te halen: 1. Automatisch antwoorden: voeg een tweede OpenAI-call toe die een conceptantwoord schrijft op basis van de samenvatting. Stuur het concept via Gmail als draft zodat je het nog kunt controleren voor verzending. 2. Urgentie-routing: voeg een IF-node toe die e-mails met urgentieniveau 'Hoog' direct doorstuurt naar Slack of jou een push-bericht stuurt via Telegram. 3. CRM-koppeling: stuur contactgegevens van nieuwe klanten automatisch door naar HubSpot of Pipedrive. Combineer dat met de AI-analyse om leads te prioriteren. 4. Dagelijkse digest: laat n8n elke ochtend om 8:00 een samenvatting sturen van alle e-mails van de afgelopen 24 uur, gesorteerd op urgentie. 5. Meerdere talen: voeg aan de systeemprompt toe dat het model altijd in het Nederlands moet antwoorden, ook als de inkomende e-mail in het Engels is.

- n8n documentatie: https://docs.n8n.io - OpenAI API-referentie: https://platform.openai.com/docs - n8n community forum: https://community.n8n.io - OpenAI Tokenizer tool: https://platform.openai.com/tokenizer - Workflows.nl handleiding: n8n klantenservice-agent bouwen met Claude - Workflows.nl handleiding: WhatsApp Business koppelen aan n8n

Veelgestelde vragen

Hoe koppel ik de OpenAI API aan n8n?

Maak op platform.openai.com een secret key, zet een maandlimiet (bijvoorbeeld 20 euro) en plak de key in n8n onder Credentials > OpenAI. Test de verbinding, daarna: Manual Trigger plus OpenAI Message a model. De API-basis staat in de OpenAI API-beginnersgids.

Kies ik n8n Cloud of zelf hosten met Docker?

Cloud is in twee minuten klaar en fijn als beginner. Docker geeft meer controle en lagere kosten bij hoge volumes. De workflowstappen daarna zijn hetzelfde.

Hoe houd ik de OpenAI-kosten laag?

Gebruik gpt-4o-mini voor bulk en gpt-4o of GPT-5 voor kritieke taken. Kort mailtekst in tot ongeveer 4.000 tekens. Per mail betaal je centen; de meeste MKB-flows blijven onder 20 euro per maand. Actuele keuzes: vergelijk modellen.

Wat betekent 'You exceeded your current quota'?

Je tegoed of limiet in het OpenAI-dashboard is op. Voeg een betaalmiddel toe en zet een maandlimiet. Bij Invalid API Key: key opnieuw kopiëren, zonder spaties in het credential-veld.

Wat bouw ik na de e-mailsamenvatter?

Een conceptantwoord als Gmail-draft, een IF-node die hoge urgentie naar Slack stuurt, of een CRM-koppeling. De logische vervolgstap is de klantenservice-bot met Claude.

Gerelateerd

Nieuwsbrief

Meer handleidingen en tips?

Elke week de beste agentic AI inzichten en nieuwe handleidingen in je inbox.

Gratis aanmelden →