# Instala el nodo de formbase en n8n

Dale a un n8n autoalojado una dirección HTTPS pública, instala el nodo comunitario n8n-nodes-formbase, y comprueba que sus disparadores y acciones aparecen.

## 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.

<p>
  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.
</p>

<h2 id="before-you-start">Antes de empezar</h2>

<ul>
  <li>n8n 2.30 o posterior. La credencial de formbase lo necesita.</li>
  <li>
    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.
  </li>
</ul>

<h2 id="self-hosted">n8n autoalojado</h2>

<p>Un n8n autoalojado necesita dos cosas antes de poder instalar el nodo:</p>

<ul>
  <li>
    La cuenta de propietario o una cuenta de administrador. Solo el propietario y los administradores pueden instalar nodos comunitarios.
  </li>
  <li>
    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{' '}
    <code>https://</code> en la internet pública. Un n8n accesible solo en <code>localhost</code> puede conectarse pero nunca recibe nada.
  </li>
</ul>

<h3 id="public-address">1. Dile a n8n su dirección pública</h3>

<p>
  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:
</p>

<ul>
  <li>
    <code>WEBHOOK_URL</code>: la dirección HTTPS pública, con una barra al final, como <code>https://n8n.example.com/</code>. n8n construye
    a partir de ella la URL de un disparador publicado y la URL de reanudación de{' '}
    <a href="/es/guides/n8n/request-outcome#wait-for-the-outcome">Wait for the Outcome</a>.
  </li>
  <li>
    <code>N8N_EDITOR_BASE_URL</code>: la misma dirección. n8n construye a partir de ella la URL de prueba de un disparador para{' '}
    <strong>Execute step</strong>, y la <strong>OAuth Redirect URL</strong> de la credencial de formbase.
  </li>
  <li>
    <code>N8N_PROXY_HOPS</code>: configúrala en <code>1</code> cuando n8n se ejecuta detrás de un proxy inverso o túnel, para que n8n lea
    las cabeceras reenviadas del proxy.
  </li>
</ul>

<p>Con Docker, se ve así:</p>

```
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
```

<p>
  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{' '}
  <code>5678</code>, deja pasar <code>/webhook/</code>, <code>/webhook-test/</code> y <code>/webhook-waiting/</code> sin cambios, y a partir
  de entonces abre n8n a través de la dirección pública.
</p>

> ⚠️ **VALIDATION_ERROR: targetUrl must use https**
> <p>
>     formbase se niega a enviar eventos a una URL <code>http://</code> o a una dirección de red privada. Si un disparador muestra este error{' '}
>     en <strong>Execute step</strong>, falta configurar <code>N8N_EDITOR_BASE_URL</code>; en <strong>Publish</strong>, falta{' '}
>     <code>WEBHOOK_URL</code>. Configura esa variable, reinicia n8n, e inténtalo de nuevo. Si cambias <code>WEBHOOK_URL</code> más adelante,
>     despublica y vuelve a publicar cada flujo de trabajo de formbase para que su disparador registre la nueva dirección.
>   </p>

<h3 id="install">2. Instala el nodo comunitario</h3>

<p>
  Abre <strong>Settings</strong> › <strong>Community nodes</strong> y haz clic en <strong>Install</strong>. Escribe{' '}
  <code>n8n-nodes-formbase</code> bajo <strong>npm Package Name</strong>, marca la casilla que dice que entiendes los riesgos de instalar
  código sin verificar, y haz clic en <strong>Install</strong>.
</p>

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

<p>
  Actualiza o desinstala el paquete desde la misma lista. Si <strong>Community nodes</strong> no aparece en Settings, tu n8n se inició con{' '}
  <code>N8N_COMMUNITY_PACKAGES_ENABLED=false</code>; elimina ese ajuste.
</p>

<h2 id="n8n-cloud">n8n Cloud</h2>

> ℹ️ **Aún no disponible en n8n Cloud**
> <p>
>     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 <a href="/es/guides/rest-api/send-a-request">API REST</a> desde un nodo <strong>HTTP Request</strong>. 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.
>   </p>

<h2 id="check">Comprueba el nodo</h2>

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

<ul>
  <li>
    <strong>formbase Trigger</strong> 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.
  </li>
  <li>
    <strong>formbase</strong> crea una solicitud, obtiene una o varias, recuerda al destinatario, cancela una solicitud, y reproduce de
    nuevo su callback.
  </li>
</ul>

<h2 id="next">Siguiente</h2>

<div class="not-prose grid gap-3 sm:grid-cols-2 mb-8">
  - [Conecta formbase a n8n](/es/guides/n8n/connect) — Crea la credencial, inicia sesión, y elige el espacio de trabajo.
  - [Todas las guías](/es/guides/overview)
</div>