formbasedocs
Naar de appApp

Handleidingen · n8n (zelf gehost)

Installeer de formbase-node in n8n

formbase voor n8n is een community node, gepubliceerd op npm als n8n-nodes-formbase. Deze handleiding installeert hem op een zelf gehoste n8n en stelt het adres in dat formbase gebruikt om je workflows te bereiken.

Last checked

Elke n8n-handleiding is gecontroleerd op zelf gehoste n8n 2.40, draaiend in Docker, met versie 0.10.1 van de node. Alles wat afhangt van waar n8n draait, staat op deze pagina. De andere handleidingen werken hetzelfde zodra de node is geïnstalleerd.

Voordat je begint

  • n8n 2.30 of hoger. De formbase-credential heeft het nodig.

  • Een formbase-account. Alles in deze handleidingen werkt op Free, behalve e-mailuitnodigingen, herinneringen en verlaten inzendingen, die Pro of Business vereisen.

Zelf gehoste n8n

Een zelf gehoste n8n heeft twee dingen nodig voordat hij de node kan installeren:

  • Het eigenaarsaccount of een adminaccount. Alleen de eigenaar en admins kunnen community nodes installeren.

  • Een openbaar HTTPS-adres, van een reverse proxy of een tunnel. formbase stuurt events en aanvraagcallbacks alleen naar https://-URL’s op het openbare internet. Een n8n die alleen op localhost bereikbaar is, kan wel verbinden maar ontvangt nooit iets.

1. Vertel n8n zijn openbare adres

n8n bouwt de URL’s die het aan formbase doorgeeft uit zijn eigen instellingen, niet uit het adres in je browser. Stel deze omgevingsvariabelen in op de n8n-container of het proces:

  • WEBHOOK_URL: het openbare HTTPS-adres, met een afsluitende schuine streep, zoals https://n8n.example.com/. n8n bouwt hieruit de URL van een gepubliceerde trigger en de resume-URL van Wait for the Outcome.

  • N8N_EDITOR_BASE_URL: hetzelfde adres. n8n bouwt hieruit de test-URL van een trigger voor Execute step, en de OAuth Redirect URL van de formbase-credential.

  • N8N_PROXY_HOPS: zet hem op 1 wanneer n8n achter één reverse proxy of tunnel draait, zodat n8n de forwarded headers van de proxy leest.

Met Docker ziet dat er zo uit:

bash
docker run -d --name n8n -p 5678:5678 \
  -e WEBHOOK_URL=https://n8n.example.com/ \
  -e N8N_EDITOR_BASE_URL=https://n8n.example.com/ \
  -e N8N_PROXY_HOPS=1 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Bij docker compose of een npm-installatie stel je dezelfde variabelen in de omgeving van n8n in. Richt je proxy of tunnel op poort 5678, laat /webhook/, /webhook-test/ en /webhook-waiting/ ongewijzigd doorgaan, en open n8n vanaf dan via het openbare adres.

2. Installeer de community node

Open Settings › Community nodes en klik op Install. Typ n8n-nodes-formbase onder npm Package Name, vink het vakje aan dat zegt dat je de risico’s van het installeren van ongeverifieerde code begrijpt, en klik op Install.

De dialoog Install community nodes: npm Package Name n8n-nodes-formbase, het risicovakje aangevinkt, en een Install-knop

Na een paar seconden verschijnt het package in de lijst met zijn twee nodes:

Settings › Community nodes met n8n-nodes-formbase, versie 0.10.1, met 2 nodes: formbase, formbase Trigger

Werk het package bij of verwijder het vanuit dezelfde lijst. Als Community nodes ontbreekt in Settings, is je n8n gestart met N8N_COMMUNITY_PACKAGES_ENABLED=false; verwijder die instelling.

n8n Cloud

Nog niet beschikbaar op n8n Cloud

n8n Cloud installeert alleen community nodes die n8n heeft geverifieerd, en de formbase-node is nog niet geverifieerd. Gebruik tot die tijd een zelf gehoste n8n, of roep de REST API aan vanuit een HTTP Request-node. Een Cloud-instantie heeft al een openbaar HTTPS-adres, dus zodra de node daar beschikbaar is, veranderen alleen de installatiestappen op deze pagina.

Controleer de node

Open een workflow, klik op + en zoek naar formbase. De nodedetails tonen zes acties en zes triggers:

De nodedetails van formbase, gemarkeerd als Installed, met Actions (6): Cancel request, Create request, Get request, Get many requests, Remind request recipient en Replay request callback, en een ingeklapte sectie Triggers (6)

  • formbase Trigger start een workflow bij een inzending via de openbare link die wordt aangemaakt, bewerkt of afgebroken, of bij een aanvraag die wordt voltooid, verloopt of wordt geannuleerd.

  • formbase maakt een aanvraag aan, haalt er één of meerdere op, herinnert de ontvanger, annuleert een aanvraag, en speelt de callback ervan opnieuw af.

Volgende

formbase met n8n verbindenMaak de credential aan, log in, en kies de werkruimte.Alle handleidingen