Fügen Sie mit Firma.dev E-Signaturen zu jedem n8n-Workflow hinzu

n8n ist der Ort, an dem viele Teams bereits ihre Vertragslogik ausführen: Ein Formular geht ein, ein Deal wechselt die Phase, ein Verlängerungsdatum steht an und ein Workflow wird ausgelöst. Das fehlende Bindeglied ist meist die Unterschrift selbst. Mit Firma.dev fügen Sie einfach einen HTTP Request-Node in einen beliebigen Workflow ein, hinterlegen Ihren API-Schlüssel einmalig und senden rechtsgültige elektronische Signaturen, ohne n8n zu verlassen.

Da Firma.dev pro Umschlag 0,049 € (~5¢ USD) abrechnet, ohne feste Benutzerlizenzen (Seats) oder monatliche Mindestumsätze, eignet es sich besonders gut für den automatisierten Versand. Wenn ein Workflow über Nacht fünfzig Verlängerungsverträge herausschickt, zahlen Sie für fünfzig Umschläge und nicht für ein teureres Paket, in das Sie erst hineingewachsen sind. Das ist der Unterschied zwischen einer Automatisierung, die Geld spart, und einer, die heimlich die Kosten in die Höhe treibt.

Dieser Beitrag stellt drei Wege vor, um Firma.dev in n8n einzubinden: den HTTP Request-Node für den Versand, einen Webhook-Trigger zur Reaktion auf unterzeichnete Dokumente und Firma.dev als Tool für den n8n AI Agent.

Pfad 1: Senden mit dem HTTP Request-Node

Dies ist der Pfad, den die meisten Workflows benötigen. Sie hinterlegen Ihren Firma.dev-API-Schlüssel einmalig als Zugangsdaten (Credential), sodass jeder HTTP Request-Node in jedem Workflow ihn wiederverwenden kann.

Erstellen Sie zuerst die Zugangsdaten. Öffnen Sie im n8n-Editor das Menü Credentials, klicken Sie auf Add Credential und wählen Sie Header Auth. Benennen Sie die Zugangsdaten als Firma API, setzen Sie den Header-Name auf Authorization und fügen Sie Ihren Firma.dev-API-Schlüssel als Value ein. n8n verschlüsselt die Zugangsdaten mit Ihrem Instanz-Schlüssel, sodass der Schlüssel beim Exportieren des Workflows als JSON nicht im Klartext erscheint. Fügen Sie den Schlüssel niemals direkt in ein Node-Feld ein.

Fügen Sie nun einen HTTP Request-Node hinzu und leiten Sie ihn an den Create-and-send-Endpunkt weiter, der eine Signaturanfrage aus einer Vorlage erstellt und in einem einzigen Aufruf versendet:

• Method: POST

• URL: https://api.firma.dev/functions/v1/signing-request-api/signing-requests/create-and-send

• Authentication: Generic Credential Type, Header Auth, unter Verwendung der Zugangsdaten Firma API

• Send Body: On, JSON

Der Body zieht Werte aus vorgeschalteten Nodes mittels n8n-Expressions:

{
  "template_id": "{{ $json.template_id }}",
  "recipients": [
    {
      "first_name": "{{ $json.signer_first_name }}",
      "last_name": "{{ $json.signer_last_name }}",
      "email": "{{ $json.signer_email }}",
      "designation": "Signer",
      "order": 1
    }
  ]
}

{
  "template_id": "{{ $json.template_id }}",
  "recipients": [
    {
      "first_name": "{{ $json.signer_first_name }}",
      "last_name": "{{ $json.signer_last_name }}",
      "email": "{{ $json.signer_email }}",
      "designation": "Signer",
      "order": 1
    }
  ]
}

{
  "template_id": "{{ $json.template_id }}",
  "recipients": [
    {
      "first_name": "{{ $json.signer_first_name }}",
      "last_name": "{{ $json.signer_last_name }}",
      "email": "{{ $json.signer_email }}",
      "designation": "Signer",
      "order": 1
    }
  ]
}

Verknüpfen Sie diesen Node mit dem Auslöser des Workflows. Ein Form-Trigger sendet einen Vertrag in dem Moment, in dem ein Kunde ein Formular absendet. Ein Webhook-Trigger löst die Anfrage aus, sobald Ihre App meldet, dass sich eine Deal-Phase geändert hat. Ein Schedule-Trigger führt nachts eine Stapelverarbeitung von Verlängerungen auf Basis einer Datenbankabfrage aus. Die Antwort enthält die id der neuen Signaturanfrage, sodass Sie diese protokollieren, speichern oder später darauf verweisen können.

Wenn Sie vor dem Versand eine manuelle Prüfung durch einen Menschen benötigen, erstellen Sie einen Entwurf mit POST /signing-requests, fügen Sie einen Approval-Node in der Mitte des Workflows ein und rufen Sie nach der Freigabe POST /signing-requests/{id}/send auf.

Pfad 2: Auf signierte Dokumente mit einem Webhook-Trigger reagieren

Das Senden ist nur die halbe Miete. Die andere Hälfte besteht darin, im selben Moment zu handeln, in dem ein Dokument unterzeichnet wird. Fügen Sie einen Webhook-Node als Trigger hinzu, setzen Sie die Methode auf POST und kopieren Sie die Produktions-URL. Fügen Sie im Firma.dev-Dashboard unter Settings → Webhooks diese URL hinzu und abonnieren Sie die gewünschten Ereignisse, beginnend mit signing_request.completed.

Fügen Sie zurück in n8n einen Switch-Node nach dem Trigger hinzu und leiten Sie den Pfad basierend auf {{ $json.body.type }} um. Eine abgeschlossene Signatur kann Ihr CRM aktualisieren und das Provisioning anstoßen. Eine abgelehnte Signatur kann den Vertrieb benachrichtigen. Eine abgelaufene Signatur kann das Dokument erneut senden oder den Deal auf "Verloren" setzen. Das signierte Dokument liegt unter {{ $json.body.data.signing_request.signed_document_url }}, sodass Sie es ohne Zwischenschritt direkt an einen Google Drive-, S3- oder Notion-Node übergeben und archivieren können.

Pfad 3: Firma.dev als Tool für den n8n AI Agent

Wenn Sie den AI Agent-Node nutzen, können Sie ihm Firma.dev als aufrufbares Tool übergeben und ihn selbst entscheiden lassen, wann eine Anfrage gesendet werden soll. Fügen Sie einen HTTP Request Tool-Node als Tool-Eingang hinzu, konfigurieren Sie ihn genau wie in Pfad 1 und benennen Sie das Tool als send_signing_request. Geben Sie ihm eine Beschreibung, die dem Agenten mitteilt, wann er es nutzen soll, und definieren Sie ein Eingabeschema mit template_id, signer_email, signer_first_name und signer_last_name. Der Agent sendet Verträge nun direkt auf Basis einer Anweisung in natürlicher Sprache. Kombinieren Sie dies mit einem zweiten Tool, das auf GET /templates verweist, wenn der Agent selbstständig die richtige Vorlage auswählen soll.

Signieren innerhalb einer anderen App

Wenn Ihr Prozess damit endet, dass der Unterzeichner das Dokument innerhalb Ihres eigenen Produkts statt per E-Mail ausfüllt, rufen Sie die signing_request_user_id des Empfängers aus der API-Antwort ab und binden Sie die Signatur-Benutzeroberfläche von Firma.dev ein:

<iframe
  src="https://app.firma.dev/signing/{signing_request_user_id}"
  style="width:100%;height:900px;border:0;"
  allow="camera;microphone;clipboard-write"
  title="Document Signing"
></iframe>

<iframe
  src="https://app.firma.dev/signing/{signing_request_user_id}"
  style="width:100%;height:900px;border:0;"
  allow="camera;microphone;clipboard-write"
  title="Document Signing"
></iframe>

<iframe
  src="https://app.firma.dev/signing/{signing_request_user_id}"
  style="width:100%;height:900px;border:0;"
  allow="camera;microphone;clipboard-write"
  title="Document Signing"
></iframe>

Alles läuft auf einer in der EU gehosteten Infrastruktur und erstellt ein vollständiges Audit-Protokoll, sodass die von Ihnen erstellte Automatisierung rechtssicher bleibt.

📘 Lesen Sie die vollständige n8n-Integrationsanleitung
Die komplette Einrichtung, einschließlich aller Node-Felder, Zugangsdaten-Details und Webhook-Ereignisse, finden Sie in der Dokumentation: https://docs.firma.dev/guides/n8n-integration

Erste Schritte

Sie können den ersten Pfad in der Zeit einrichten, die man zum Erstellen eines einzigen Zugangsdatums und eines Nodes benötigt. Starten Sie kostenlos mit Firma.dev, ohne Kreditkarte, und fügen Sie elektronische Signaturen zu den Workflows hinzu, die Sie bereits nutzen.