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 wird erreicht und ein Workflow startet. Das fehlende Puzzleteil ist meistens die Unterschrift selbst. Firma.dev stellt nun einen dedizierten Community-Node n8n-nodes-firma mit 83 Operationen, einem Trigger, der seine eigenen Webhooks verwaltet, und einem integrierten Tool für den n8n AI Agent bereit, sodass Sie einen HTTP-Request-Node kaum noch manuell verkabeln müssen.

Da Firma.dev pro Umschlag 0,049 € (~5 ¢ USD) berechnet, ohne Arbeitsplätze und ohne monatliche Mindestbeträge, eignet es sich besonders gut für den automatisierten Versand. Wenn ein Workflow über Nacht fünfzig Verlängerungsverträge verschickt, zahlen Sie für fünfzig Umschläge und nicht für einen Tarif, in den Sie erst hineingewachsen sind. Das ist der Unterschied zwischen einer Automatisierung, die Geld spart, und einer Automatisierung, die stillschweigend die Rechnung in die Höhe treibt.

Dieser Beitrag beschreibt vier Möglichkeiten, Firma.dev in n8n einzubinden: den dedizierten Node zum Senden und Verwalten von Dokumenten, den Trigger-Node zum Reagieren auf unterzeichnete Verträge, Firma.dev als Tool für den AI Agent und eine manuelle Einrichtung mit Webhook plus HTTP Request, wenn Sie Community-Nodes ganz vermeiden möchten.

Weg 1: Installieren Sie den Firma.dev-Node

Dies ist der schnellste Weg, um Firma.dev in n8n zum Laufen zu bringen. Der Node übernimmt die Authentifizierung, die Formatierung der Anfragen und die Paginierung für Sie, mit Dropdown-Feldern anstelle von rohem JSON.

Klicken Sie im Workflow-Editor auf das +, um einen Node hinzuzufügen, suchen Sie nach „Firma“ und wählen Sie unter Community Nodes die Option Installieren. Der Node wird in einem Schritt installiert und auf Ihrer Arbeitsfläche platziert. Wenn Sie ihn lieber im Voraus installieren möchten, gehen Sie zu Einstellungen > Community-Nodes, klicken Sie auf Installieren und geben Sie n8n-nodes-firma ein. Self-Hosted-Instanzen können ihn auch manuell installieren:

cd ~/.n8n/nodes && npm install n8n-nodes-firma

cd ~/.n8n/nodes && npm install n8n-nodes-firma

cd ~/.n8n/nodes && npm install n8n-nodes-firma

Starten Sie n8n nach einer manuellen Installation neu.

Richten Sie als Nächstes die Anmeldedaten ein. Klicken Sie in der Seitenleiste auf Anmeldedaten, fügen Sie neue hinzu und suchen Sie nach Firma API. Sie benötigen Ihren API-Schlüssel aus den Workspace-Einstellungen > API und optional ein Webhook-Secret aus den Workspace-Einstellungen > Webhooks, wenn Sie eingehende Ereignisse später validieren möchten. Lassen Sie die Umgebung auf Production eingestellt.

Der Node deckt 83 Operationen für Ressourcen wie Signieranforderung, Vorlage, Webhook, Workspace, Unternehmen, Domain und E-Mail-Vorlage ab, sodass die meisten Workflows ihn nie verlassen müssen. Ein typischer Sendevorgang sieht so aus:

1. Fügen Sie einen Firma-Node hinzu und wählen Sie Ihre Firma API-Anmeldedaten aus

2. Setzen Sie Ressource auf Signing Request und Operation auf Create and Send

3. Setzen Sie die Dokumentenquelle auf Vorlage und geben Sie Ihre Vorlagen-ID ein

4. Fügen Sie unter Empfänger die E-Mail-Adresse, den Vornamen, die Bezeichnung und die Reihenfolge des Unterzeichners mithilfe von Ausdrücken wie {{ $json.signer_email }} hinzu

Die Antwort enthält die id der neuen Signieranforderung, die Sie protokollieren oder an nachfolgende Schritte übergeben können. Verwenden Sie für Genehmigungsprozesse die Create-Operation, um einen Entwurf zu speichern, fügen Sie einen Genehmigungs- oder Warteschritt ein und rufen Sie nach der Freigabe Send auf.

Eines sollten Sie beachten, bevor Sie dies in einen stark ausgelasteten Workflow einbinden: Die Schreiboperationen von Firma (Create, Create and Send, Send und Resend) enthalten keinen Idempotenzschlüssel. Wenn ein Node nach einer Zeitüberschreitung automatisch einen erneuten Versuch startet, kann es sein, dass Sie denselben Vertrag zweimal senden, und beide Kopien sind nach der Unterzeichnung rechtlich bindend. Deaktivieren Sie Retry On Fail bei diesen Operationen und wickeln Sie erneute Versuche bei Bedarf mit Ihrer eigenen Logik ab.

Weg 2: Reagieren Sie auf unterzeichnete Dokumente mit dem Firma Trigger-Node

Der Trigger-Node kann etwas, das ein generischer Webhook-Node nicht kann: Er registriert und deregistriert den Webhook automatisch bei Firma.dev, wenn Sie den Workflow aktivieren oder deaktivieren. Sie müssen an keinen Schritt im Dashboard denken und es bleibt nichts zurück, wenn Sie einen Workflow ausschalten.

Fügen Sie einen Firma Trigger-Node zu einem neuen Workflow hinzu, wählen Sie Ihre Firma API-Anmeldedaten aus und bestimmen Sie unter Events, auf welche Ereignisse gehört werden soll, z. B. „Signing Request Completed“ oder „Signing Request Recipient Declined“. Sie können den Trigger auf eine einzelne Workspace-ID beschränken, wenn Sie mehrere betreiben. Durch das Aktivieren des Workflows wird der Webhook erstellt, der auf Ihre n8n-Instanz verweist; durch das Deaktivieren wird er entfernt, und verwaiste Webhooks aus früheren Durchläufen werden erkannt und wiederverwendet, anstatt dupliziert zu werden.

Der Trigger deckt alle 27 Firma.dev-Webhook-Ereignisse für Signieranforderungen, Empfänger, Vorlagen, Workspaces und Domains ab. Leiten Sie diese mit einem Switch-Node auf {{ $json.type }} weiter:

• signing_request.completed aktualisiert Ihr CRM und stößt die Bereitstellung an

• signing_request.recipient.declined benachrichtigt den Vertrieb

• signing_request.expired sendet erneut oder verschiebt den Deal auf „Verloren“

Wenn Sie Ihren Anmeldedaten ein Webhook-Secret hinzugefügt haben, validiert der Trigger den Header X-Firma-Signature automatisch mit HMAC-SHA256, einschließlich des Kulanzzeitraum-Headers, der bei der Secret-Rotation verwendet wird. Anfragen, die die Validierung nicht bestehen, werden abgelehnt, bevor sie Ihre Workflow-Logik erreichen. Weitere Informationen darüber, wie Webhook-Ereignisse mandantenfähigen Workspaces zugeordnet werden, finden Sie im Leitfaden für Workspace-Webhooks.

Wenn Ihr nächster Schritt darin besteht, das fertige Dokument automatisch abzulegen, beschreibt die Google Drive-Anleitung genau diesen vierstufigen Prozess, vom Trigger bis zum Upload, in einem eigenen Leitfaden.

Die Webhook-API von Firma.dev erfordert HTTPS. n8n Cloud übernimmt das für Sie; Self-Hosted-Instanzen benötigen während der Entwicklung einen Reverse-Proxy mit TLS oder einen Tunnel wie cloudflared tunnel --url http://localhost:5678 oder ngrok http 5678. Zudem müssen Webhooks im Firma.dev-Dashboard unter Workspace-Einstellungen > Webhooks aktiviert sein. Die Test-Schaltfläche pro Webhook umgeht diesen Hauptschalter, sodass ein erfolgreicher Test nicht garantiert, dass auch echte Ereignisse fließen.

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

Der Firma-Node kann auch als natives Tool für den AI-Agent-Node fungieren, ohne dass eine benutzerdefinierte HTTP-Konfiguration erforderlich ist. Fügen Sie in einem AI-Agent-Workflow einen Firma-Node als Tool-Eingang hinzu, wählen Sie Ihre Anmeldedaten und bestimmen Sie die Ressource und Operation, die Sie bereitstellen möchten, z. B. Signing Request > Create and Send.

Stellen Sie mehr als eine Operation bereit, damit der Agent echte Optionen hat und nicht nur ein einziges Werkzeug. Eine beliebte Kombination ist Template > List, damit der Agent selbst nach der richtigen Vorlage suchen kann, zusammen mit Signing Request > Create and Send zum Versenden und Signing Request > Get, um den Status bei Nachfrage zu prüfen. Der Agent entscheidet anhand der Konversation, welches Tool aufgerufen werden soll, sodass eine Aufforderung wie „Sende die NDA an jane@acme.com“ gelöst wird, ohne dass Sie diese Logik manuell schreiben müssen.

Dieser Weg erfordert n8n v1.47 oder neuer.

Manuelle Einrichtung: Webhook plus HTTP Request

Wenn Ihr Team Community-Nodes vermeidet oder Sie eine n8n-Version nutzen, die älter ist als diese, können Sie Firma.dev dennoch direkt mit der API verbinden. Dies ist die gleiche Integration wie oben, nur zusammengesetzt aus den generischen Nodes von n8n anstelle der dedizierten.

Fügen Sie zum Senden einen HTTP-Request-Node mit den Anmeldedaten „Header Auth“ namens „Firma API“, dem Header „Authorization“ und dem Wert Ihres API-Schlüssels hinzu und richten Sie ihn auf den Endpunkt „create-and-send“:

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

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

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

{
  "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
    }
  ]
}

Es gilt das gleiche Muster „Entwurf erstellen, dann senden“: POST /signing-requests, um einen Entwurf zu erstellen, und POST /signing-requests/{id}/send, sobald er bereit für den Versand ist.

Um auf unterzeichnete Dokumente zu reagieren, fügen Sie einen Webhook-Trigger-Node hinzu, kopieren Sie dessen Produktions-URL und fügen Sie sie im Firma.dev-Dashboard unter Einstellungen > Webhooks zusammen mit den gewünschten Ereignissen ein. Leiten Sie die Nutzlast mit einem Switch-Node auf {{ $json.body.type }} weiter und rufen Sie die unterzeichnete Datei von {{ $json.body.data.signing_request.signed_document_url }} ab, um sie in Google Drive, S3 oder Notion zu archivieren. Im Gegensatz zum Trigger-Node sind Sie selbst dafür verantwortlich, diesen Webhook zu registrieren und zu entfernen, wenn sich ein Workflow ändert.

Unterzeichnen innerhalb einer anderen App

Wenn Ihr Prozess damit endet, dass der Unterzeichner das Dokument innerhalb Ihres eigenen Produkts und nicht per E-Mail ausfüllt, rufen Sie die signing_request_user_id des Empfängers aus der API-Antwort ab und betten Sie die Signier-UI 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 erzeugt einen lückenlosen Prüfpfad (Audit Trail), sodass die von Ihnen erstellte Automatisierung rechtssicher bleibt.

📘 Lesen Sie den vollständigen n8n-Integrationsleitfaden
Die vollständige Einrichtung, einschließlich aller Node-Felder, Anmeldedetails und Webhook-Ereignisse, finden Sie in der Dokumentation: https://docs.firma.dev/guides/n8n-integration

Erste Schritte

Sie können den Firma.dev-Node installieren und Ihre erste Signieranforderung in der Zeit senden, die Sie für das Erstellen einer einzigen Anmeldedatei benötigen. Starten Sie kostenlos mit Firma.dev, ohne Kreditkarte, und fügen Sie elektronische Signaturen zu Ihren bestehenden Workflows hinzu.