Formstep

Captura un correo y envía un formulario prellenado desde HubSpot con n8n

Los visitantes dejan su correo en un formulario de una sola pregunta. n8n los busca en HubSpot y les envía un segundo formulario de Formstep con su nombre y empresa ya rellenados, así que solo lo revisan y añaden el resto. Importa el flujo de abajo y elige tus dos formularios.

Publicado · Actualizado

Recoger un correo es fácil. El formulario más largo que viene después es más difícil: tiene que llegar ya rellenado con lo que sabe tu CRM, y solo esa persona debe poder abrirlo. El formulario propio de n8n lee su prellenado desde la URL, así que cualquiera con el enlace puede verlo y cambiarlo.

Formstep llama solicitud a ese formulario personal: un formulario enviado a una sola persona, por un enlace privado, con las respuestas que ya conoces rellenadas.

En resumen: El Formstep Trigger captura cada correo de un formulario público, HubSpot aporta el nombre y la empresa, y una solicitud de Formstep envía a esa persona un segundo formulario prellenado. Obtén el JSON del flujo.

Qué necesitas

  • Un n8n autoalojado con el nodo de comunidad de Formstep, instalado y conectado.
  • Un token de app privada de HubSpot que pueda leer contactos.
  • Dos formularios de Formstep publicados: un formulario público con una pregunta de correo con clave email, y la plantilla Client Onboarding.
  • Opcional: la integración de HubSpot en el segundo formulario, para actualizar el contacto cuando responda.

Cómo funciona el flujo de n8n, paso a paso

El flujo en el editor de n8n: New email on the public form, Find the contact in HubSpot, Shape the prefill y Send the second form, en una fila
El flujo importado en n8n 2.46: cuatro nodos, del formulario público al segundo formulario prellenado. Selecciónala para verla en tamaño completo.

1. New email on the public form

Alguien envía tu formulario de una pregunta. El Formstep Trigger inicia el flujo con su respuesta en email.

2. Find the contact in HubSpot

Un nodo HTTP Request busca ese correo en tus contactos de HubSpot y devuelve la coincidencia, si la hay.

3. Shape the prefill

Un nodo Code convierte el contacto en respuestas del formulario, full_name y company_name. Un lead nuevo sin coincidencia recibe igualmente el formulario, con menos datos rellenados.

4. Send the second form

El nodo de Formstep crea una solicitud: el formulario Client Onboarding, enviado al mismo correo, con email bloqueado para que no se pueda cambiar.

5. They check it and finish it

La persona abre su enlace privado, corrige lo que esté desactualizado y responde el resto. No necesita cuenta.

6. Get the answers back

La integración de HubSpot del segundo formulario actualiza el contacto. Para hacer más, inicia otro flujo con el disparador Request Completed.

Importa el flujo de n8n

Pégalo en un lienzo de n8n con Ctrl+V (Cmd+V en Mac), o descarga el archivo y usa Import from File. Luego elige tus credenciales y formularios en los nodos marcados con una advertencia.

Descargar el archivo
Mostrar el JSON
{
  "name": "Formstep: public form to a CRM-prefilled request",
  "nodes": [
    {
      "parameters": {
        "content": "## Public form to a CRM-prefilled request\n\n1. **New email on the public form**: pick your short public form. It needs an email question with the field key `email`.\n2. **Find the contact in HubSpot**: pick a HubSpot App Token credential with the `crm.objects.contacts.read` scope.\n3. **Send the second form**: pick your Formstep credential and the published Client Onboarding form.\n\nDelivery is Email the Invitation, which needs Formstep Pro or Business. On Free, set it to None and send the request's `url` from a node of your own.\n\nTest Mode is on, so nothing is emailed. Turn it off before you publish.",
        "height": 360,
        "width": 620,
        "color": 5
      },
      "type": "n8n-nodes-base.stickyNote",
      "typeVersion": 1,
      "position": [
        -40,
        -360
      ],
      "id": "2f0a6c1e-1000-4000-8000-000000000001",
      "name": "How to set it up"
    },
    {
      "parameters": {
        "formId": {
          "__rl": true,
          "mode": "list",
          "value": ""
        },
        "event": "submission_created"
      },
      "type": "n8n-nodes-formstep.formstepTrigger",
      "typeVersion": 1.2,
      "position": [
        0,
        0
      ],
      "id": "2f0a6c1e-1000-4000-8000-000000000002",
      "name": "New email on the public form"
    },
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.hubapi.com/crm/v3/objects/contacts/search",
        "authentication": "predefinedCredentialType",
        "nodeCredentialType": "hubspotAppToken",
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "={{ JSON.stringify({ filterGroups: [{ filters: [{ propertyName: 'email', operator: 'EQ', value: $json.data.answers.email }] }], properties: ['firstname', 'lastname', 'company'], limit: 1 }) }}",
        "options": {}
      },
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        240,
        0
      ],
      "id": "2f0a6c1e-1000-4000-8000-000000000003",
      "name": "Find the contact in HubSpot"
    },
    {
      "parameters": {
        "mode": "runOnceForEachItem",
        "jsCode": "// The first HubSpot match, or none: a new lead still gets the form, with less filled in.\nconst event = $('New email on the public form').item.json.data\nconst match = $json.results[0]\nconst contact = match ? match.properties : {}\nreturn {\n  json: {\n    email: event.answers.email,\n    first_name: contact.firstname ?? '',\n    full_name: [contact.firstname, contact.lastname].filter(Boolean).join(' '),\n    company_name: contact.company ?? '',\n    metadata: match ? { hubspotContactId: match.id } : {},\n    submission_id: event.submission.id,\n  },\n}"
      },
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        480,
        0
      ],
      "id": "2f0a6c1e-1000-4000-8000-000000000004",
      "name": "Shape the prefill"
    },
    {
      "parameters": {
        "resource": "request",
        "operation": "create",
        "formId": {
          "__rl": true,
          "mode": "list",
          "value": ""
        },
        "recipientEmail": "={{ $json.email }}",
        "fields": {
          "mappingMode": "defineBelow",
          "value": {
            "full_name": "={{ $json.full_name }}",
            "email": "={{ $json.email }}",
            "company_name": "={{ $json.company_name }}"
          },
          "matchingColumns": [],
          "schema": [
            {
              "id": "full_name",
              "displayName": "Full Name (full_name)",
              "required": false,
              "defaultMatch": false,
              "canBeUsedToMatch": false,
              "display": true,
              "type": "string"
            },
            {
              "id": "email",
              "displayName": "Email Address (email)",
              "required": false,
              "defaultMatch": false,
              "canBeUsedToMatch": false,
              "display": true,
              "type": "string"
            },
            {
              "id": "company_name",
              "displayName": "Company (company_name)",
              "required": false,
              "defaultMatch": false,
              "canBeUsedToMatch": false,
              "display": true,
              "type": "string"
            }
          ],
          "attemptToConvertTypes": false,
          "convertFieldsToString": false
        },
        "readonly": [
          "email"
        ],
        "waitForOutcome": false,
        "additionalFields": {
          "delivery": "email",
          "recipientName": "={{ $json.first_name }}",
          "externalId": "=signup-{{ $json.submission_id }}",
          "metadata": "={{ JSON.stringify($json.metadata) }}",
          "test": true
        }
      },
      "type": "n8n-nodes-formstep.formstep",
      "typeVersion": 5,
      "position": [
        720,
        0
      ],
      "id": "2f0a6c1e-1000-4000-8000-000000000005",
      "name": "Send the second form"
    }
  ],
  "pinData": {},
  "connections": {
    "New email on the public form": {
      "main": [
        [
          {
            "node": "Find the contact in HubSpot",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Find the contact in HubSpot": {
      "main": [
        [
          {
            "node": "Shape the prefill",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Shape the prefill": {
      "main": [
        [
          {
            "node": "Send the second form",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "active": false,
  "settings": {
    "executionOrder": "v1"
  },
  "meta": {
    "templateCredsSetupCompleted": false
  },
  "tags": []
}

Necesita el nodo de comunidad n8n-nodes-formstep en un n8n autoalojado al que Formstep pueda acceder por HTTPS: instálalo y conéctalo. Comprobado en n8n 2.46 con la versión 0.15.0 del nodo.

Por qué usar Formstep en este paso

  • Cada persona recibe su propio formulario. Los datos prellenados viajan en un enlace privado enviado a una sola dirección de correo. Nadie más puede abrir el formulario ni ver lo que HubSpot sabe.
  • El ID del contacto de HubSpot vuelve con las respuestas. Se guarda en la solicitud como metadatos, que el formulario nunca muestra, así que el siguiente paso actualiza el contacto correcto sin volver a buscar.
  • Reformular una pregunta no rompe nada. Las respuestas llegan bajo claves de campo fijas, así que {{ $json.data.answers.company_name }} sigue funcionando cuando cambias el título de la pregunta o la traduces.

Más plantillas de flujos de trabajo

Preguntas sobre este flujo de trabajo

¿Algo más en mente? La documentación cubre cada configuración, y respondemos los correos.

Tal como está, no: n8n Cloud solo instala nodos de comunidad verificados y el nodo de Formstep aún no lo está. En n8n Cloud, llama a la API REST de Formstep desde nodos HTTP Request.

Sí. Cambia la petición a HubSpot por el nodo de tu CRM y mantén igual la salida del nodo Code. Para escribir las respuestas de vuelta hace falta un disparador Request Completed.

El endpoint de búsqueda de HubSpot encuentra por correo y devuelve solo los campos que el formulario necesita, en una sola llamada. El nodo de HubSpot también sirve, si el nodo Code recibe los mismos campos.

El segundo formulario va a esa dirección, así que solo su dueño ve lo que HubSpot sabe. Nunca redirijas el formulario público al enlace de la solicitud.

El modo de prueba (Test Mode) está activado en el flujo importado: el enlace de la solicitud funciona, pero no se envía ningún correo y nada cuenta. Abre la url de la salida del nodo para ver el formulario.

Recopila información de cualquier persona.

Publica un formulario de ejemplo, respóndelo como lo haría tu destinatario y mira cómo llegan las respuestas. Sin necesidad de cuenta.

Lee la documentación