Automatizujte svoje podpisy s n8n
n8n je platforma na automatizáciu s otvoreným zdrojovým kódom, ktorú si môžete hosťovať sami. Dve cesty k Certyneo: importujte náš workflow pripravený na použitie, ktorý používa iba uzly Webhook a HTTP Request dodávané s n8n a nevyžaduje teda žiadnu inštaláciu, alebo nainštalujte komunitný uzol n8n-nodes-certyneo, ak uprednostňujete uzol Certyneo na vašom paneli. V oboch prípadoch vložte váš kľúč API a vaše podpisové udalosti budú riadiť zvyšok vášho stacku.
Workflow nevyžaduje žiadnu inštaláciu: používa iba uzly dodávané s n8n, takže funguje všade, vrátane n8n Cloud. Komunitný uzol n8n-nodes-certyneo je publikovaný na npm a inštaluje sa z Settings → Community nodes na samostatne hosťovanej inštancii; n8n Cloud ponúka iba uzly, ktoré n8n overil.
Prečo pripojiť Certyneo k n8n
n8n vám ponecháva výber: spravovaná služba alebo váš vlastný server. V oboch prípadoch integrácia Certyneo používa verejné API a webhooky bez vlastného sprostredkovateľa medzi vašimi zmluvami a vašimi nástrojmi.
11 udalostí, nie štyri
Uzol Webhook prijíma celý životný cyklus obálok — vytvorenie, odoslanie, otvorenie, podpis, odmietnutie, zrušenie, expirácií, vrátenie odosielateľovi. Žiadny spúšťač nie je vynechaný, na rozdiel od konektorov s pevným zoznamom.
Celé API bez čakania
Uzol HTTP Request volá ľubovoľný vstupný bod API Certyneo hneď ako existuje: vytvoriť obálku, poslať ju, uložiť dokument, získať podpísané PDF alebo zložku dôkazov.
Možnosť vlastného hostingu
Na inštancii n8n, ktorú sami hostíte, metadáta vašich zmlúv neprechádza cez žiadneho tretie stranu: prenosy ide z vášho servera na Certyneo a nikam inde. Silný argument pre právne tímy a IT riaditeľov.
API kľúč a podpis HMAC
Pripojenie sa autentifikuje pomocou API kľúča s obmedzeným rozsahom, ktorý je možné kedykoľvek zrušiť. Každá prichádzajúca udalosť je podpísaná v HMAC-SHA256: váš workflow môže overiť, že pochádza z Certyneo.
Dostupné udalosti
Prihláste uzol Webhook na udalosti podľa vášho výberu. Prichádzajú v reálnom čase s hlavičkou podpisu X-Certyneo-Signature, ktorú treba overiť na strane n8n.
| Událost | Spustí sa, keď… |
|---|---|
Obálka vytvorenáenvelope.created | Obálka bola práve vytvorená, stále je v stave konceptu. |
Odoslaná obálkaenvelope.sent | Obálka opúšťa koncept a smeruje k svojim príjemcom. |
Podpísaná obálkaenvelope.completed | Všetci príjemcovia podpísali: obálka je finalizovaná s odkazom na stiahnutie podpísaného PDF. |
Odmeraná obálkaenvelope.declined | Príjemca odmietne podpísať s uvedeným dôvodom. |
Obálka zrušenáenvelope.voided | Odosielateľ zruší už odoslanú obálku: odkazy na podpisovanie sa stanú nepoužiteľnými. |
Obálka vypršalaenvelope.expired | Lehota skončila bez toho, aby všetci príjemcovia podpísali. |
Obálka vrátená odosielateľovienvelope.returned_to_sender | Príjemca vráti obálku odosielateľovi na opravu namiesto jej podpísania. |
Obálka znova odoslanáenvelope.resubmitted | Odosielateľ opraví a znova pošle obálku, ktorá mu bola vrátená. |
Destinátnik podpísalrecipient.signed | Príjemca dokončí svoj podpis. Spustí sa raz na podpisovateľa, nie len na konci. |
Príjemca otvorilrecipient.viewed | Príjemca prvýkrát otvorí obálku — užitočné na spustenie pripomenutia v správnom čase. |
Príjemca schválilrecipient.approved | Príjemca, ktorého rola je "schválenie", potvrdí obálku bez podpisu. |
Adresa nie je dostupnárecipient.bounced | Adresa príjemcu vracia trvalý neúspech (neexistujúca poštová schránka, neaktívna doména). Opakované pokusy sa zastavenú: opravte adresu a znova odošlite obálku. |
Čo môžete riadiť
Každý riadok je volanie uzla HTTP Request s autentifikáciou Header Auth a vaším kľúčom Certyneo.
Vytvoriť obalku
POST /envelopes — zostaví obálku z šablóny Certyneo alebo už nahratých dokumentov so svojimi príjemcami.
Odoslať obálku
POST /envelopes/:id/send — vytiahne obálku z konceptu a pošle pozvánky na podpis.
Zoznam obálok
GET /envelopes — stránkovaný zoznam, najnovšie na prvom mieste, s voliteľným filtrom stavu.
Nahratie dokumentu
POST /documents — pošle PDF z akéhokoľvek uzla n8n, vrátane e-mailovej prílohy alebo súboru z Disku.
Zoznam šablón
GET /templates — získa identifikátory vašich šablón, aby ste ich nemuseli mať pevne zakódované v pracovnom postupe.
Stiahnuť podpísaný PDF
GET /envelopes/:id/signed-document — získa podpísaný dokument a /audit-trail pre záznam dôkazov.
Nastavenie integrácie
Pracovný postup, ktorý poskytujeme, už obsahuje webhook, smerovanie podľa udalostí, volanie predplatného a príklad odoslania. Počítajte s päť minútami.
- 1
Importovať pracovný postup
V n8n otvorte menu pracovného postupu a zvoľte « Import from URL… » a vložte adresu našej šablóny. Môžete tiež stiahnuť súbor a priviesť ho na plátno.
- 2
Generovať vašu kľúč API
Otvorte Certyneo → Nastavenia → REST API a vytvorte kľúč s rozsahmi obálky a webhookov. Skopírujte ho: je zobrazený iba raz.
- 3
Vytvoriť identifikátor Header Auth
V n8n pridajte identifikátor « Header Auth »: názov « Authorization », hodnota « Bearer » nasledovaná vašim kľúčom. Vyberte ho na uzloch HTTP Request pracovného postupu.
- 4
Prihlásiť sa na odber a aktivovať
Skopírujte URL produkcie z uzla Webhook, vložte ju do volania predplatného, spustite ho raz a potom aktivujte pracovný postup. Uchráňte vrátený « secret »: slúži na overenie podpisu udalostí.
- 5
Pripojiť Google Drive
Šablóna nahrá podpísaný PDF a jeho auditný dôkaz do vášho Disku: vyberte svoj účet Google na oboch uzloch archivizácie. Môžete ich nahradiť S3, SharePointom alebo akýmkoľvek iným úložiskom, spotrebujú to isté binárne pole.
Bezpečnosť a súlad
Integrácia n8n je založená na verejnom API Certyneo s rovnakou úrovňou požiadaviek ako zvyšok platformy.
- Šifrovaná výmena cez HTTPS end-to-end.
- Kľúče API s obmedzeným rozsahom: udelite iba potrebné oprávnenia.
- Každá udalosť je podpísaná v HMAC-SHA256 — overte ju pred konáním.
- Zrušenie kľúča kedykoľvek z vášho pultu.
Často sa pýtajúce otázky
Je potrebné nainštalovať uzol Certyneo v n8n?
Nie je to povinné. Workflow, ktorý publikujeme, používa iba uzly Webhook a HTTP Request dodávané s n8n: nič na inštaláciu a funguje rovnako dobre na n8n Cloud. Komunitný uzol existuje, ak ho uprednostňujete — n8n-nodes-certyneo na npm, s uzlom akcie, uzlom spúšťača a jeho identifikátorom — a inštaluje sa z Settings → Community nodes na samostatne hosťovanej inštancii. Dokumentácia n8n rezervuje n8n Cloud iba pre uzly, ktoré overila.
Aké predplatné Certyneo je potrebné na používanie n8n?
Skutočný kľúč (sk_live_…) vyžaduje ponuku vrátane prístupu API (Standard a vyšší). Ponuky Bezplatné a Osobné majú sandbox kľúč (sk_test_…) na prechádzanie celou cestou na testovacích obálkach bez e-mailu poslaného podpisovateľom.
Ako získať moju kľúč API?
Z Certyneo prejdite na Nastavenia → REST API a vytvorte kľúč s rozsahmi envelopes:read, envelopes:write a webhooks:write. Začína sa na sk_live_ (alebo sk_test_ pre sandbox) a je zobrazený iba raz: skopírujte si ho okamžite.
Funguje to na samostatne spravovanej inštancii n8n?
Áno, a je to najzaujímavejší prípad použitia. Vaša inštancia musí byť jednoducho dostupná z internetu na príjem našich webhookov: stačí verejná URL v HTTPS. Žiadne údaje sa potom neprenášajú cez službu tretej strany.
Ktoré podpisové udalosti sú pokryté?
Jedenásť udalostí životného cyklu: obálka vytvorená, odoslaná, podpísaná, odmietnutá, zrušená, expirovaná, vrátená odosielateľovi, znovu odoslaná a príjemca otvoril, podpísal alebo schválil. Zvolíte si tie, na ktoré sa prihlásite na odber.
Ako overiť, že udalosť naozaj pochádza od Certyneo?
Každá doručka obsahuje hlavičku X-Certyneo-Signature, ktorá obsahuje HMAC-SHA256 tela požiadavky, vypočítané s tajomstvom vráteným pri vytvorení odberného miesta. Porovnajte ho v uzle Code pred spracovaním udalosti.
Je integrácia n8n platená?
Certyneo neúčtuje žiadny doplnkový poplatok. Na strane n8n je samostatne hostovaná inštancia bezplatná; na n8n Cloud každé spustenie spotrebúva kvótu vášho plánu.
Pokračovať ďalej
Automatizujte vaše dohody dnes
Importujte workflow, vložte svoju kľúč API a nechajte vaše podpisy spustiť zvyšok.