Automatiser dine signeringer med n8n
n8n er open source-automatiseringsplatformen, som du kan hoste selv. To veje til Certyneo: importér vores arbejdsgang, der er klar til brug, som kun bruger Webhook- og HTTP Request-noderne, der leveres med n8n, og derfor kræver ingen installation, eller installer fællesskabsnoden n8n-nodes-certyneo, hvis du foretrækker en Certyneo-node i dit panel. I begge tilfælde skal du indsætte din API-nøgle, og dine signeringshændelser styrer resten af din stack.
Arbejdsgangen kræver ingen installation: den bruger kun de noder, der leveres med n8n, så den fungerer overalt, også på n8n Cloud. Fællesskabsnoden n8n-nodes-certyneo publiceres på npm og installeres fra Settings → Community nodes på en selvhostet instans; n8n Cloud tilbyder kun de noder, som n8n har verificeret.
Hvorfor forbinde Certyneo til n8n
n8n giver dig valget: den administrerede tjeneste eller din egen server. I begge tilfælde bruger Certyneo-integrationen det offentlige API og webhooks uden nogen proprietær mellemled mellem dine kontrakter og dine værktøjer.
De 11 hændelser, ikke fire
Webhook-noden modtager hele livscyklussen for konvolutter — oprettelse, afsendelse, åbning, underskrift, afvisning, annullering, udløb, returnering til afsender. Ingen trigger er udeladt, i modsætning til forbindelser med fast liste.
Hele API'en uden at vente
HTTP Request-noden kalder ethvert endepunkt på Certyneo-API'en, så snart det findes: opret en konvolut, send den, upload et dokument, hent den signerede PDF eller bevismappe.
Selv-hosting muligt
På en n8n-forekomst, som du hoster, passerer dine kontraktmetadata ikke gennem nogen tredjemand: trafikken går fra din server til Certyneo og ingen anden steder. Et tungtvejende argument for juridiske teams og it-direktører.
API-nøgle og HMAC-signatur
Forbindelsen godkendes med en API-nøgle med begrænset rækkevidde, som kan tilbagekaldes til enhver tid. Hver indgående hændelse er signeret i HMAC-SHA256: dit workflow kan bekræfte, at det kommer fra Certyneo.
Tilgængelige hændelser
Abonnér Webhook-noden på de hændelser, du ønsker. De ankommer i realtid med signaturheader X-Certyneo-Signature til verifikation på n8n-siden.
| Hændelse | Trigges når… |
|---|---|
Konvolut oprettetenvelope.created | En konvolut blev netop oprettet, stadig i kladdetilstand. |
Kuvert sendtenvelope.sent | En konvolut forlader kladdestadiet og sendes til sine modtagere. |
Kuvert underskrevetenvelope.completed | Alle modtagere har underskrevet: kuverten er færdiggjort med et link til download af den underskrevne PDF. |
Kuvert afvistenvelope.declined | En modtager nægter at underskrive med det motiv, han har angivet. |
Konvolut annulleretenvelope.voided | Afsenderen annullerer en kuvert, der allerede er afsendt: signaturlinksene bliver ubrugelige. |
Kuvert udløbetenvelope.expired | Deadline er passeret uden at alle modtagere har underskrevet. |
Kuvert returneret til afsenderenvelope.returned_to_sender | En modtager returnerer kuverten til rettelse i stedet for at underskrive den. |
Kuvert genindsendtenvelope.resubmitted | Afsenderen korrigerer og sender en kuvert tilbage, der var blevet returneret til ham. |
Modtager har underskrevetrecipient.signed | En modtager fuldfører sin underskrift. Udløses én gang pr. underskriver, ikke kun til sidst. |
Modtager åbnederecipient.viewed | En modtager åbner kuverten for første gang — nyttigt til at følge op på det rigtige tidspunkt. |
Modtager godkendtrecipient.approved | En modtager, hvis rolle er "godkender", validerer kuverten uden at tilføje en signatur. |
Adresse er ikke tilgængeligrecipient.bounced | En modtagers adresse returnerer en permanent fejl (postboks findes ikke, domæne er dødt). Påmindelser stoppes: ret adressen og send kuverten igen. |
Hvad du kan styre
Hver linje er et kald til HTTP Request-noden, med Header Auth-godkendelse og din Certyneo-nøgle.
Opret en kuvert
POST /envelopes — sammensætter en kuvert fra en Certyneo-skabelon eller allerede indleverede dokumenter, med dens modtagere.
Send kuvert
POST /envelopes/:id/send — sender kuverten ud af kladge og sender underskrivelsesopfordringer.
List kuverter
GET /envelopes — pagineret liste, seneste først, med et valgfrit statusfilter.
Indlever et dokument
POST /documents — sender en PDF fra en hvilken som helst n8n-node, herunder en e-mail-vedhæftelse eller en Drive-fil.
Vis skabeloner
GET /templates — henter identifikatorerne på dine skabeloner, så du ikke behøver at hardcode dem i arbejdsgangen.
Download den signerede PDF
GET /envelopes/:id/signed-document — henter det signerede dokument, og /audit-trail til revisionsslaget.
Installer integreringen
Arbejdsgangen, som vi leverer, indeholder allerede webhook'en, begivenhedsbaseret routing, abonnementskald og et eksempel på afsendelse. Regn med fem minutter.
- 1
Importér arbejdsgangen
I n8n skal du åbne arbejdsgangmenuen og vælge « Import from URL… » og indsætte adressen på vores skabelon. Du kan også downloade filen og slippe den på lærredet.
- 2
Generer din API-nøgle
Åbn Certyneo → Indstillinger → REST API og opret en nøgle med kuvert- og webhook-omfang. Kopier den: den vises kun én gang.
- 3
Opret Header Auth-identifikatoren
I n8n skal du tilføje en « Header Auth »-identifikator: navn « Authorization », værdi « Bearer » efterfulgt af din nøgle. Vælg den på HTTP Request-knudepunkterne i arbejdsgangen.
- 4
Abonner og aktivér
Kopiér produktions-URL'en fra Webhook-knudepunktet, indsæt den i abonnementskaldene, udfør det en gang, og aktivér derefter arbejdsgangen. Gem « hemmeligheden », der returneres: den bruges til at verificere signaturen på begivenheder.
- 5
Forbind Google Drive
Skabelonen placerer den underskrevne PDF og dens revisionsbevis på dit Drive: vælg din Google-konto på begge arkiveringsknuder. Du kan erstatte dem med S3, SharePoint eller enhver anden lagring, de forbruger det samme binære felt.
Sikkerhed og overensstemmelse
n8n-integrationen er baseret på det offentlige Certyneo API, med samme kravniveau som resten af platformen.
- Krypterede exchanger fra start til slut ved hjælp af HTTPS.
- API-nøgler med begrænset adgang: giv kun de nødvendige rettigheder.
- Hver begivenhed er signeret i HMAC-SHA256 — verificér det, før du handler på det.
- Revocation af en nøgle ved enhver tid fra din dashboard.
Ofte stillede spørgsmål
Skal der installeres en Certyneo-knude i n8n?
Det er ikke obligatorisk. Den arbejdsgang, vi udgiver, bruger kun Webhook- og HTTP Request-noderne, der leveres med n8n: intet at installere, og den fungerer lige så godt på n8n Cloud. Der findes en fællesskabsnode, hvis du foretrækker det — n8n-nodes-certyneo på npm, med en handlingsnode, en udløsernode og dens identifikator — og den installeres fra Settings → Community nodes på en selvhostet instans. n8n-dokumentationen forbeholder n8n Cloud til de noder, som den har verificeret.
Hvilket Certyneo-abonnement kræves for at bruge n8n?
En rigtig nøgle (sk_live_…) kræver en plan, der inkluderer API-adgang (Standard og derover). Gratis- og Personal-planerne har en sandkassenøgle (sk_test_…) til at køre hele forløbet på testkonvolutter uden e-mail sendt til underskriverne.
Hvordan henter jeg min API-nøgle?
Fra Certyneo skal du gå til Indstillinger → REST API og oprette en nøgle med omfanget envelopes:read, envelopes:write og webhooks:write. Den starter med sk_live_ (eller sk_test_ til sandkassen) og vises kun én gang: kopier den med det samme.
Virker det på en selv-hostet n8n-instans?
Ja, og det er det mest interessante use case. Din instans skal blot være tilgængelig fra internettet for at modtage vores webhooks: en offentlig HTTPS-URL er tilstrækkelig. Ingen data passerer derefter gennem en tredjepartstjeneste.
Hvilke signaturhændelser bliver dekket?
De elleve begivenheder i livscyklussen: konvolut oprettet, sendt, signeret, afvist, annulleret, udløbet, returneret til afsenderen, gensendt, og modtager åbnet, signeret eller godkendt. Du vælger dem, som du abonnerer på.
Hvordan verificerer du, at en begivenhed virkelig kommer fra Certyneo?
Hver levering har en X-Certyneo-Signature-header, der indeholder HMAC-SHA256 af anmodningens krop, beregnet med hemmeligheden, der blev returneret ved oprettelsen af abonnementet. Sammenlign det i en kodnode, før du behandler begivenheden.
Er n8n-integrationen betalt?
Certyneo opkræver ingen tillæg. På n8n-siden er en selvhostet instans gratis; på n8n Cloud forbruger hver kørsel kvoten fra dit plan.
Fortsæt
Automatiser dine kontrakter i dag
Importér arbejdsgangen, indsæt din API-nøgle, og lad dine underskrifter udløse resten.