Guías · n8n (autoalojado)

Instala el nodo de formbase en n8n

formbase para n8n es un nodo comunitario, publicado en npm como n8n-nodes-formbase. Esta guía lo instala en un n8n autoalojado y configura la dirección que usa formbase para llegar a tus flujos de trabajo.

Last checked September 28, 2026

Cada guía de n8n se comprobó en un n8n autoalojado 2.40, ejecutándose en Docker, con la versión 0.10.1 del nodo. Todo lo que depende de dónde se ejecuta n8n está en esta página. Las demás guías funcionan igual una vez instalado el nodo.

Antes de empezar

n8n 2.30 o posterior. La credencial de formbase lo necesita.
Una cuenta de formbase. Todo lo que hacen estas guías funciona en el plan Free, salvo las invitaciones por correo, los recordatorios y los envíos abandonados, que necesitan Pro o Business.

n8n autoalojado

Un n8n autoalojado necesita dos cosas antes de poder instalar el nodo:

La cuenta de propietario o una cuenta de administrador. Solo el propietario y los administradores pueden instalar nodos comunitarios.
Una dirección HTTPS pública, desde un proxy inverso o un túnel. formbase solo envía eventos y callbacks de solicitud a URLs https:// en la internet pública. Un n8n accesible solo en localhost puede conectarse pero nunca recibe nada.

1. Dile a n8n su dirección pública

n8n construye las URLs que entrega a formbase a partir de su propia configuración, no de la dirección de tu navegador. Configura estas variables de entorno en el contenedor o proceso de n8n:

WEBHOOK_URL: la dirección HTTPS pública, con una barra al final, como https://n8n.example.com/. n8n construye a partir de ella la URL de un disparador publicado y la URL de reanudación de Wait for the Outcome.
N8N_EDITOR_BASE_URL: la misma dirección. n8n construye a partir de ella la URL de prueba de un disparador para Execute step, y la OAuth Redirect URL de la credencial de formbase.
N8N_PROXY_HOPS: configúrala en 1 cuando n8n se ejecuta detrás de un proxy inverso o túnel, para que n8n lea las cabeceras reenviadas del proxy.

Con Docker, se ve así:

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

Con docker compose o una instalación con npm, configura las mismas variables en el entorno de n8n. Apunta tu proxy o túnel al puerto 5678, deja pasar /webhook/, /webhook-test/ y /webhook-waiting/ sin cambios, y a partir de entonces abre n8n a través de la dirección pública.

VALIDATION_ERROR: targetUrl must use https

formbase se niega a enviar eventos a una URL http:// o a una dirección de red privada. Si un disparador muestra este error en Execute step, falta configurar N8N_EDITOR_BASE_URL; en Publish, falta WEBHOOK_URL. Configura esa variable, reinicia n8n, e inténtalo de nuevo. Si cambias WEBHOOK_URL más adelante, despublica y vuelve a publicar cada flujo de trabajo de formbase para que su disparador registre la nueva dirección.

2. Instala el nodo comunitario

Abre Settings › Community nodes y haz clic en Install. Escribe n8n-nodes-formbase bajo npm Package Name, marca la casilla que dice que entiendes los riesgos de instalar código sin verificar, y haz clic en Install.

El diálogo Install community nodes: npm Package Name n8n-nodes-formbase, la casilla de riesgo marcada, y un botón Install

Al cabo de unos segundos el paquete aparece en la lista con sus dos nodos:

Settings › Community nodes listando n8n-nodes-formbase, versión 0.10.1, con 2 nodos: formbase, formbase Trigger

Actualiza o desinstala el paquete desde la misma lista. Si Community nodes no aparece en Settings, tu n8n se inició con N8N_COMMUNITY_PACKAGES_ENABLED=false; elimina ese ajuste.

n8n Cloud

Aún no disponible en n8n Cloud

n8n Cloud solo instala nodos comunitarios que n8n ha verificado, y el nodo de formbase aún no está verificado. Hasta entonces, usa un n8n autoalojado, o llama a la API REST desde un nodo HTTP Request. Una instancia Cloud ya tiene una dirección HTTPS pública, así que en cuanto el nodo esté disponible ahí, solo cambian los pasos de instalación de esta página.

Comprueba el nodo

Abre un flujo de trabajo, haz clic en + y busca formbase. Los detalles del nodo muestran seis acciones y seis disparadores:

Los detalles del nodo de formbase, marcados Installed, con Actions (6): Cancel request, Create request, Get request, Get many requests, Remind request recipient y Replay request callback, y una sección Triggers (6) colapsada

formbase Trigger inicia un flujo de trabajo cuando se crea, actualiza o abandona un envío por enlace público, o cuando una solicitud se completa, expira o se cancela.
formbase crea una solicitud, obtiene una o varias, recuerda al destinatario, cancela una solicitud, y reproduce de nuevo su callback.

Conecta formbase a n8nCrea la credencial, inicia sesión, y elige el espacio de trabajo.Todas las guías