Einen Request aus einem n8n-Workflow senden

Du brauchst eine formbase-Credential in n8n und ein veröffentlichtes Formular. Was ein Request ist, und jede Option, die er bietet, steht in Einen Request erstellen; diese Anleitung zeigt, wo diese Optionen in n8n stehen.

1. Den Create-request-Node hinzufügen

Beginne mit dem Trigger, der den Request senden soll: eine neue Zeile in einer Tabelle, ein in deinem CRM gewonnener Deal, ein Zeitplan. Diese Anleitung nutzt einen manuellen Trigger und einen Edit Fields-Node namens Supplier, der supplier_id, company_name und contact_email trägt. Klicke danach auf +, such nach formbase, und wähle Create request.

2. Das Formular und die empfangende Person wählen

• Form ist das Formular, das die empfangende Person ausfüllt. Wähl es aus der Liste, oder wechsle zu ID und füg seine ID ein. Es muss veröffentlicht sein.

• Recipient Email kommt meist aus der Eingabe, wie {{ $json.contact_email }}. Sie wird für die E-Mail-Zustellung und für Erinnerungen gebraucht.

3. Vorausfüllen und sperren, was du schon weißt

Sobald du das Formular wählst, listet Values to Send jede Frage, die du vorausfüllen kannst, mit ihrem Titel und Feldschlüssel, wie Company name (company_name). Datei-Upload-, Unterschrift-, Zahlungs- und Termin-Fragen, berechnete Felder und Dokumente-Blöcke stehen nicht in der Liste: Diese liefert die empfangende Person oder das Formular. Ordne die Antworten zu, die du schon hast; leer gelassene Felder werden nicht gesendet. Die empfangende Person sieht die zugeordneten ausgefüllt.

Mapping Column Mode kann auch Map Automatically sein: Dann wird jedes Eingabefeld gesendet, das nach einem Feldschlüssel des Formulars benannt ist. Das passt zu einer Eingabe, die du für dieses Formular mit einem Edit-Fields-Node geformt hast.

Versteckte Felder des Formulars sind ebenfalls gelistet, markiert mit · context. Die empfangende Person kann sie nicht ändern und sieht sie nur dort, wo das Formular sie erwähnt. Siehe Prefill, gesperrte Felder und Kontext für den Unterschied.

Wähle eine Frage unter Read-Only Field Names or IDs, um sie zu sperren, sodass die empfangende Person sie sehen, aber nicht ändern kann. Eine gesperrte Frage muss auch vorausgefüllt sein. Hat das Formular einen Dokumente-Block, nimmt Documents Dateien aus einem Binärfeld der Eingabe.

4. Die Optionen hinzufügen, die du brauchst

Klicke auf Add Field unter Additional Fields:

• Delivery entscheidet, wer den Link versendet. Email the Invitation lässt formbase die Einladung und Erinnerungen senden, und braucht einen Pro- oder Business-Plan. None, die Vorgabe, sendet keine Einladung: Ein späterer Node sendet die url des Requests, per Slack, SMS oder deinem eigenen E-Mail-Tool.

• Lässt du Reminders weg, folgt es dem Erinnerungsplan des Formulars. Mit einer Recipient Email werden diese Erinnerungen per E-Mail versendet, auch wenn Delivery auf None steht. Füg Reminders hinzu und lass es leer, um keine zu senden, oder gib einen Zeitplan wie 2d, 5d ein, was Pro oder Business braucht.

• External ID ist deine eigene ID für dieses Stück Arbeit, wie supplier-{{ $json.supplier_id }}. Ein späterer Workflow kann den Request darüber finden. Sie ist auch der Idempotenzschlüssel: Führ den Node mit derselben External ID und denselben Parametern erneut aus, und du bekommst denselben Request zurück, mit deduplicated: true, nicht einen zweiten. Innerhalb von 30 Tagen schlägt dieselbe External ID mit einem geänderten Parameter, Test Mode eingeschlossen, fehl mit CONFLICT: Idempotency key … was already used for a different request.

• Test Mode erstellt einen Test-Request: Es wird nichts per E-Mail versendet, und er zählt nirgends.

• Recipient Name, Language, Expires At und Metadata sind optional. Ein Request läuft nach 30 Tagen ab, sofern du kein anderes Datum setzt, höchstens 365 Tage entfernt.

• Callback URL sendet das Ergebnis an eine eigene URL. Um das Ergebnis zurück in diesen Workflow zu bekommen, schalt stattdessen Wait for the Outcome ein.

5. Den Node ausführen

Klicke auf Execute step. formbase erstellt den Request und gibt ihn zurück: id, status pending, und url, den Link für die empfangende Person. Ordne {{ $json.url }} dem Node zu, der ihn versendet. deliveryStatus ist not_requested, wenn Delivery auf None steht, weil formbase nichts versendet hat.

Als Nächstes