Automatiser signaturer dine med n8n
n8n er automatiseringsplattformen med åpen kildekode som du kan være vert for selv. To veier til Certyneo: importer arbeidsflyten vår som er klar til bruk, som kun bruker nodene Webhook og HTTP Request som følger med n8n og derfor ikke krever noen installasjon, eller installer fellesskapsnoden n8n-nodes-certyneo hvis du foretrekker en Certyneo-node i panelet ditt. I begge tilfeller limer du inn API-nøkkelen din og signatureringshendelsene dine styrer resten av stacken din.
Arbeidsflyten krever ingen installasjon: den bruker kun nodene som følger med n8n, så den fungerer overalt, inkludert på n8n Cloud. Fellesskapsnoden n8n-nodes-certyneo er publisert på npm og installeres fra Settings → Community nodes på en selvvert instans; n8n Cloud tilbyr kun nodene som n8n har verifisert.
Hvorfor koble Certyneo til n8n
n8n lar deg velge: den administrerte tjenesten, eller din egen server. I begge tilfeller bruker Certyneo-integrasjonen det offentlige API-et og webhooks, uten noen proprietær mellommann mellom kontraktene dine og verktøyene dine.
Alle 11 begivenhetene, ikke bare fire
Webhook-noden mottar hele livssyklusen til konvolutter — opprettelse, sending, åpning, signering, avvisning, kansellering, utløp, retur til avsender. Ingen utløser blir utelatt, i motsetning til koblinger med faste lister.
Hele API-et, uten venting
HTTP Request-noden kaller hvilket som helst endepunkt i Certyneo API så snart det finnes: opprett en konvolutt, send den, last opp et dokument, hent den signerte PDF-filen eller bevis-mappen.
Selvhosting mulig
På en n8n-instans som du er vert for, passerer metadata for kontraktene dine gjennom ingen tredjepart: trafikken går fra serveren din til Certyneo, og ingen andre steder. Et tungtveiende argument for juridiske team og IT-direktører.
API-nøkkel og HMAC-signering
Tilkoblingen autentiseres med en API-nøkkel med begrenset omfang, som kan tilbakekalles når som helst. Hver innkommende begivenhet signeres i HMAC-SHA256: arbeidsflyten din kan verifisere at den kommer fra Certyneo.
Tilgjengelige begivenheter
Abonner Webhook-noden på begivenhetene du velger. De kommer i sanntid, med signaturhodet X-Certyneo-Signature for å verifisere på n8n-siden.
| hendelse | Utløses når… |
|---|---|
Konvolutt opprettetenvelope.created | En konvolutt nettopp ble opprettet, ennå i utkasttilstand. |
Konvolutt sendtenvelope.sent | En konvolutt forlater utkastet og går til mottakerne sine. |
Konvolutt signertenvelope.completed | Alle mottakere har signert: konvolutten er fullført, med en nedlastingslenke for den signerte PDF-en. |
Konvolutt avvistenvelope.declined | En mottaker nekter å signere, med begrunnelsen de angav. |
Konvolutt annullertenvelope.voided | Avsenderen annullerer en konvolutt som allerede er sendt: signeringslenker blir ubrukelige. |
Konvolutt utløptenvelope.expired | Fristen har passert uten at alle mottakere har signert. |
Konvolutt returnert til avsenderenvelope.returned_to_sender | En mottaker returnerer konvolutten for korrigering i stedet for å signere den. |
Konvolutt gjennomsendtenvelope.resubmitted | Avsenderen korrigerer og sender deretter en konvolutt som hadde blitt returnert til ham. |
Mottaker har signertrecipient.signed | En mottaker fullfører signaturen sin. Utløses en gang per underskriver, ikke bare på slutten. |
Mottaker har åpnetrecipient.viewed | En mottaker åpner konvolutten for første gang — nyttig for å følge opp på riktig tidspunkt. |
Mottaker har godkjentrecipient.approved | En mottaker hvis rolle er «godkjenner» validerer konvolutten uten å påføre en signatur. |
Utilgjengelig adresserecipient.bounced | Adressen til en mottaker returnerer en permanent feil (ikke-eksisterende postkasse, død domene). Påminnelsene stopper: korriger adressen og send omslaget på nytt. |
Det du kan styre
Hver linje er et kall til HTTP Request-noden, med Header Auth-autentisering og din Certyneo-nøkkel.
Opprett en konvolutt
POST /envelopes — komponerer en konvolutt fra en Certyneo-mal eller dokumenter som allerede er lastet opp, med mottakerne.
Send konvolutten
POST /envelopes/:id/send — tar konvolutten ut av utkast og sender invitasjoner til signering.
List konvolutter
GET /envelopes — paginert liste, de nyeste først, med et valgfritt statusfilter.
Laste opp et dokument
POST /documents — sender en PDF fra en hvilken som helst n8n-node, inkludert en e-postvedlegg eller en Drive-fil.
Liste malene
GET /templates — henter identifikatorene for dine maler slik at du ikke trenger å hardkode dem i arbeidsflyten.
Last ned den signerte PDF-en
GET /envelopes/:id/signed-document — henter det signerte dokumentet, og /audit-trail for revisjonssporet.
Sette opp integrasjonen
Arbeidsflyten vi tilbyr inneholder allerede webhoken, hendelsesruting, abonnementskallet og et eksempel på sending. Regn med fem minutter.
- 1
Importer arbeidsflyten
I n8n åpner du arbeidsflytmenyen og velger « Import from URL… », deretter limer du inn adressen til malen vår. Du kan også laste ned filen og dra den til lerretet.
- 2
Generere din API-nøkkel
Åpne Certyneo → Innstillinger → REST API og opprett en nøkkel med omfang for konvolutter og webhooks. Kopier den: den vises bare en gang.
- 3
Opprett Header Auth-identifikatoren
I n8n legger du til en « Header Auth »-identifikator: navn « Authorization », verdi « Bearer » etterfulgt av nøkkelen din. Velg den på HTTP Request-nodene i arbeidsflyten.
- 4
Abonnér og aktiver
Kopier produksjons-URL-en fra Webhook-noden, lim den inn i abonnementskallet, kjør det en gang, og aktiver deretter arbeidsflyten. Behold « hemmeligheten » som returneres: den brukes til å verifisere signaturen på hendelser.
- 5
Koble til Google Drive
Malen legger den signerte PDF-filen og revisjonsbeviset i Drive-en din: velg Google-kontoen din på begge arkiveringsnodene. Du kan erstatte dem med S3, SharePoint eller annen lagring, de bruker samme binære felt.
Sikkerhet og samsvar
n8n-integrasjonen bygger på det offentlige Certyneo API-et, med samme kravnivå som resten av plattformen.
- Krypterte HTTPS-utvekslinger fra ende til ende.
- API-nøkler med begrenset omfang: gi bare nødvendige rettigheter.
- Hver hendelse signeres med HMAC-SHA256 — verifiser det før du handler på det.
- Tilbakekalling av en nøkkel når som helst fra kontrollpanelet ditt.
Vanlige spørsmål
Må jeg installere en Certyneo-node i n8n?
Det er ikke obligatorisk. Arbeidsflyten vi publiserer bruker kun nodene Webhook og HTTP Request som følger med n8n: ingenting å installere, og den fungerer like godt på n8n Cloud. En fellesskapsnode finnes hvis du foretrekker det — n8n-nodes-certyneo på npm, med en handlingsnode, en utløsernode og dens identifikator — og installeres fra Settings → Community nodes på en selvvert instans. n8n-dokumentasjonen reserverer n8n Cloud for nodene som den har verifisert.
Hvilket Certyneo-abonnement trenger jeg for å bruke n8n?
En riktig nøkkel (sk_live_…) krever en plan som inkluderer API-tilgang (Standard og høyere). Gratuit- og Personlig-planene har en sandkassenøkkel (sk_test_…) for å gjøre hele reisen på testverdier uten e-poster sendt til undertegnere.
Hvordan får jeg min API-nøkkel?
Fra Certyneo går du til Innstillinger → REST API og oppretter en nøkkel med områdene envelopes:read, envelopes:write og webhooks:write. Den begynner med sk_live_ (eller sk_test_ for sandkassen) og vises bare en gang: kopier den umiddelbart.
Fungerer dette på en selv-vert n8n-instans?
Ja, og det er det mest interessante brukerscenarioet. Instansen din trenger bare å være tilgjengelig fra internett for å motta webhookene våre: en offentlig HTTPS-URL er nok. Ingen data passerer da gjennom en tredjepartstjeneste.
Hvilke signeringshendelser dekkes?
De elleve hendelsene i livssyklus: konvolutt opprettet, sendt, signert, avslått, kansellert, utløpt, returnert til avsender, gjeninnsendt, og mottaker har åpnet, signert eller godkjent. Du velger hvilke du abonnerer på.
Hvordan verifisere at en hendelse virkelig kommer fra Certyneo?
Hver levering har en X-Certyneo-Signature-header som inneholder HMAC-SHA256 av forespørselsteksten, beregnet med hemmeligheten som ble returnert ved opprettelse av abonnementet. Sammenlign den i en kodNode før du behandler hendelsen.
Er n8n-integrasjonen betalt?
Certyneo krever ikke tilleggsbetaling. På n8n-siden er en selvbetjent instans gratis; på n8n Cloud bruker hver kjøring kvoten på planen din.
Gå videre
Automatiser dine kontrakter i dag
Importer arbeidsflyten, lim inn API-nøkkelen din, og la signaturene dine utløse resten.