Automatisera dina signaturer med n8n
n8n är automatiseringsplattformen med öppen källkod som du kan vara värd för själv. Två vägar till Certyneo: importera vårt färdiga arbetsflöde, som endast använder Webhook- och HTTP Request-noderna som medföljer n8n och därför inte kräver någon installation, eller installera community-noden n8n-nodes-certyneo om du föredrar en Certyneo-nod i din panel. I båda fallen klistrar du in din API-nyckel och dina signeringshändelser styr resten av din stack.
Arbetsflödet kräver ingen installation: det använder endast noder som medföljer n8n, så det fungerar överallt, inklusive på n8n Cloud. Community-noden n8n-nodes-certyneo publiceras på npm och installeras från Settings → Community nodes på en själv värdad instans; n8n Cloud erbjuder endast noder som n8n har verifierat.
Varför ansluta Certyneo till n8n
n8n låter dig välja: den hanterade tjänsten eller din egen server. I båda fallen använder Certyneo-integrationen det offentliga API:t och webhooks, utan någon proprietär mellanhand mellan dina kontrakt och dina verktyg.
De 11 händelserna, inte fyra
Webhook-noden tar emot hela livscykeln för kuvert — skapande, skickande, öppnande, signering, vägran, annullering, förfallotid, återgång till avsändaren. Ingen utlösare lämnas åt sidan, till skillnad från anslutningar med fast lista.
Hela API:t, utan att vänta
HTTP Request-noden anropar valfri slutpunkt för Certyneo API:t så snart den finns: skapa ett kuvert, skicka det, lämna in ett dokument, hämta den signerade PDF-filen eller bevismappen.
Själv-hosting möjligt
På en n8n-instans som du själv hostar behöver dina avtalsmetadata aldrig passera någon tredje part: trafiken går från din server till Certyneo, och ingenstans annat. Ett starkt argument för juridiska team och IT-chefer.
API-nyckel och HMAC-signatur
Anslutningen autentiseras med en API-nyckel med begränsad omfattning, som kan återkallas när som helst. Varje inkommande händelse signeras i HMAC-SHA256: ditt arbetsflöde kan verifiera att den kommer från Certyneo.
Tillgängliga händelser
Prenumerera Webhook-noden på de händelser du väljer. De anländer i realtid, med signaturrubrik X-Certyneo-Signature att verifiera på n8n-sidan.
| Händelse | Utlöses när… |
|---|---|
Kuvert skapatenvelope.created | Ett kuvert har just skapats, ännu i utkastform. |
Uppkapsling skickadenvelope.sent | Ett kuvert lämnar utkastet och går vidare till sina mottagare. |
Signerad enveloppeenvelope.completed | Alla mottagare har undertecknat: kuvertet är slutfört, med en nedladdningslänk för den signerade PDF-filen. |
Avslutad enveloppeenvelope.declined | En mottagare vägrar att signera, med det skäl han eller hon angav. |
Kuvert annulleratenvelope.voided | Avsändaren annullerar ett kuvert som redan har skickats: signeringslänkarna blir oanvändbara. |
Kuvert utgångetenvelope.expired | Slutdatumet har passerat utan att alla mottagare har undertecknat. |
Kuvert returnerat till avsändarenenvelope.returned_to_sender | En mottagare returnerar kuvertet för korrigering i stället för att underteckna det. |
Kuvert återskickatenvelope.resubmitted | Avsändaren korrigerar och återskickar ett kuvert som hade returnerats till honom. |
Mottagare har underundertecknatrecipient.signed | En mottagare slutför sin signering. Utlöses en gång per undertecknare, inte bara vid slutet. |
Mottagare har öppnatrecipient.viewed | En mottagare öppnar kuvertet för första gången — användbart för att följa upp vid rätt tidpunkt. |
Mottagare har godkäntrecipient.approved | En mottagare vars roll är "godkännare" validerar kuvertet utan att underteckna det. |
Adress nåbarrecipient.bounced | Mottagarens adress returnerar ett permanent fel (befintlig brevlåda, död domän). Påminnelserna stoppas: korrigera adressen och skicka kuvertet igen. |
Det du kan styra
Varje rad är ett anrop från noden HTTP Request, med Header Auth-autentisering och din Certyneo-nyckel.
Skapa en enveloppe
POST /envelopes — komponerar ett kuvert från en Certyneo-mall eller redan inlämnade dokument, med dess mottagare.
Skicka enveloppen
POST /envelopes/:id/send — tar kuvertet från utkast och skickar inbjudningar att underteckna.
Lista kuvert
GET /envelopes — paginerad lista, de senaste först, med ett valfritt statusfilter.
Ladda upp ett dokument
POST /documents — skickar en PDF från vilken n8n-nod som helst, inklusive en e-postbilaga eller en Drive-fil.
Lista mallar
GET /templates — hämtar identifierare för dina mallar för att undvika att hårdkoda dem i arbetsflödet.
Ladda ned den signerade PDF:en
GET /envelopes/:id/signed-document — hämtar det signerade dokumentet, och /audit-trail för revisionshistoriken.
Installera integreringen
Arbetsflödet som vi tillhandahåller innehåller redan webhooken, händelsestyrningen, prenumerationsanropet och ett exempel på sändning. Räkna med fem minuter.
- 1
Importera arbetsflödet
I n8n öppnar du arbetsflödesmenyn och väljer « Import from URL… » och klistrar in adressen till vår mall. Du kan också ladda ned filen och släppa den på arbetsytan.
- 2
Generera din API-nyckel
Öppna Certyneo → Inställningar → REST API och skapa en nyckel med kuvert- och webhook-omfång. Kopiera den: den visas bara en gång.
- 3
Skapa Header Auth-identifieraren
I n8n lägger du till en « Header Auth »-identifierare: namn « Authorization », värde « Bearer » följt av din nyckel. Välj den på HTTP Request-noderna i arbetsflödet.
- 4
Prenumerera och aktivera
Kopiera produktions-URL:en från Webhook-noden, klistra in den i prenumerationsanropet, kör det en gång, och aktivera sedan arbetsflödet. Spara « secret » som returneras: det används för att verifiera signaturen på händelser.
- 5
Anslut Google Drive
Mallen deponerar den signerade PDF:en och dess granskningsbevis på din Drive: välj ditt Google-konto på båda arkiveringsnoderna. Du kan ersätta dem med S3, SharePoint eller annan lagring, de använder samma binära fält.
Säkerhet och överensstämmelse
n8n-integrationen baseras på Certyneos offentliga API, med samma kravnivå som resten av plattformen.
- Krypterad kommunikation i HTTPS från slutpunkt till slutpunkt.
- API-nycklar med begränsad räckvidd: bevilja endast nödvändiga rättigheter.
- Varje händelse signeras i HMAC-SHA256 — verifiera det innan du agerar på det.
- Återkalla en nyckel när som helst från din instrumentpanel.
Frågor som ofta ställs
Måste man installera en Certyneo-nod i n8n?
Det är inte obligatoriskt. Arbetsflödet som vi publicerar använder endast Webhook- och HTTP Request-noderna som medföljer n8n: ingenting att installera, och det fungerar lika bra på n8n Cloud. En community-nod finns om du föredrar det — n8n-nodes-certyneo på npm, med en åtgärdsnod, en utlösarnod och dess identifierare — och installeras från Settings → Community nodes på en själv värdad instans. n8n-dokumentationen reserverar n8n Cloud för noder som den har verifierat.
Vilken Certyneo-prenumeration krävs för att använda n8n?
En verklig nyckel (sk_live_…) kräver ett paket som inkluderar API-åtkomst (Standard och högre). Kostnadsfritt och Personligt paket har en sandlådnyckel (sk_test_…) för att gå igenom hela processen på testkonvolut, utan e-post skickat till undertecknarna.
Hur får jag min API-nyckel?
Från Certyneo går du till Inställningar → REST API och skapar en nyckel med omfång envelopes:read, envelopes:write och webhooks:write. Den börjar med sk_live_ (eller sk_test_ för sandlådan) och visas bara en gång: kopiera den omedelbar.
Fungerar detta på en egen n8n-instans?
Ja, och det är det mest intressanta användningsfallet. Din instans behöver bara vara nåbar från Internet för att ta emot våra webhooks: en offentlig HTTPS-URL räcker. Inga data går då via en tredjepartstjänst.
Vilka signeringshändelser omfattas ?
De elva händelserna i livscykeln: kuvert skapat, skickat, signerat, avslaget, avbrytet, utgånget, returnerat till avsändaren, återinlämnat, och mottagare som öppnade, signerade eller godkände. Du väljer de du prenumererar på.
Hur verifierar man att en händelse verkligen kommer från Certyneo?
Varje leverans bär en X-Certyneo-Signature-rubrik som innehåller HMAC-SHA256 för förfrågningens brödtext, beräknad med hemligheten som returnerades när prenumerationen skapades. Jämför den i en kodsnod innan du bearbetar händelsen.
Är n8n-integreringen avgiftsbelagd?
Certyneo tar ingen extra avgift. Från n8n:s sida är en egen värdversion gratis; på n8n Cloud förbrukar varje körning kvoten för ditt paket.
Läs mer
Automatisera dina kontrakt idag
Importera arbetsflödet, klistra in din API-nyckel och låt dina signaturer utlösa resten.