formbasedocs
Aller à l'applicationAppli

Guides · n8n (auto-hébergé)

Installer le nœud formbase dans n8n

formbase pour n8n est un nœud communautaire, publié sur npm sous le nom n8n-nodes-formbase. Ce guide l'installe sur un n8n auto-hébergé et définit l'adresse que formbase utilise pour joindre vos workflows.

Last checked

Chaque guide n8n a été vérifié sur un n8n auto-hébergé 2.40, s’exécutant dans Docker, avec la version 0.10.1 du nœud. Tout ce qui dépend de l’endroit où n8n s’exécute se trouve sur cette page. Les autres guides fonctionnent de la même façon une fois le nœud installé.

Avant de commencer

  • n8n 2.30 ou version ultérieure. Le credential formbase en a besoin.

  • Un compte formbase. Tout ce que ces guides couvrent fonctionne sur le plan Free, sauf les invitations par e-mail, les rappels et les soumissions abandonnées, qui nécessitent Pro ou Business.

n8n auto-hébergé

Un n8n auto-hébergé a besoin de deux choses avant de pouvoir installer le nœud :

  • Le compte propriétaire ou un compte administrateur. Seuls le propriétaire et les administrateurs peuvent installer des nœuds communautaires.

  • Une adresse HTTPS publique, via un proxy inverse ou un tunnel. formbase n’envoie les événements et les callbacks de demande qu’à des URL en https:// sur l’internet public. Un n8n accessible uniquement sur localhost peut se connecter mais ne reçoit jamais rien.

1. Indiquez à n8n son adresse publique

n8n construit les URL qu’il transmet à formbase à partir de ses propres réglages, pas de l’adresse dans votre navigateur. Définissez ces variables d’environnement sur le conteneur ou le processus n8n :

  • WEBHOOK_URL : l’adresse HTTPS publique, avec une barre oblique finale, comme https://n8n.example.com/. n8n en tire l’URL d’un déclencheur publié et l’URL de reprise de Wait for the Outcome.

  • N8N_EDITOR_BASE_URL : la même adresse. n8n en tire l’URL de test d’un déclencheur pour Execute step, ainsi que l’OAuth Redirect URL du credential formbase.

  • N8N_PROXY_HOPS : mettez-le à 1 quand n8n s’exécute derrière un seul proxy inverse ou tunnel, pour que n8n lise les en-têtes transmis par le proxy.

Avec Docker, cela ressemble à ceci :

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

Avec docker compose ou une installation npm, définissez les mêmes variables dans l’environnement de n8n. Pointez votre proxy ou tunnel vers le port 5678, laissez passer /webhook/, /webhook-test/ et /webhook-waiting/ sans les modifier, et ouvrez n8n via l’adresse publique à partir de là.

2. Installez le nœud communautaire

Ouvrez Settings › Community nodes et cliquez sur Install. Tapez n8n-nodes-formbase sous npm Package Name, cochez la case indiquant que vous comprenez les risques liés à l’installation de code non vérifié, et cliquez sur Install.

La boîte de dialogue Install community nodes : npm Package Name n8n-nodes-formbase, la case de risque cochée, et un bouton Install

Après quelques secondes, le package apparaît dans la liste avec ses deux nœuds :

Settings › Community nodes listant n8n-nodes-formbase, version 0.10.1, avec 2 nœuds : formbase, formbase Trigger

Mettez à jour ou désinstallez le package depuis la même liste. Si Community nodes est absent de Settings, votre n8n a été démarré avec N8N_COMMUNITY_PACKAGES_ENABLED=false ; retirez ce réglage.

n8n Cloud

Pas encore disponible sur n8n Cloud

n8n Cloud n’installe que les nœuds communautaires vérifiés par n8n, et le nœud formbase ne l’est pas encore. En attendant, utilisez un n8n auto-hébergé, ou appelez l’API REST depuis un nœud HTTP Request. Une instance Cloud a déjà une adresse HTTPS publique, donc une fois le nœud disponible là-bas, seules les étapes d’installation de cette page changent.

Vérifiez le nœud

Ouvrez un workflow, cliquez sur + et cherchez formbase. Les détails du nœud montrent six actions et six déclencheurs :

Les détails du nœud formbase, marqué Installed, avec Actions (6) : Cancel request, Create request, Get request, Get many requests, Remind request recipient et Replay request callback, et une section Triggers (6) repliée

  • formbase Trigger démarre un workflow sur une soumission par lien public créée, modifiée ou abandonnée, ou sur une demande terminée, expirée ou annulée.

  • formbase crée une demande, en récupère une ou plusieurs, relance le destinataire, annule une demande, et rejoue son callback.

Suite

Connecter formbase à n8nCréez le credential, connectez-vous, et choisissez l'espace de travail.Tous les guides