Automatizálja aláírásait az n8n-nel
Az n8n egy nyílt forráskódú automatizálási platform, amelyet saját maga lehet üzemeltetni. Kétféle módszer a Certyneo eléréséhez: importálja az előkészített munkafolyamatunkat, amely csak az n8n-nel szállított Webhook és HTTP Request csomópontokat használja, és ezért nem igényel telepítést, vagy telepítse az n8n-nodes-certyneo közösségi csomópontot, ha inkább egy Certyneo csomópontot szeretne a paneljében. Mindkét esetben illessze be az API-kulcsot és az aláírási események vezérlik a többi stackjét.
A munkafolyamat nem igényel telepítést: csak az n8n-nel szállított csomópontokat használja, így mindenütt működik, az n8n Cloud-on is. Az n8n-nodes-certyneo közösségi csomópont az npm-en publikálva van, és az Settings → Community nodes menüpontból telepíthető egy saját üzemeltetésű instanciára; az n8n Cloud viszont csak az n8n által ellenőrzött csomópontokat kínálja.
Miért csatlakoztassa a Certyneót az n8n-hez
Az n8n lehetőséget ad a választásra: a felügyelt szolgáltatás vagy a saját szerver. Mindkét esetben a Certyneo integráció a nyilvános API-t és webhookokat használja, saját tulajdonú közvetítő nélkül a szerződések és az eszközök között.
11 esemény, nem négy
A Webhook csomópont megkapja a borítékok teljes életciklusát — létrehozás, küldés, megnyitás, aláírás, elutasítás, törlés, lejárat, visszaküldés a feladónak. Egyetlen trigger sem marad figyelmen kívül, ellentétben a rögzített listájú összekötőkkel.
Az egész API, késedelem nélkül
A HTTP Request csomópont meghívja a Certyneo API bármely végpontját, amint létezik: boríték létrehozása, küldése, dokumentum feltöltése, az aláírt PDF vagy az igazolási mappa lekérése.
Saját üzemeltetés lehetséges
Az Ön által üzemeltetett n8n-példányon a szerződések metaadatai nem haladnak át harmadik félen: a forgalom a szerverről a Certyneo felé halad, és sehová máshová. Erős érv a jogi csapatoknak és a CTO-knak.
API-kulcs és HMAC aláírás
A kapcsolat egy korlátozott hatókörű, bármikor visszavonható API-kulccsal hitelesíti magát. Minden bejövő eseményt HMAC-SHA256 aláír: a munkafolyamat ellenőrizheti, hogy valóban a Certyneótól származik-e.
Elérhető események
Iratkozzon fel a Webhook csomóponttal a választott eseményekre. Valós időben érkeznek, az X-Certyneo-Signature aláírási fejléccel, amelyet az n8n-ben ellenőrizni kell.
| Esemény | Ekkor hajtódik végre... |
|---|---|
Boríték létrehozvaenvelope.created | Egy boríték éppen most lett létrehozva, még vázlat állapotban. |
Boríték elküldveenvelope.sent | Egy boríték elhagyja a vázlatot, és az adresszánsai felé indul. |
Boríték aláírvaenvelope.completed | Minden címzett aláírt: a boríték véglegesítésre kerül, az aláírt PDF letöltési linkjével. |
Boríték elutasítvaenvelope.declined | Egy címzett megtagadja az aláírást, az általa megadott okkal. |
Boríték visszavonvaenvelope.voided | A feladó visszavon egy már elküldött borítékot: az aláírási linkek használhatatlanná válnak. |
Boríték lejártenvelope.expired | A határidő lejárt anélkül, hogy az összes címzett aláírta volna. |
Boríték visszaküldve a feladónakenvelope.returned_to_sender | Egy címzett a boríték aláírása helyett korrekció céljából visszaküldi azt. |
Boríték újra benyújtvaenvelope.resubmitted | A feladó kijavít, majd újra elküld egy olyan boríékot, amely visszaküldték neki. |
Címzett aláírtrecipient.signed | Egy címzett befejezi az aláírását. Aláírónként egyszer aktiválódik, nem csak a végén. |
Címzett megnyitottarecipient.viewed | Egy címzett első alkalommal megnyit egy borítékot — hasznos a megfelelő időben történő felkészüléshez. |
Címzett jóváhagyottrecipient.approved | Az olyan címzett, akinek a szerepe "jóváhagyó", aláírás nélkül érvényesíti a borítékot. |
Elérhetetlen címrecipient.bounced | Egy címzett címe állandó hibát ad vissza (nem létező postafiók, halott tartomány). Az újraküldések leállnak: javítsa ki a címet és küldje újra a borítékot. |
Amit irányíthat
Minden sor egy HTTP Request csomópont hívása, Header Auth hitelesítéssel és a Certyneo kulcsával.
Boríték létrehozása
POST /envelopes — borítékot hoz létre Certyneo sablon vagy már feltöltött dokumentumok alapján, a címzettjei között.
Boríték küldése
POST /envelopes/:id/send — a borítékot kivonja a vázlatból és aláírási meghívásokat küld.
Borítékok listázása
GET /envelopes — oldalakra bontott lista, a legújabbak előre, választható státusz szűrővel.
Dokumentum feltöltése
POST /documents — PDF-et küld bármely n8n csomópontból, többek között e-mail mellékletből vagy Drive fájlból.
Sablonok listázása
GET /templates — lekéri a sablonok azonosítóit, hogy ne kelljen azokat kódosan beépíteni a munkafolyamatba.
Az aláírt PDF letöltése
GET /envelopes/:id/signed-document — lekéri az aláírt dokumentumot, és /audit-trail a bizonyítási mappához.
Beállítás az integrációra
A munkafolyamat, amelyet biztosítunk, már tartalmazza a webhookot, az esemény alapján történő útválasztást, az előfizetési hívást és egy küldési példát. Számítson öt percre.
- 1
A munkafolyamat importálása
Az n8n-ben nyissa meg a munkafolyamat menüjét, majd az « Import from URL… » lehetőséget, és illessze be a sablonunk címét. A fájlt letöltheti és a vászonra helyezheti.
- 2
API kulcs létrehozása
Nyissa meg a Certyneót → Beállítások → REST API, és hozzon létre egy kulcsot boríték- és webhook-hatáskörökkel. Másolja ki: csak egyszer jelenik meg.
- 3
A Header Auth azonosító létrehozása
Az n8n-ben adjon hozzá egy « Header Auth » azonosítót: « Authorization » nevet, « Bearer » értéket, majd az API-kulcsot. Válassza ki a munkafolyamat HTTP Request csomópontjainál.
- 4
Előfizetés majd aktiválás
Másolja ki a Webhook csomópont termelési URL-jét, illessze be az előfizetési hívásba, futtassa le egyszer, majd aktiválja a munkafolyamatot. Tartsa meg a visszaadott « titkos » értéket: az események aláírásának ellenőrzéséhez szükséges.
- 5
Google Drive csatlakoztatása
A sablon az aláírt PDF-et és az audit naplóját az Ön Drive-ba helyezi: válassza ki Google-fiókját mindkét archiválási csomóponton. Lecserélheti őket S3, SharePoint vagy bármilyen más tárolóra, ugyanazt a bináris mezőt használják.
Biztonság és megfelelés
Az n8n integráció a Certyneo nyilvános API-ra épül, ugyanolyan szigorúsági szinttel, mint a platform többi része.
- Szifrozták az HTTPS keresztül teljesen a cserélők között.
- API kulcsok korlátozott jogokkal: adjon csak annyi jogot, amit szükséges.
- Minden eseményt HMAC-SHA256-ban írnak alá — ellenőrizze, mielőtt cselekedne.
- Minden időről törölheti a kulcsot a panelen.
Gyakran feltett kérdések
Szükséges egy Certyneo csomópont az n8n-ben?
Ez nem kötelező. Az általunk közzétett munkafolyamat csak az n8n-nel szállított Webhook és HTTP Request csomópontokat használja: nincs mit telepíteni, és az n8n Cloud-on is ugyanolyan jól működik. Egy közösségi csomópont létezik, ha ezt szeretné — n8n-nodes-certyneo az npm-en, egy műveleti csomóponttal, egy eseményindító csomóponttal és annak azonosítójával — és az Settings → Community nodes menüpontból telepíthető egy saját üzemeltetésű instanciára. Az n8n dokumentáció az n8n Cloud-ot az általa ellenőrzött csomópontokra tartja fenn.
Milyen Certyneo előfizetés szükséges az n8n használatához?
Egy valódi kulcs (sk_live_…) API-hozzáférést tartalmazó csomagot igényel (Standard és magasabb). A Gratuit és Personal csomagok homokozó-kulcsot (sk_test_…) kapnak a teljes felhasználói út teszteléséhez tesztborítékokon, anélkül, hogy e-mail lenne küldve az aláíróknak.
Miben tudok kapcsolatba lépni a kulcsomat?
A Certyneóból lépjen a Beállítások → REST API felületre, és hozzon létre egy kulcsot az envelopes:read, envelopes:write és webhooks:write hatókörökkel. Az sk_live_ karakterekkel kezdődik (vagy sk_test_ a sandbox-hoz) és csak egyszer jelenik meg: másolja azonnal.
Működik-e ez egy saját üzemeltetésű n8n-példányon?
Igen, és ez a legérdekesebb felhasználási eset. A példánynak csak az internetről elérhetőnek kell lennie a webhookok fogadásához: egy nyilvános HTTPS URL elegendő. Ebben az esetben egyik adat sem halad át egy harmadik féltől származó szolgáltatáson.
Melyik aláírási események vannak szertartásban?
Az életciklus tizenegy eseménye: boríték létrehozva, elküldve, aláírva, elutasítva, visszavonva, lejárt, visszaküldve a feladónak, újra benyújtva, valamint címzett megnyitva, aláírva vagy jóváhagyva. Ön kiválasztja, melyekre feliratkozik.
Hogyan ellenőrizhető, hogy az esemény valóban a Certyneóból származik?
Minden szállítás X-Certyneo-Signature fejlécet tartalmaz, amely a kérés törzsének HMAC-SHA256 értékét tartalmazza, az előfizetés létrehozásakor visszaküldött titok segítségével kiszámítva. Hasonlítsa össze egy Code csomópontban az esemény feldolgozása előtt.
Az n8n integráció fizetős?
A Certyneo nem számít fel dodatás. Az n8n oldalon az önüzemeltetett instancia ingyenes; az n8n Cloud-on minden végrehajtás fogyasztja a csomagjára vonatkozó kvótáját.
Tovább
Automatizálja a szerződéseket ma már.
Importálja a munkafolyamatot, illessze be API-kulcsát, és hagyja, hogy az aláírások indítsák el a többit.