Automatisieren Sie Ihre Signaturen mit n8n
n8n ist die Open-Source-Automatisierungsplattform, die man selbst hosten kann. Zwei Wege zu Certyneo: Importieren Sie unseren vorgefertigten Workflow, der nur die mit n8n gelieferten Webhook- und HTTP-Request-Knoten nutzt und daher keine Installation erfordert, oder installieren Sie den Community-Knoten n8n-nodes-certyneo, wenn Sie einen Certyneo-Knoten in Ihrem Panel bevorzugen. In beiden Fällen fügen Sie Ihren API-Schlüssel ein und Ihre Signaterereignisse steuern den Rest Ihres Stacks.
Der Workflow erfordert keine Installation: Er nutzt nur die mit n8n gelieferten Knoten, daher funktioniert er überall, auch in n8n Cloud. Der Community-Knoten n8n-nodes-certyneo wird auf npm veröffentlicht und wird auf einer selbstgehosteten Instanz von Settings → Community nodes aus installiert; n8n Cloud bietet jedoch nur die Knoten an, die n8n verifiziert hat.
Warum Certyneo mit n8n verbinden
n8n gibt Ihnen die Wahl: den verwalteten Dienst oder Ihren eigenen Server. In beiden Fällen nutzt die Certyneo-Integration die öffentliche API und Webhooks, ohne proprietären Vermittler zwischen Ihren Verträgen und Ihren Tools.
Die 11 Ereignisse, nicht vier
Der Webhook-Knoten empfängt den gesamten Lebenszyklus der Umschläge — Erstellung, Versand, Öffnung, Unterzeichnung, Ablehnung, Stornierung, Ablauf, Rückkehr zum Absender. Kein Auslöser wird übergangen, im Gegensatz zu Konnektoren mit fester Liste.
Die gesamte API, ohne zu warten
Der HTTP-Request-Knoten ruft jeden API-Endpunkt von Certyneo auf, sobald er existiert: einen Umschlag erstellen, ihn versenden, ein Dokument ablegen, das signierte PDF oder den Beweisordner abrufen.
Selbsthosting möglich
Auf einer n8n-Instanz, die Sie hosten, durchlaufen die Metadaten Ihrer Verträge keinen Dritten: der Datenverkehr verläuft von Ihrem Server zu Certyneo und nirgendwo anders hin. Ein gewichtiges Argument für Rechtsteams und IT-Leiter.
API-Schlüssel und HMAC-Signatur
Die Verbindung authentifiziert sich durch einen API-Schlüssel mit begrenztem Umfang, der jederzeit widerrufbar ist. Jedes eingehende Ereignis wird in HMAC-SHA256 signiert: Ihr Workflow kann überprüfen, dass es wirklich von Certyneo kommt.
Verfügbare Ereignisse
Abonnieren Sie den Webhook-Knoten für die Ereignisse Ihrer Wahl. Sie kommen in Echtzeit an, mit dem Signatur-Header X-Certyneo-Signature, der auf n8n-Seite zu überprüfen ist.
| Ereignis | Wird ausgelöst, wenn… |
|---|---|
Umschlag erstelltenvelope.created | Ein Umschlag wurde gerade erstellt, noch im Entwurfsstatus. |
Umschlag gesendetenvelope.sent | Ein Umschlag verlässt den Entwurf und geht zu seinen Empfängern. |
Umschlag signiertenvelope.completed | Alle Empfänger haben unterzeichnet: der Umschlag ist abgeschlossen, mit einem Download-Link für das signierte PDF. |
Umschlag abgelehntenvelope.declined | Ein Empfänger weigert sich zu unterzeichnen, mit dem angegebenen Grund. |
Umschlag storniertenvelope.voided | Der Absender storniert einen bereits versendeten Umschlag: die Unterzeichnungslinks werden unbrauchbar. |
Umschlag abgelaufenenvelope.expired | Die Frist ist verstrichen, ohne dass alle Empfänger unterzeichnet haben. |
Umschlag an Absender zurückgegebenenvelope.returned_to_sender | Ein Empfänger sendet den Umschlag zur Korrektur zurück, anstatt ihn zu unterzeichnen. |
Umschlag erneut eingereichtenvelope.resubmitted | Der Absender korrigiert und sendet einen Umschlag zurück, der ihm zurückgegeben worden war. |
Empfänger hat signiertrecipient.signed | Ein Empfänger schließt seine Signatur ab. Wird einmal pro Unterzeichner ausgelöst, nicht nur am Ende. |
Empfänger hat geöffnetrecipient.viewed | Ein Empfänger öffnet den Umschlag zum ersten Mal — nützlich, um zur richtigen Zeit nachzufassen. |
Empfänger hat genehmigtrecipient.approved | Ein Empfänger mit der Rolle "Genehmiger" validiert den Umschlag, ohne eine Signatur anzubringen. |
Unerreichbare Adresserecipient.bounced | Die Adresse eines Empfängers führt zu einem permanenten Fehler (nicht vorhandenes Postfach, inaktive Domain). Die Wiederholungen werden gestoppt: Korrigieren Sie die Adresse und senden Sie den Umschlag erneut. |
Was Sie steuern können
Jede Zeile ist ein Aufruf des HTTP Request-Knotens mit Header Auth-Authentifizierung und Ihrem Certyneo-Schlüssel.
Umschlag erstellen
POST /envelopes — erstellt einen Umschlag aus einer Certyneo-Vorlage oder bereits hochgeladenen Dokumenten mit seinen Empfängern.
Umschlag senden
POST /envelopes/:id/send — nimmt den Umschlag aus dem Entwurf und sendet Unterzeichnungseinladungen.
Umschläge auflisten
GET /envelopes — paginierte Liste, neueste zuerst, mit optionalem Statusfilter.
Ein Dokument hochladen
POST /documents — sendet ein PDF von jedem n8n-Knoten, einschließlich E-Mail-Anlage oder Drive-Datei.
Vorlagen auflisten
GET /templates — ruft die Identifikatoren Ihrer Vorlagen ab, um diese nicht im Workflow hartcodieren zu müssen.
Signiertes PDF herunterladen
GET /envelopes/:id/signed-document — ruft das signierte Dokument ab, und /audit-trail für den Nachweisordner.
Integration einrichten
Der bereitgestellte Workflow enthält bereits den Webhook, das ereignisgesteuerte Routing, den Abonnementaufruf und ein Sendungsbeispiel. Rechnen Sie mit fünf Minuten.
- 1
Workflow importieren
In n8n öffnen Sie das Workflow-Menü und wählen « Aus URL importieren… », dann fügen Sie die Adresse unserer Vorlage ein. Sie können auch die Datei herunterladen und auf die Canvas ziehen.
- 2
API-Schlüssel generieren
Öffnen Sie Certyneo → Einstellungen → REST-API und erstellen Sie einen Schlüssel mit den Bereichen envelopes und webhooks. Kopieren Sie ihn: Er wird nur einmal angezeigt.
- 3
Header Auth-Anmeldedaten erstellen
In n8n fügen Sie die Anmeldedaten « Header Auth » hinzu: Name « Authorization », Wert « Bearer » gefolgt von Ihrem Schlüssel. Wählen Sie diese in den HTTP Request-Knoten des Workflows aus.
- 4
Abonnieren und aktivieren
Kopieren Sie die Production-URL des Webhook-Knotens, fügen Sie sie in den Abonnementaufruf ein, führen Sie ihn einmal aus und aktivieren Sie dann den Workflow. Bewahren Sie das zurückgegebene « secret » auf: es dient zur Verifizierung der Signatur von Ereignissen.
- 5
Google Drive verbinden
Die Vorlage speichert die unterzeichnete PDF und ihren Audit-Nachweis in Ihrem Drive: Wählen Sie Ihr Google-Konto auf den beiden Archivierungsknoten aus. Sie können sie durch S3, SharePoint oder einen anderen Speicher ersetzen, die den gleichen Binärfeld nutzen.
Sicherheit und Compliance
Die n8n-Integration basiert auf der öffentlichen Certyneo-API mit demselben Anforderungsniveau wie der Rest der Plattform.
- End-to-End-verschlüsselte Übertragungen über HTTPS.
- API-Schlüssel mit begrenztem Umfang: gewähren Sie nur die erforderlichen Rechte.
- Jedes Ereignis wird in HMAC-SHA256 signiert — verifizieren Sie es, bevor Sie darauf reagieren.
- Widerruf eines Schlüssels jederzeit von Ihrem Dashboard aus.
Häufig gestellte Fragen
Muss ich einen Certyneo-Knoten in n8n installieren?
Das ist nicht erforderlich. Der Workflow, den wir veröffentlichen, nutzt nur die mit n8n gelieferten Webhook- und HTTP-Request-Knoten: nichts zu installieren, und er funktioniert genauso gut in n8n Cloud. Ein Community-Knoten existiert, wenn Sie ihn bevorzugen — n8n-nodes-certyneo auf npm, mit einem Aktionsknoten, einem Auslöserknoten und seiner Kennung — und wird auf einer selbstgehosteten Instanz von Settings → Community nodes aus installiert. Die n8n-Dokumentation reserviert n8n Cloud für Knoten, die sie verifiziert hat.
Welches Certyneo-Abonnement brauche ich, um n8n zu nutzen?
Ein echter Schlüssel (sk_live_…) erfordert einen Plan mit API-Zugriff (Standard und höher). Die kostenlosen und persönlichen Pläne haben einen Sandbox-Schlüssel (sk_test_…), um den gesamten Prozess mit Test-Umschlägen zu durchlaufen, ohne E-Mails an Unterzeichner zu versenden.
Wie erhalte ich meinen API-Schlüssel?
Gehen Sie in Certyneo zu Einstellungen → REST-API und erstellen Sie einen Schlüssel mit den Bereichen envelopes:read, envelopes:write und webhooks:write. Er beginnt mit sk_live_ (oder sk_test_ für die Sandbox) und wird nur einmal angezeigt: Kopieren Sie ihn sofort.
Funktioniert dies auf einer selbst gehosteten n8n-Instanz?
Ja, und das ist der interessanteste Anwendungsfall. Ihre Instanz muss nur von außen über das Internet erreichbar sein, um unsere Webhooks zu empfangen: eine öffentliche HTTPS-URL genügt. Es werden dann keine Daten über einen Drittanbieter übertragen.
Welche Signaturaktion-Events werden abgedeckt?
Die elf Ereignisse des Lebenszyklus: Envelope erstellt, versendet, signiert, abgelehnt, storniert, abgelaufen, an den Absender zurückgesendet, erneut eingereicht, und Empfänger hat geöffnet, signiert oder genehmigt. Sie wählen aus, welche Sie abonnieren.
Wie kann ich verifizieren, dass ein Ereignis wirklich von Certyneo stammt?
Jede Zustellung trägt einen Header X-Certyneo-Signature, der den HMAC-SHA256 des Request-Body enthält, berechnet mit dem Secret, das bei der Abonnement-Erstellung zurückgegeben wurde. Vergleichen Sie ihn in einem Code-Knoten, bevor Sie das Ereignis verarbeiten.
Ist die n8n-Integration kostenpflichtig?
Certyneo berechnet keine Zusatzgebühren. Bei n8n ist eine selbst gehostete Instanz kostenlos; auf n8n Cloud verbraucht jede Ausführung das Kontingent Ihres Plans.
Weitere Informationen
Automatisieren Sie Ihre Verträge noch heute
Importieren Sie den Workflow, fügen Sie Ihren API-Schlüssel ein, und lassen Sie Ihre Signaturen den Rest auslösen.