Automatiseer uw handtekeningen met n8n
n8n is het open-source automatiseringsplatform dat u zelf kunt hosten. Certyneo sluit erop aan met de native Webhook- en HTTP Request-knooppunten: niets om te installeren, niets om door een marketplace te laten valideren. Importeer onze gebruiksklare workflow, plak uw API-sleutel, en uw handtekeningsgebeurtenissen sturen de rest van uw stack.
Geen communautaire knooppunten om te installeren: de integratie steunt uitsluitend op knooppunten die met n8n worden geleverd, dus het werkt ook op n8n Cloud, waar externe knooppunten beperkt zijn.
Waarom Certyneo met n8n verbinden
n8n geeft u de keuze: de beheerde service of uw eigen server. In beide gevallen gebruikt de Certyneo-integratie de openbare API en webhooks, zonder een propriëtair intermediair tussen uw contracten en uw tools.
De 11 gebeurtenissen, niet vier
Het Webhook-knooppunt ontvangt de volledige levenscyclus van enveloppen — aanmaak, verzending, opening, ondertekening, weigering, annulering, verlopen, retour naar afzender. Geen trigger wordt overgeslagen, in tegenstelling tot connectoren met een vaste lijst.
De volledige API, zonder wachten
Het HTTP Request-knooppunt roept elk eindpunt van de Certyneo API aan zodra het beschikbaar is: een enveloppe maken, deze verzenden, een document indienen, de ondertekende PDF of het dossier van bewijs ophalen.
Zelf hosten mogelijk
Op een n8n-instantie die u host, gaan de metadata van uw contracten niet via derden: het verkeer loopt van uw server naar Certyneo, en nergens anders. Een sterk argument voor juridische teams en ICT-directeuren.
API-sleutel en HMAC-ondertekening
De verbinding verifieert zich met een beperkte, op elk moment intrekbare API-sleutel. Elke binnenkomende gebeurtenis is ondertekend met HMAC-SHA256: uw workflow kan controleren dat deze echt van Certyneo afkomstig is.
Beschikbare gebeurtenissen
Abonneer het Webhook-knooppunt op de gebeurtenissen van uw keuze. Ze komen in realtime aan, met de handtekening-header X-Certyneo-Signature die aan n8n-zijde moet worden geverifieerd.
| Gebeurtenis | Wordt geactiveerd wanneer… |
|---|---|
Enveloppe aangemaaktenvelope.created | Een enveloppe is zojuist aangemaakt en bevindt zich nog in conceptstatus. |
Enveloppe verzondenenvelope.sent | Een enveloppe verlaat het concept en gaat naar zijn ontvangers. |
Enveloppe ondertekendenvelope.completed | Alle ontvangers hebben ondertekend: de enveloppe is afgerond, met een downloadlink voor de ondertekende PDF. |
Enveloppe geweigerdenvelope.declined | Een ontvanger weigert te ondertekenen, met de reden die hij heeft aangegeven. |
Enveloppe geannuleerdenvelope.voided | De afzender annuleert een reeds verzonden enveloppe: de ondertekeningslinks worden onbruikbaar. |
Enveloppe verlopenenvelope.expired | De uiterste datum is verstreken zonder dat alle geadresseerden hebben ondertekend. |
Envelop geretourneerd aan afzenderenvelope.returned_to_sender | Een geadresseerde retourneert de envelop ter correctie in plaats van deze te ondertekenen. |
Envelop opnieuw ingediendenvelope.resubmitted | De afzender corrigeert en retourneert een envelop die aan hem was teruggezonden. |
Ontvanger heeft ondertekendrecipient.signed | Een ontvanger voltooit zijn ondertekening. Wordt eenmaal per ondertekenaar geactiveerd, niet alleen op het einde. |
Geadresseerde heeft geopendrecipient.viewed | Een geadresseerde opent de envelop voor de eerste keer — handig om op het juiste moment op te volgen. |
Geadresseerde heeft goedgekeurdrecipient.approved | Een geadresseerde wiens rol 'fiatteur' is, valideert de envelop zonder hierop een handtekening te plaatsen. |
Wat u kunt beheren
Elke regel is een aanroep van het knooppunt HTTP Request, met Header Auth-authenticatie en uw Certyneo-sleutel.
Een enveloppe maken
POST /envelopes — stelt een envelop samen vanuit een Certyneo-sjabloon of reeds ingediende documenten, met de geadresseerden.
Envelop verzenden
POST /envelopes/:id/send — verplaatst de envelop uit het concept en verzendt de uitnodigingen voor ondertekening.
Enveloppen vermelden
GET /envelopes — gepagineerde lijst, meest recente eerst, met optioneel statusfilter.
Document indienen
POST /documents — verzendt een PDF vanaf elk n8n-knooppunt, inclusief een e-mailbijlage of Drive-bestand.
Sjablonen weergeven
GET /templates — haalt de id's van uw sjablonen op zodat u deze niet in het workflow hoeft in te coderen.
Ondertekend PDF downloaden
GET /envelopes/:id/signed-document — haalt het ondertekende document op, en /audit-trail voor het dossier van bewijs.
De integratie instellen
De workflow die wij leveren, bevat al de webhook, de routering per gebeurtenis, de abonnementoproep en een voorbeeldzending. Plan vijf minuten in.
- 1
De workflow importeren
In n8n opent u het workflowmenu en selecteert u « Import from URL… » en plakt u het adres van ons sjabloon. U kunt het bestand ook downloaden en op het canvas zetten.
- 2
Uw API-sleutel genereren
Open Certyneo → Instellingen → REST API en maak een sleutel met de bereiken enveloppen en webhooks. Kopieer deze: deze wordt slechts eenmaal weergegeven.
- 3
De Header Auth-identificatie aanmaken
In n8n voegt u een « Header Auth »-identificatie toe: naam « Authorization », waarde « Bearer » gevolgd door uw sleutel. Selecteer deze op de HTTP Request-knooppunten van de workflow.
- 4
Abonneren en activeren
Kopieer de productie-URL van het Webhook-knooppunt, plak deze in de abonnementoproep, voer deze eenmaal uit en activeer vervolgens de workflow. Bewaar het geretourneerde « geheim »: dit dient om de handtekening van de gebeurtenissen te verifiëren.
- 5
Google Drive verbinden
De sjabloon plaatst de ondertekende PDF en het auditknooppunt in uw Drive: selecteer uw Google-account op de twee archiveringsnooppunten. U kunt deze vervangen door S3, SharePoint of een ander opslagsysteem; ze gebruiken hetzelfde binaire veld.
Beveiliging en compliance
De n8n-integratie is gebaseerd op de openbare Certyneo API, met hetzelfde niveau van vereisten als de rest van het platform.
- End-to-end versleutelde HTTPS-uitwisselingen.
- API-sleutels met beperkt bereik: verleen alleen de nodige rechten.
- Elke gebeurtenis is ondertekend in HMAC-SHA256 — verifieer deze voordat u erop reageert.
- Een sleutel op elk moment intrekken vanuit uw dashboard.
Veelgestelde vragen
Is het nodig om een Certyneo-knooppunt in n8n te installeren?
Nee, en dat is opzettelijk. De Webhook- en HTTP Request-knooppunten die bij n8n worden geleverd, dekken onze volledige API: een speciaal pakket zou alleen een afhankelijkheid toevoegen die moet worden bijgewerkt. Omdat er niets hoeft te worden geïnstalleerd, werkt de integratie ook op n8n Cloud, waar communautaire knooppunten beperkt zijn.
Welk Certyneo-abonnement is nodig om n8n te gebruiken?
Een echte sleutel (sk_live_…) vereist een plan dat API-toegang biedt (Standard en hoger). De gratis plannen en persoonlijke plannen hebben een sandbox-sleutel (sk_test_…) om het volledige traject met testauto's uit te voeren, zonder e-mails naar ondertekenaren.
Hoe krijg ik mijn API-sleutel?
Ga vanuit Certyneo naar Instellingen → REST API en maak een sleutel aan met de scopes envelopes:read, envelopes:write en webhooks:write. Deze begint met sk_live_ (of sk_test_ voor de sandbox) en wordt slechts één keer weergegeven: kopieer deze onmiddellijk.
Werkt dit op een zelfgehoste n8n-instantie?
Ja, en dit is het meest interessante use-case. Uw instantie hoeft alleen bereikbaar te zijn via internet om onze webhooks te ontvangen: een openbare HTTPS-URL is voldoende. Er gaat dan geen data via een derde dienst.
Welke handtekeningsgebeurtenissen worden behandeld?
De elf gebeurtenissen van de levenscyclus: enveloppe gemaakt, verzonden, ondertekend, geweigerd, geannuleerd, verlopen, geretourneerd naar verzender, opnieuw ingediend, en ontvanger geopend, ondertekend of goedgekeurd. U kiest welke u abonneert.
Hoe verifieer je dat een gebeurtenis echt van Certyneo afkomstig is?
Elke bezorging bevat een X-Certyneo-Signature-header die de HMAC-SHA256 van de verzoekbody bevat, berekend met het geheim dat bij het aanmaken van het abonnement is geretourneerd. Vergelijk dit in een Code-knooppunt voordat u de gebeurtenis verwerkt.
Is de n8n-integratie betaald?
Certyneo berekent geen extra kosten. Bij n8n is een zelf-gehoste instantie gratis; op n8n Cloud verbruikt elke uitvoering het quotum van uw abonnement.
Verder gaan
Automatiseer uw contracten vandaag nog
Importeer de workflow, plak uw API-sleutel, en laat uw handtekeningen de rest activeren.