formbasedocs
Naar de appApp

Handleidingen · n8n (zelf gehost)

Start een n8n-workflow vanuit inzendingen via de openbare link

Deze handleiding bouwt een workflow met twee nodes: een nieuwe inzending voor een formulier voor leveranciersonboarding komt binnen in een formbase Trigger, en een Edit Fields-node pikt de antwoorden eruit. Zet je eigen e-mail-, Sheets-, Slack- of CRM-node erna.

Last checked


Je hebt een formbase-credential in n8n nodig en een gepubliceerd formulier met een deellink. Je n8n moet bereikbaar zijn vanaf het internet over HTTPS; zie Installeer de formbase-node in n8n. Een inzending via een aanvraaglink start deze workflows niet; zie Reageren op de uitkomst van een aanvraag in n8n daarvoor.

1. Voeg de trigger toe

Maak een workflow, klik op +, zoek naar formbase en kies formbase Trigger. Kies de credential, het formulier, en een van de drie events voor de openbare link onder Event:

De vervolgkeuzelijst Event van de formbase Trigger geopend: Public Link Submission Created, Updated en Abandoned, dan Request Completed, Expired en Canceled, elk met een korte beschrijving
EventDraait wanneerVereist
Public Link Submission CreatedEen respondent dient het formulier in via een deellink.Niets extra.
Public Link Submission UpdatedEen respondent bewerkt een inzending die hij al heeft verstuurd.Bewerken na verzenden ingeschakeld voor het formulier.
Public Link Submission AbandonedEen respondent laat het formulier onafgemaakt liggen voor de tijd onder Consider Abandoned After (12 uur tot 1 week). formbase controleert eens per uur, dus de run kan tot een uur later komen.Een Pro- of Business-abonnement, dat gedeeltelijke inzendingen opslaat.

2. Luister naar een testevent

Klik op Execute step. De node toont Listening for test event, en formbase stuurt de events van dit formulier gedurende twee minuten naar de test-URL van de node. Open de deellink van het formulier in een ander tabblad en dien hem binnen die tijd in. De inzending komt binnen enkele seconden aan in de node:

De formbase Trigger na een testevent: Form [Guide] Supplier onboarding, Event Public Link Submission Created, en de uitvoer met id, type submission.completed, test false en data › answers met company_name Nordlys Tekstil AS, contact_email, vat_number, het antwoord op de betalingstermijnen yes, en het geüploade certificaatbestand

n8n heeft geen voorbeeldrecord: de test is een echte inzending, en test is false. Elk antwoord verschijnt twee keer:

  • data.answers bevat de waarde waarmee een workflow vergelijkt, onder de veldsleutel van de vraag: een optiesleutel zoals yes, een getal, een datum, of een lijst bestanden.

  • data.display bevat de tekst die een persoon leest, zoals Yes.

Gebruik display in berichten en answers in voorwaarden. Zie de webhookreferentie voor beide.

Verlaten inzendingen komen uren later binnen, dus Execute step kan er geen vangen. Publiceer voor dat event de workflow en controleer Executions.

3. Pik de antwoorden eruit

Voeg een Edit Fields (Set)-node toe na de trigger. Sleep antwoorden vanuit het invoerpaneel naar Fields to Set, of typ de expressies zelf:

Een Edit Fields-node met drie velden: company van $json.data.answers.company_name, email van $json.data.answers.contact_email, en payment_terms van $json.data.display.do_you_accept_our_30_day_payment_terms, met als uitvoer Nordlys Tekstil AS, grace@nordlys.example en Yes
payment_terms leest uit display, dus bevat het label Yes in plaats van de optiesleutel yes.

De volgende node, bijvoorbeeld Gmail of Google Sheets, leest {{ $json.company }} en de andere velden van hier. Wanneer een vraag wordt hernoemd, blijft de veldsleutel hetzelfde, dus deze expressies blijven werken.

4. Publiceer en controleer een echte run

Klik op Publish, geef de versie een naam, en bevestig. formbase stuurt elke nieuwe inzending nu naar de productie-URL van de workflow. Het depubliceren van de workflow stopt dat.

Dien het formulier nog een keer in en open het tabblad Executions. De run verschijnt binnen enkele seconden. Runs die je bent gestart met Execute step dragen een kolfje-icoon; een productierun heeft er geen:

Het tabblad Executions van de gepubliceerde workflow: de laatste run Succeeded in 51ms zonder kolfje-icoon, drie eerdere testruns met een kolfje-icoon, en het canvas met formbase Trigger die 1 item doorgeeft aan Edit Fields

Als de workflow niet start

  • Het formulier werd ingediend via een aanvraaglink. Dat draait Request Completed, niet Public Link Submission Created.

  • De workflow is niet gepubliceerd. Alleen Execute step luistert terwijl de workflow een concept is, en alleen tot het eerste event binnenkomt of twee minuten verstrijken.

  • De trigger toont targetUrl must use https.

    Je n8n geeft een http://- of privé-URL af. Zie Vertel n8n zijn openbare adres.

  • De credential bereikt een andere werkruimte. De trigger luistert naar het formulier in de werkruimte waarnaar zijn credential wijst.

De handtekening controleren

De formbase Trigger controleert de X-formbase-Signature-header van elk event en weigert elk event dat niet klopt. Houd de klok van de n8n-host nauwkeurig: een event dat meer dan vijf minuten eerder is ondertekend, wordt ook geweigerd.

Volgende