Automatisieren Sie Ihre Signaturen mit n8n
n8n ist die Open-Source-Automatisierungsplattform, die Sie selbst hosten können. Certyneo wird über die nativen Knoten Webhook und HTTP Request angebunden: nichts zu installieren, nichts zur Überprüfung durch einen Marketplace einreichen. Importieren Sie unseren sofort einsatzbereiten Workflow, fügen Sie Ihren API-Schlüssel ein, und Ihre Signaturanereignisse steuern den Rest Ihres Stacks.
Keine Community-Knoten erforderlich: Die Integration basiert nur auf den mit n8n gelieferten Knoten, daher funktioniert sie auch auf n8n Cloud, wo Knoten von Drittanbietern eingeschränkt sind.
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. |
Enveloppe gesendetenvelope.sent | Ein Umschlag verlässt den Entwurf und geht zu seinen Empfängern. |
Enveloppe signiertenvelope.completed | Alle Empfänger haben unterzeichnet: der Umschlag ist abgeschlossen, mit einem Download-Link für das signierte PDF. |
Enveloppe 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 die Enveloppe zur Korrektur zurück, anstatt sie zu unterzeichnen. |
Enveloppe erneut eingereichtenvelope.resubmitted | Der Absender korrigiert und sendet eine Enveloppe zurück, die 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 die Enveloppe zum ersten Mal — nützlich, um zur richtigen Zeit nachzufassen. |
Empfänger hat genehmigtrecipient.approved | Ein Empfänger mit der Rolle "Genehmiger" validiert die Enveloppe, ohne eine Signatur anzubringen. |
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 eine Enveloppe aus einer Certyneo-Vorlage oder bereits hochgeladenen Dokumenten mit ihren Empfängern.
Enveloppe senden
POST /envelopes/:id/send — nimmt die Enveloppe aus dem Entwurf und sendet Unterzeichnungseinladungen.
Enveloppen 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?
Nein, und das ist beabsichtigt. Die Webhook- und HTTP Request-Knoten von n8n decken unsere gesamte API ab: ein dediziertes Paket würde nur eine zu aktualisierende Abhängigkeit hinzufügen. Da nichts zu installieren ist, funktioniert die Integration auch auf n8n Cloud, wo Community-Knoten eingeschränkt sind.
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-Enveloppen 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.