formbasedocs
Ir a la appApp

Guías · n8n (autoalojado)

Inicia un flujo de trabajo de n8n desde envíos por enlace público

Esta guía construye un flujo de trabajo de dos nodos: un envío nuevo a un formulario de incorporación de proveedores llega a un formbase Trigger, y un nodo Edit Fields extrae las respuestas. Pon tu nodo de correo, Sheets, Slack o CRM después de él.

Last checked


Necesitas una credencial de formbase en n8n y un formulario publicado con un enlace de compartir. Tu n8n debe ser accesible desde internet por HTTPS; consulta Instala el nodo de formbase en n8n. Un envío a un enlace de solicitud no inicia estos flujos de trabajo; consulta Actúa según el resultado de una solicitud en n8n para eso.

1. Añade el disparador

Crea un flujo de trabajo, haz clic en +, busca formbase y elige formbase Trigger. Elige la credencial, el formulario, y uno de los tres eventos de enlace público bajo Event:

El desplegable Event del formbase Trigger abierto: Public Link Submission Created, Updated y Abandoned, luego Request Completed, Expired y Canceled, cada uno con una breve descripción
EventSe ejecuta cuandoNecesita
Public Link Submission CreatedUn respondente envía el formulario a través de un enlace de compartir.Nada más.
Public Link Submission UpdatedUn respondente edita un envío que ya mandó.Editar después de enviar activado para el formulario.
Public Link Submission AbandonedUn respondente deja el formulario sin terminar durante el tiempo fijado bajo Consider Abandoned After (12 horas a 1 semana). formbase comprueba una vez por hora, así que la ejecución puede llegar hasta una hora después.Un plan Pro o Business, que guarda envíos parciales.

2. Escucha un evento de prueba

Haz clic en Execute step. El nodo muestra Listening for test event, y formbase empieza a enviar los eventos de este formulario a la URL de prueba del nodo durante dos minutos. Abre el enlace de compartir del formulario en otra pestaña y envíalo en ese tiempo. El envío llega al nodo en cuestión de segundos:

El formbase Trigger después de un evento de prueba: Form [Guide] Supplier onboarding, Event Public Link Submission Created, y la salida con id, type submission.completed, test false y data › answers con company_name Nordlys Tekstil AS, contact_email, vat_number, la respuesta de condiciones de pago yes, y el archivo de certificado subido

n8n no tiene un registro de muestra: la prueba es un envío real, y test es false. Cada respuesta aparece dos veces:

  • data.answers guarda el valor que compara un flujo de trabajo, bajo la clave de campo de la pregunta: una clave de opción como yes, un número, una fecha, o una lista de archivos.

  • data.display guarda el texto que lee una persona, como Yes.

Usa display en mensajes y answers en condiciones. Consulta la referencia de webhooks para ambos.

Los envíos abandonados llegan horas después, así que Execute step no puede capturar uno. Para ese evento, publica el flujo de trabajo y comprueba Executions.

3. Extrae las respuestas

Añade un nodo Edit Fields (Set) después del disparador. Arrastra respuestas desde el panel de entrada a Fields to Set, o escribe tú mismo las expresiones:

Un nodo Edit Fields con tres campos: company desde $json.data.answers.company_name, email desde $json.data.answers.contact_email, y payment_terms desde $json.data.display.do_you_accept_our_30_day_payment_terms, con la salida Nordlys Tekstil AS, grace@nordlys.example y Yes
payment_terms lee de display, así que guarda la etiqueta Yes en lugar de la clave de opción yes.

El siguiente nodo, digamos Gmail o Google Sheets, lee {{ $json.company }} y los demás campos desde aquí. Cuando se renombra una pregunta, su clave de campo se mantiene igual, así que estas expresiones siguen funcionando.

4. Publica y comprueba una ejecución real

Haz clic en Publish, dale un nombre a la versión, y confirma. formbase ahora envía cada envío nuevo a la URL de producción del flujo de trabajo. Despublicar el flujo de trabajo detiene eso.

Envía el formulario una vez más y abre la pestaña Executions. La ejecución aparece en cuestión de segundos. Las ejecuciones que iniciaste con Execute step llevan un icono de matraz; una ejecución de producción no tiene ninguno:

La pestaña Executions del flujo de trabajo publicado: la ejecución más reciente Succeeded en 51ms sin icono de matraz, tres ejecuciones de prueba anteriores con icono de matraz, y el lienzo mostrando formbase Trigger pasando 1 elemento a Edit Fields

Si el flujo de trabajo no se inicia

  • El formulario se envió a través de un enlace de solicitud. Eso ejecuta Request Completed, no Public Link Submission Created.

  • El flujo de trabajo no está publicado. Solo Execute step escucha mientras el flujo de trabajo es un borrador, y solo hasta que llega el primer evento o pasan dos minutos.

  • El disparador muestra targetUrl must use https.

    Tu n8n entrega una URL http:// o privada. Consulta Dile a n8n su dirección pública.

  • La credencial llega a otro espacio de trabajo. El disparador escucha el formulario en el espacio de trabajo al que apunta su credencial.

Comprobar la firma

El formbase Trigger comprueba la cabecera X-formbase-Signature de cada evento y rechaza los que fallan. Mantén el reloj del host de n8n en hora: un evento firmado hace más de cinco minutos también se rechaza.

Siguiente