Formstep

E-Mail erfassen, dann ein aus HubSpot vorausgefülltes Formular mit n8n senden

Besucher hinterlassen ihre E-Mail in einem Formular mit einer einzigen Frage. n8n sucht sie in HubSpot und sendet ihnen ein zweites Formstep-Formular, in dem Name und Firma schon eingetragen sind, sodass sie es nur prüfen und den Rest ergänzen. Importieren Sie den Workflow unten und wählen Sie Ihre beiden Formulare.

Veröffentlicht · Aktualisiert

Eine E-Mail zu erfassen ist einfach. Schwieriger ist das längere Formular, das danach kommt: Es soll bereits mit dem ausgefüllt sein, was Ihr CRM weiß, und nur diese eine Person soll es öffnen können. Das eigene Formular von n8n liest seine Vorausfüllung aus der URL, also kann jeder mit dem Link sie sehen und ändern.

Formstep nennt dieses persönliche Formular eine Anfrage: ein Formular, das über einen privaten Link an eine Person geht, mit den Antworten vorausgefüllt, die Sie schon kennen.

Kurz gesagt: Der Formstep Trigger fängt jede E-Mail aus einem öffentlichen Formular ab, HubSpot liefert Name und Firma, und eine Formstep-Anfrage sendet der Person ein vorausgefülltes zweites Formular. Workflow-JSON herunterladen.

Was Sie brauchen

  • Ein selbst gehostetes n8n mit dem Formstep Community Node, installiert und verbunden.
  • Ein Token einer privaten HubSpot-App, das Kontakte lesen darf.
  • Zwei veröffentlichte Formstep-Formulare: ein öffentliches Formular mit einer E-Mail-Frage mit dem Schlüssel email und die Vorlage für Client-Onboarding.
  • Optional: die HubSpot-Integration am zweiten Formular, um den Kontakt bei der Antwort zu aktualisieren.

So funktioniert der n8n-Workflow, Schritt für Schritt

Der Workflow im n8n-Editor: New email on the public form, Find the contact in HubSpot, Shape the prefill und Send the second form in einer Reihe
Der importierte Workflow in n8n 2.46: vier Nodes, vom öffentlichen Formular bis zum vorausgefüllten zweiten Formular. Wählen Sie es aus, um es in voller Größe zu sehen.

1. New email on the public form

Jemand sendet Ihr Formular mit einer Frage ab. Der Formstep Trigger startet den Workflow mit der Antwort unter email.

2. Find the contact in HubSpot

Ein HTTP-Request-Node sucht in Ihren HubSpot-Kontakten nach dieser E-Mail und liefert den Treffer, falls es einen gibt.

3. Shape the prefill

Ein Code-Node macht aus dem Kontakt Formularantworten, full_name und company_name. Auch ein neuer Lead ohne Treffer bekommt das Formular, nur weniger ausgefüllt.

4. Send the second form

Der Formstep-Node erstellt eine Anfrage: das Client-Onboarding-Formular, gesendet an dieselbe E-Mail-Adresse, mit gesperrtem Feld email, damit es sich nicht ändern lässt.

5. They check it and finish it

Die Person öffnet ihren privaten Link, korrigiert Veraltetes und beantwortet den Rest. Ein Konto braucht sie dafür nicht.

6. Get the answers back

Die HubSpot-Integration am zweiten Formular aktualisiert den Kontakt. Für mehr starten Sie einen weiteren Workflow mit dem Trigger Request Completed.

Den n8n-Workflow importieren

Fügen Sie ihn mit Strg+V (Cmd+V auf dem Mac) in eine n8n-Arbeitsfläche ein, oder laden Sie die Datei herunter und nutzen Sie Import from File. Wählen Sie dann in den mit einer Warnung markierten Nodes Ihre Zugangsdaten und Formulare.

Datei herunterladen
JSON anzeigen
{
  "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": []
}

Er braucht den Community-Node n8n-nodes-formstep auf einer selbst gehosteten n8n-Instanz, die Formstep über HTTPS erreichen kann: installieren Sie ihn und verbinden Sie ihn. Geprüft in n8n 2.46 mit Version 0.15.0 des Nodes.

Warum Formstep für diesen Schritt

  • Jede Person bekommt ihr eigenes Formular. Die vorausgefüllten Angaben stecken in einem privaten Link, der an eine E-Mail-Adresse geht. Niemand sonst kann das Formular öffnen oder sehen, was HubSpot weiß.
  • Die HubSpot-Kontakt-ID kommt mit den Antworten zurück. Sie wird an der Anfrage als Metadaten gespeichert, die das Formular nie anzeigt. So aktualisiert der nächste Schritt den richtigen Kontakt, ohne erneut zu suchen.
  • Eine umformulierte Frage macht nichts kaputt. Antworten kommen unter festen Feldschlüsseln an. {{ $json.data.answers.company_name }} funktioniert also weiter, wenn Sie die Frage umbenennen oder übersetzen.

Weitere Workflow-Vorlagen

Fragen zu diesem Workflow

Noch etwas auf dem Herzen? Die Dokumentation behandelt jede Einstellung, und wir antworten auf E-Mails.

Dokumentation lesen

Nicht so, wie er ist: n8n Cloud installiert nur verifizierte Community Nodes, und der Formstep-Node ist noch nicht verifiziert. Rufen Sie in n8n Cloud die Formstep-REST-API aus HTTP-Request-Nodes auf.

Ja. Tauschen Sie die HubSpot-Abfrage gegen den Node Ihres CRM und lassen Sie die Ausgabe des Code-Nodes gleich. Zum Zurückschreiben der Antworten brauchen Sie dann einen Request-Completed-Trigger.

Der Such-Endpunkt von HubSpot gleicht per E-Mail ab und liefert in einem Aufruf nur die Felder, die das Formular braucht. Der HubSpot-Node funktioniert auch, wenn der Code-Node dieselben Felder erhält.

Das zweite Formular geht an diese Adresse, sodass nur ihr Inhaber sieht, was HubSpot weiß. Leiten Sie das öffentliche Formular nie auf den Anfrage-Link weiter.

Im importierten Workflow ist Test Mode an: Der Anfrage-Link funktioniert, aber es wird nichts per E-Mail gesendet und nichts zählt. Öffnen Sie die URL in der Ausgabe des Nodes, um das Formular zu sehen.

Holen Sie Informationen von jedem ein.

Veröffentlichen Sie ein Beispielformular, füllen Sie es aus wie Ihr Empfänger und sehen Sie, wie die Antworten zurückkommen. Kein Konto nötig.

Dokumentation lesen