Automatisoi allekirjoituksesi n8n:llä
n8n on avoimen lähdekoodin automatisointialusta, jonka voit isännöidä itse. Kaksi polkua Certyneoon: tuo sisään valmis workflow, joka käyttää vain n8nin mukana toimitettavia Webhook- ja HTTP Request -solmuja, eikä siten vaadi mitään asennusta, tai asenna yhteisön n8n-nodes-certyneo-solmu, jos haluat mieluummin Certyneo-solmun paneelissasi. Molemmissa tapauksissa liitä API-avaimesi ja allekirjoitustapahtumasi ohjaavat loput stackiasi.
Workflow ei vaadi asennusta: se käyttää vain n8nin mukana toimitettavia solmuja, joten se toimii kaikkialla, myös n8n Cloudissa. Yhteisön n8n-nodes-certyneo-solmu on julkaistu npmissä ja asennetaan Settings → Community nodes -kohdan kautta itse isännöidyllä instanssilla; n8n Cloud tarjoaa vain solmuja, jotka n8n on vahvistanut.
Miksi yhdistää Certyneo n8n:ään
n8n antaa sinulle valinnan: hallittu palvelu tai oma palvelimesi. Kummassakin tapauksessa Certyneo-integraatio käyttää julkista API:a ja webhookeja ilman omaa välimiestä sopimusten ja työkalujesi välillä.
11 tapahtumaa, ei neljä
Webhook-solmu vastaanottaa kirjekuorten koko elinkaaren – luominen, lähettäminen, avaaminen, allekirjoitus, hylkääminen, peruuttaminen, vanhentuminen, palautus lähettäjälle. Mitään käynnistintä ei jätetä pois, toisin kuin kiinteällä luettelolla olevissa liittäjissä.
Koko API, ilman odotusta
HTTP Request -solmu kutsuu mitä tahansa Certyneo-API:n päätepisteestä heti kun se on olemassa: kirjekuoren luominen, sen lähettäminen, asiakirjan tallentaminen, allekirjoitetun PDF:n tai todistekansioon hakeminen.
Itseisännöinti on mahdollista
n8n-ilmentymässä, jonka isännöit, sopimusten metatiedot eivät siirry minkään kolmannen osapuolen kautta: liikenne kulkee palvelimeltasi Certyneolle, eikä minnekään muualle. Painava argumentti oikeusosastoille ja IT-johtajille.
API-avain ja HMAC-allekirjoitus
Yhteys todentuu rajoitetulla API-avaimella, joka voidaan peruuttaa milloin tahansa. Jokainen saapuva tapahtuma on allekirjoitettu HMAC-SHA256:lla: työnkulkusi voi varmistaa, että se todella tulee Certyneoilta.
Saatavilla olevat tapahtumat
Tilaa Webhook-solmu valintasi mukaisiin tapahtumiin. Ne saapuvat reaaliajassa X-Certyneo-Signature -allekirjoitusotsikolla, joka tulee varmistaa n8n:ssä.
| Tapahtuma | Käynnistyy kun… |
|---|---|
Kirjekuori luotuenvelope.created | Kirjekuori on juuri luotu, vielä luonnoksen tilassa. |
Kirjekuori lähetettyenvelope.sent | Kirjekuori poistuu luonnoksesta ja lähtee kohti vastaanottajiaan. |
Kirjekuori allekirjoitettuenvelope.completed | Kaikki vastaanottajat ovat allekirjoittaneet: kirjekuori viimeistellään ja mukana on linkki allekirjoitetun PDF-tiedoston lataamiseen. |
Kirjekuori hylättyenvelope.declined | Vastaanottaja kieltäytyy allekirjoittamasta ja ilmoittaa syyn. |
Kirjekuori peruutettuenvelope.voided | Lähettäjä peruuttaa jo lähteneen kirjekuoren: allekirjoituslinkit tulevat käyttökelvottomiksi. |
Kirjekuori vanhentunutenvelope.expired | Määräaika on umpeutunut ilman, että kaikki vastaanottajat olisivat allekirjoittaneet. |
Kirjekuori palautettu lähettäjälleenvelope.returned_to_sender | Vastaanottaja palauttaa kirjekuoren korjausta varten allekirjoittamisen sijaan. |
Kirjekuori uudelleen lähetettyenvelope.resubmitted | Lähettäjä korjaa ja lähettää uudelleen kirjekuoren, joka oli palautettu hänelle. |
Vastaanottaja allekirjoittirecipient.signed | Vastaanottaja saa allekirjoituksensa valmiiksi. Käynnistyy kerran allekirjoittajaa kohden, ei vain lopuksi. |
Vastaanottaja avasirecipient.viewed | Vastaanottaja avaa kirjekuoren ensimmäistä kertaa — hyödyllinen oikea-aikaiseen muistutukseen. |
Vastaanottaja hyväksyirecipient.approved | Vastaanottaja, jonka rooli on "hyväksyjä", vahvistaa kirjekuoren ilman allekirjoitusta. |
Osoite tavoittamatonrecipient.bounced | Vastaanottajan osoite palauttaa pysyvän virheen (olematon postilaatikko, kuollut verkkotunnus). Uudelleenyritykset pysähtyvät: korjaa osoite ja lähetä kirjekuori uudelleen. |
Mitä voit hallita
Jokainen rivi on HTTP Request -solmun kutsu, jonka sisältö on Header Auth -todentaminen ja Certyneo-avaimesi.
Luo kirjekuori
POST /envelopes — muodostaa kirjekuoren Certyneo-mallinteen tai jo ladatuista asiakirjoista vastaanottajineen.
Lähetä kirjekuori
POST /envelopes/:id/send — siirtää kirjekuoren luonnoksesta ja lähettää allekirjoituskutsut.
Listaa kirjekuoret
GET /envelopes — sivuitettu lista, uusimmat ensin, valinnainen tilansuodatin.
Lataa asiakirja
POST /documents — lähettää PDF-tiedoston mistä tahansa n8n-solmusta, kuten sähköpostin liitteestä tai Drive-tiedostosta.
Listaa mallineet
GET /templates — noutaa mallinneiden tunnisteet, jotta sinun ei tarvitse kovakoodata niitä työnkulkuun.
Lataa allekirjoitettu PDF
GET /envelopes/:id/signed-document — noutaa allekirjoitetun asiakirjan, ja /audit-trail todistusaineistolle.
Asenna liittymä
Tarjoamamme työnkulku sisältää jo webhookin, tapahtumaperustaisen reitityksen, tilauspalvelun kutsun ja lähettämisen esimerkin. Varaa viisi minuuttia.
- 1
Tuo työnkulku
Avaa n8n-sovelluksessa työnkulkuvalikko ja valitse « Import from URL… » sekä liitä malliemme osoite. Voit myös ladata tiedoston ja pudottaa sen kankaalle.
- 2
Luo API-näkymä
Avaa Certyneo → Asetukset → REST API ja luo avain kirjekuori- ja webhook-laajuuksilla. Kopioi se: se näkyy vain kerran.
- 3
Luo Header Auth -tunniste
Lisää n8n-sovelluksessa « Header Auth » -tunniste: nimi « Authorization », arvo « Bearer » sekä avaimesi. Valitse se työnkulun HTTP Request -solmuissa.
- 4
Tilaa ja ota käyttöön
Kopioi Webhook-solmun tuotanto-URL, liitä se tilauspalvelun kutsuun, suorita se kerran ja ota sitten työnkulku käyttöön. Säilytä palautettu « salainen avain »: sitä käytetään tapahtumien allekirjoituksen tarkistamiseen.
- 5
Yhdistä Google Drive
Malli tallentaa allekirjoitetun PDF:n ja sen auditointi-todisteen Drive-palveluun: valitse Google-tilisi molemmissa arkistointisolmuissa. Voit korvata ne S3:lla, SharePointilla tai millä tahansa muulla tallennuspalvelulla, ne käyttävät samaa binäärikenttää.
Turvallisuus ja vaatimustenmukaisuus
n8n-integraatio perustuu Certyneun julkiseen API-rajapintaan, ja se noudattaa samaa vaatimustasoa kuin loput alusta.
- Salasanojen HTTPS-sisennys koko ajan.
- API-navigaattorien rajoittaminen: anna vain tarvittavat oikeudet.
- Jokainen tapahtuma on allekirjoitettu HMAC-SHA256-menetelmällä — tarkista se ennen kuin toimit sen perusteella.
- Salasanan peruuttaminen kuvakkeesta heti kun haluat.
Usein kysyttyjä kysymyksiä
Pitääkö asentaa Certyneo-solmu n8n-sovellukseen?
Se ei ole pakollista. Workflow, jonka julkaisemme, käyttää vain n8nin mukana toimitettavia Webhook- ja HTTP Request -solmuja: ei mitään asennettavaa, ja se toimii yhtä hyvin n8n Cloudissa. Yhteisön solmu on olemassa, jos haluat sen — n8n-nodes-certyneo npmissä, jossa on toimintosolmu, laukaisusolmu ja sen tunniste — ja se asennetaan Settings → Community nodes -kohdan kautta itse isännöidyllä instanssilla. n8n-dokumentaatio varaaa n8n Cloudin solmuille, jotka se on vahvistanut.
Mikä Certyneo-tilaus vaaditaan n8n-käyttöön?
Todellinen avain (sk_live_…) edellyttää tarjontaa, joka sisältää API-käyttöoikeuden (Standard ja sitä ylemmät). Ilmainen ja Henkilökohtainen tarjonta sisältävät hiekkalaatikkoavaimen (sk_test_…), jotta voit käydä läpi koko prosessin testikuorissa ilman sähköposteja allekirjoittajille.
Miten saan API:n salasanan?
Siirry Certyneosta Asetuksiin → REST API ja luo avain soveltuvuuksilla envelopes:read, envelopes:write ja webhooks:write. Se alkaa sk_live_:llä (tai sk_test_:llä hiekkalaatikolle) ja näytetään vain kerran: kopioi se välittömästi.
Toimiiko tämä itse isännöidyssä n8n-instanssissa?
Kyllä, ja se on mielenkiintoisin käyttötapaus. Instanssisi on vain oltava saavutettavissa Internetistä webhookien vastaanottamiseksi: julkinen HTTPS-URL riittää. Yksikään tieto ei siirry kolmannen osapuolen palvelun kautta.
Mikäli järjestelmällä on käsitelty allekirjoitukset?
Yhdessätoista tapahtumaa elinkaaren aikana: kuori luotu, lähetetty, allekirjoitettu, hylätty, peruutettu, vanhentunut, palautettu lähettäjälle, uudelleen jätetty sekä vastaanottaja avasi, allekirjoitti tai hyväksyi. Valitset ne, joihin haluat tilata.
Kuinka voin varmistaa, että tapahtuma todella tulee Certyneon taholta?
Jokainen toimitus sisältää X-Certyneo-Signature-otsikon, joka sisältää pyynnön rungon HMAC-SHA256-tiivisteen, laskettu tilauksen luomisen yhteydessä palautetulla salaisuudella. Vertaa sitä Code-solmussa ennen tapahtuman käsittelyä.
Onko n8n-integraatio maksullinen?
Certyneo ei veloita lisämaksuja. n8n-puolella itse isännöity instanssi on ilmainen; n8n Cloudin osalta jokainen suoritus kuluttaa suunnitelmasi kiintiön.
Enemmän kuin se
Automatisoi sopimukset tänään
Tuo työnkulku, liitä API-avaimesi ja anna allekirjoituksillesi käynnistää loput.