Formstep

Een n8n-workflow bij de Wait-node pauzeren tot een klant zijn gegevens bevestigt

n8n's Wait-node is voor collega's. Dit human-in-the-loop-patroon met vier nodes vraagt een klant, met vooraf ingevulde en vergrendelde velden en herinneringen.

Door , oprichter van Formstep · Gepubliceerd · Bijgewerkt

Elke automatisering die ik voor een klant bouwde, loopt uiteindelijk tegen dezelfde muur aan. De workflow heeft zijn deel gedaan en heeft nu één ding nodig van iemand die niet in het team zit. De workflow stopt, en iemand schrijft een e-mail.

De n8n Wait-node is het juiste gereedschap voor die pauze, en de meeste n8n human-in-the-loop-handleidingen stoppen daar, met een collega die het formulier invult. Ik bouwde Formstep voor als de persoon buiten het bedrijf zit. Dit artikel houdt de Wait-node en wisselt het formulier om; voor een vergelijking per functie, zie Formstep vs n8n’s form.

Kort gezegd: houd de Wait-node en wissel het formulier om. Een Formstep-aanvraag gaat naar de klant, en de run hervat als de aanvraag eindigt: beantwoord, verlopen of geannuleerd.

Waar de n8n Wait-node ongemakkelijk wordt met een klant

De Wait-node werkt voor een collega en schiet tekort voor een klant. Hij pauzeert On Form Submitted, waarbij een n8n-formulier verschijnt op $execution.resumeFormUrl, of On Webhook Call, waarbij je $execution.resumeUrl krijgt om overal naartoe te sturen. Ik controleerde de documentatie van de Wait-node en de documentatie van de Form Trigger op 5 november 2026:

  • Het formulier opent op je n8n-adres. Niets in de documentatie zet het op een ander domein.
  • Het formulier is klein. Het Wait-formulier heeft zes veldtypen: Date, Dropdown List, Number, Password, Text en Textarea. Het rijkere formulier van de Form Trigger vraagt dat de persoon de workflow start.
  • Niets is vooraf ingevuld. Queryparameters kunnen een Form Trigger op zijn productie-URL vooraf invullen, maar het gedeelte over het Wait-formulier noemt geen prefill, en een veld vergrendelen staat op geen van beide pagina’s.
  • Niets jaagt ze na. De documentatie noemt geen herinneringen. Limit Wait Time beëindigt het wachten na een interval of op een datum, en de follow-up bouw je zelf.
  • De link gaat makkelijk fout. De documentatie van n8n waarschuwt dat de resume-URL de Webhook Suffix niet bevat en dat een gedeeltelijke uitvoering hem verandert. In een thread van april 2025 kreeg een ontvanger een pagina die zei dat de link niet meer geldig was, omdat het achtervoegsel ontbrak.

Het gebruikelijke advies als het Wait-formulier tekortschiet is On Webhook Call met je eigen formulier, en dat is dit artikel.

Met de Wait-node van n8n voor formulieren

8 stappen om te bouwen en draaiende te houden

  1. Trigger: een nieuwe leverancier in je sheet
  2. E-mailnode: stuur de hervat-URL van het formulier
  3. Wait-node: On Form Submitted, met een tijdslimiet
  4. IF: is de wachttijd verstreken?
  5. E-mailnode: stuur een herinnering, ga terug naar Wait
  6. IF: opgegeven na drie herinneringen? Informeer iemand
  7. Code-node: controleer de antwoorden, vraag opnieuw als ze fout zijn
  8. Jouw volgende stap

Met een Formstep-aanvraag

4 stappen om te bouwen

  1. Trigger: een nieuwe leverancier in je sheet
  2. Create request: voorinvullen, vergrendelen, wachten op de uitkomst
  3. Wait-node: On Webhook Call
  4. Switch: voltooid, verlopen of geannuleerd

Formstep regelt de rest

  • Voorgevulde en vergrendelde velden, bewaard op de server
  • Een formulier in jouw huisstijl, in hun taal
  • Uitnodigings- en herinneringsmails, op Pro
  • Antwoorden gecontroleerd met AI-validatie, op Pro
  • Verlopen en annuleren, als events verstuurd
Een gebruikelijke n8n-opzet voor iemand buiten je team. De jouwe kan meer of minder stappen hebben.

De workflow: vier nodes

Het patroon is een trigger, de Formstep Create request-node, een Wait-node en een Switch.

Een voltooide n8n-uitvoering: een handmatige trigger, Create request, een Wait-node met de naam Wait for the answer en een Switch met de naam Outcome, allemaal groen, met één item dat de approve-uitgang verlaat

Het hele patroon. De uitvoering stopt bij de Wait-node tot de ontvanger indient. Selecteer het om het op volledige grootte te zien.

1. Trigger. Alles kan. Hier is het een nieuwe rij in een Google Sheet met de naam, het e-mailadres en het bedrijf van een leverancier, en het IBAN dat wij hebben vastgelegd.

2. Create request. Installeer de community-node n8n-nodes-formstep op je self-hosted n8n, koppel hem met de Formstep-credential en voeg Create request toe na de trigger. Kies het formulier en koppel het e-mailadres van de ontvanger. Onder Values to Send toont de node elke vraag die je vooraf kunt invullen, met titel en field key. Koppel company_name en iban uit de sheet, kies company_name onder Read-Only Field Names or IDs en zet Wait for the Outcome aan.

Met Delivery op Email the Invitation mailt Formstep de leverancier een link. Het formulier opent met de bedrijfsnaam vergrendeld en het IBAN ingevuld, dus de leverancier bevestigt of corrigeert het in plaats van het te typen. Een verborgen veld als vendor_id is context: de leverancier kan het niet wijzigen en het komt ongewijzigd terug. Wait for the Outcome geeft Formstep de resume-URL van deze uitvoering als callback, zodat je die URL nooit zelf bouwt.

Het aanvraagformulier met Company name die Analytical Engines Ltd toont in een grijs veld en de notitie: Filled in by the sender
De vergrendelde bedrijfsnaam, zoals de leverancier het ziet.

E-mailbezorging vraagt Pro of Business, afgezien van 10 uitnodigingen die een Free-account naar zijn eigen adres kan sturen, zonder herinneringen. Laat Delivery op Free op None staan en verstuur {{ $json.url }} vanuit de volgende node, met je eigen e-mailtool, Slack of sms; prefill, vergrendelde velden, de callback en het verlopen werken allemaal hetzelfde.

Zet External ID op iets met {{ $execution.id }} erin, of laat hem leeg. Hij is ook de idempotentiesleutel, en elke uitvoering heeft zijn eigen resume-URL, dus een External ID uit een eerdere run faalt in plaats van stilletjes de oude aanvraag te hergebruiken.

3. Wait, met Resume op On Webhook Call en de methode op POST. Dat is de URL die de Create request-node net aan Formstep gaf. Stel Limit Wait Time in als je wilt dat n8n zelf opgeeft. Anders beëindigt het verlopen van de aanvraag het wachten: 30 dagen tenzij je Expires At instelt, maximaal 365 dagen vooruit.

4. Switch. Na de Wait-node is het item de callback, onder body. Formstep belt terug bij elk einde, niet alleen bij succes, dus vertak eerst op {{ $json.body.type }}:

  • request.completed: {{ $json.body.data.answers.iban }} is de bevestigde waarde, en {{ $json.body.data.request.outcome }} is approve, decline of changes als het formulier een Decision-vraag heeft.
  • request.expired: de leverancier maakte het niet af. Open een ticket, of stuur een nieuwe aanvraag.
  • request.canceled: iemand trok hem in via het dashboard, de API of een Cancel request-node.

Field keys maken stap 4 saai, in de goede zin. Ik stelde iban één keer in in de Keys-tabel van het formulier, en hij wordt bij de eerste publicatie bevroren, dus ik kan de vraag een andere titel geven, het formulier in het Pools vertalen of het dupliceren voor een andere klant, en $json.body.data.answers.iban blijft werken.

Wat er gebeurt terwijl de uitvoering wacht

Formstep repareert de Wait-node van n8n niet, en deze workflow loopt erdoorheen. n8n zet de uitvoeringsdata over naar de database als een workflow langer dan 65 seconden pauzeert, en een klant doet er dagen over. Mensen melden uitvoeringen die vastzitten in waiting op n8n Cloud, en self-hosted resume-URL’s die als localhost:5678 uitkomen (GitHub issue 20042, in november 2025 gesloten als niet gepland). Twee dingen zijn het waard om goed te doen.

Ten eerste het adres. n8n bouwt de resume-URL op uit WEBHOOK_URL, niet uit je browser, dus zet hem op het openbare HTTPS-adres met een slash aan het eind, geef /webhook-waiting/ door via je proxy en herstart n8n. De Create request-node controleert de resume-URL voordat hij iets aanmaakt en weigert een http://- of privéadres, dus een foute instelling faalt bij het bouwen in plaats van als een aanvraag die niemand kan beantwoorden.

Ten tweede staan de antwoorden niet in de wachtende uitvoering. Formstep probeert de callback acht keer over ongeveer vier uur, en als de uitvoering dan weg is, bevat de aanvraag de antwoorden nog steeds: lees ze met Get request, op de pagina Aanvragen, of met Replay request callback zolang de uitvoering nog wacht. Wil je liever geen uitvoering dagenlang openhouden, dan start de Formstep Trigger een verse workflow als de aanvraag eindigt.

Test het zonder iemand te mailen

Zet Test Mode aan in de Create request-node terwijl je bouwt. Een testaanvraag verstuurt geen e-mail en telt nergens mee, en zijn callback hervat de Wait-node nog steeds, dus je kunt de link zelf openen en de uitvoering zien doorgaan. De link sluit binnen 24 uur, en Free krijgt 10 testaanvragen per dag. Zet Test Mode uit en wijzig de External ID voordat je publiceert.

De callback verifiëren

De Wait-node controleert geen handtekeningen. Hij vertrouwt erop dat de resume-URL moeilijk te raden is, wat voor de meeste workflows genoeg is. Is dat niet zo, gebruik dan de Formstep Trigger: een tweede workflow die start bij Request Completed, Expired of Canceled en bij elk event de X-Formstep-Signature-header controleert.

De onderdelen die ik niet hoefde te bouwen

  • Het formulier draagt een herinneringsschema van maximaal vijf stappen, zoals een dag inactief, dan drie dagen, dan een week. Elke stap telt vanaf de laatste activiteit van de ontvanger, en Formstep verstuurt de e-mails op Pro en Business.
  • Zet de taal van de aanvraag op een taal waarin het formulier vertaald is.
  • Een formulier met een Documents-blok en een handtekeningvraag toont de documenten en verzamelt de handtekening. Bestanden voor alleen deze persoon, zoals zijn eigen contract, gaan op de aanvraag onder Documents.

Wanneer het eigen formulier van de n8n Wait-node de betere keuze is

Als de persoon in je team zit, is het n8n-formulier prima, en dan houdt één dienst minder je data vast. Met n8n User Auth van de Form Trigger antwoorden collega’s als zichzelf, en de resume-webhook van de Wait-node biedt Basic-, Header- en JWT-authenticatie plus een IP-whitelist, meer dan een geheime URL. Het werkt op n8n Cloud, waar onze node nog niet werkt, en als je alleen een ja of nee nodig hebt van iemand met een Slack-account, zijn Slack-knoppen eenvoudiger.

Formstep verdient zijn plek als de persoon buiten je bedrijf zit, de data vooraf ingevuld of vergrendeld moet zijn, iemand de persoon moet nabellen en de workflow in dezelfde run moet doorgaan. De node is MIT-gelicenseerd, met de broncode op github.com/formstep/n8n-nodes-formstep, en de prijzenpagina toont wat het kost: aanvragen op elk abonnement, e-mails vanaf Pro. De stapsgewijze versie staat in de n8n-handleiding, en de n8n-integratiepagina heeft nog twee workflows op dezelfde vier nodes.

Om met een kant-en-klaar formulier te beginnen, gebruik je het sjabloon voor leveranciersonboarding of goedkeuring. Wil je eerst AI een factuur laten lezen, zie dan een PDF met AI uitlezen in n8n. Wil je liever bestanden verzamelen, zie dan documenten verzamelen in n8n.

Vragen over dit artikel

Nog iets anders? De documentatie behandelt elke instelling, en we beantwoorden e-mail.

Lees de documentatie

Ja. Op On Form Submitted toont hij een formulier op $execution.resumeFormUrl, en op On Webhook Call geeft hij je $execution.resumeUrl om overal naartoe te sturen. Het formulier opent op je n8n-adres met zes veldtypen, en de documentatie, gecontroleerd op 5 november 2026, noemt geen prefill, geen vergrendelde velden en geen herinneringen. Dit artikel houdt de Wait-node en vervangt het formulier door een Formstep-aanvraag.

n8n bouwt de resume-URL op uit de instelling WEBHOOK_URL, niet uit het adres in je browser. Zet hem op het openbare HTTPS-adres met een slash aan het eind en herstart n8n. De Formstep Create request-node weigert een resume-URL met http:// voordat hij iets aanmaakt, dus een foute instelling verschijnt als fout in plaats van als een uitvoering die nooit hervat.

De documentatie noemt er geen. Limit Wait Time hervat de uitvoering na een interval of op een vaste datum, en daarmee kun je zelf een follow-up bouwen. Een Formstep-aanvraag volgt het herinneringsschema van het formulier, tot vijf stappen die tellen vanaf de laatste activiteit van de ontvanger en stoppen als de aanvraag eindigt, op Pro en Business.

De aanvraag verloopt, na 30 dagen tenzij je Expires At instelt, maximaal 365 dagen vooruit. Bij het verlopen hervat de uitvoering met een request.expired-event in plaats van antwoorden, dus één Switch dekt elk einde. Op Free bel je de persoon zelf na, want herinneringsmails beginnen op Pro.

De Formstep-node nog niet. n8n Cloud installeert alleen geverifieerde community-nodes, en de onze is niet geverifieerd. Hij draait op self-hosted n8n met een openbaar HTTPS-adres. Roep op n8n Cloud de Formstep REST API aan vanuit een HTTP Request-node en geef de resume-URL mee als callback-URL.

De node is gratis en MIT-gelicenseerd. Aanvragen zitten in elk Formstep-abonnement, met 1.000 inzendingen en aanvragen per maand op Free, waar je de link zelf verstuurt. Formstep de uitnodiging en herinneringen laten mailen vraagt Pro, voor $39 per maand of $32,50 per maand bij jaarlijkse betaling. Elke aanvraag kost één eenheid zodra hij wordt aangemaakt, beantwoord of niet.

Verzamel informatie van iedereen.

Publiceer een voorbeeldformulier, vul het in zoals je ontvanger dat zou doen en zie de antwoorden terugkomen. Geen account nodig.

Lees de documentatie