Automatizujte své podpisy pomocí n8n
n8n je open-source platforma pro automatizaci, kterou si můžete hostovat sami. Dva způsoby, jak se připojit k Certyneo: importujte náš připravený workflow, který používá pouze uzly Webhook a HTTP Request dodávané s n8n a nevyžaduje žádnou instalaci, nebo nainstalujte komunální uzel n8n-nodes-certyneo, pokud preferujete uzel Certyneo ve svém panelu. V obou případech vložte svůj klíč API a vaše události podpisu řídí zbytek vašeho stacku.
Workflow nevyžaduje žádnou instalaci: používá pouze uzly dodávané s n8n, takže funguje všude, včetně n8n Cloud. Komunální uzel n8n-nodes-certyneo je publikován na npm a instaluje se z Settings → Community nodes na samostatně hostované instanci; n8n Cloud nabízí pouze uzly, které n8n ověřil.
Proč připojit Certyneo k n8n
n8n vám dává na výběr: spravovanou službu nebo svůj vlastní server. V obou případech integrace Certyneo používá veřejné API a webhooky bez proprietárního prostředníka mezi vašimi smlouvami a vašimi nástroji.
11 událostí, ne čtyři
Uzel Webhook přijímá celý životní cyklus obálek — vytvoření, odeslání, otevření, podpis, zamítnutí, zrušení, vypršení, vrácení odesílateli. Žádná aktivační událost není vynechána, na rozdíl od konektorů se zafixovaným seznamem.
Celé API, bez čekání
Uzel HTTP Request volá jakýkoli koncový bod API Certyneo, jakmile existuje: vytvoření obálky, její odeslání, nahrání dokumentu, načtení podepsaného PDF nebo složky důkazů.
Možné vlastní hostování
Na instanci n8n, kterou hostujete sami, metadata vašich smluv neprojdou žádným třetím subjektem: provoz jde z vašeho serveru na Certyneo a nikam jinam. Důležitý argument pro právní týmy a IT ředitele.
API klíč a podpis HMAC
Připojení se ověřuje pomocí klíče API s omezeným rozsahem, který lze kdykoliv odvolat. Každá příchozí událost je podepsána algoritmem HMAC-SHA256: váš workflow může ověřit, že pochází z Certyneo.
Dostupné události
Přihlaste uzel Webhook k událostem podle vašeho výběru. Přicházejí v reálném čase s hlavičkou podpisu X-Certyneo-Signature, kterou je třeba ověřit na straně n8n.
| Událost | Se déclenche při… |
|---|---|
Obálka vytvořenaenvelope.created | Obálka byla právě vytvořena, stále v režimu návrhu. |
Odeslaná obálkaenvelope.sent | Obálka opouští návrh a putuje k jejím příjemcům. |
Obálka podepsánaenvelope.completed | Všichni příjemci podepsali: obálka je finalizována s odkazem na stažení podepsaného PDF. |
Odpovědná obálka odmítnutaenvelope.declined | Příjemce se odmítne podepsat, spolu s důvodem, který uvedl. |
Obálka zrušenaenvelope.voided | Odesílatel zruší již odeslané obálky: odkazy na podpis se stanou nepoužitelnými. |
Obálka vypršelaenvelope.expired | Lhůta uplynula bez podpisu všech příjemců. |
Obálka vrácena odesílatelienvelope.returned_to_sender | Příjemce vrátí obálku k opravě místo jejího podpisu. |
Obálka znovu odeslánaenvelope.resubmitted | Odesílatel opraví a poté znovu odešle obálku, která mu byla vrácena. |
Příjemce podepsalrecipient.signed | Příjemce dokončil svou podpis. Seznam se vyvolá jednou pro každého podepsatele, nejen na konci. |
Příjemce otevřelrecipient.viewed | Příjemce poprvé otevře obálku — užitečné pro obnovu v správný čas. |
Příjemce schválilrecipient.approved | Příjemce, jehož role je "schvalovatel", validuje obálku bez připojení podpisu. |
Adresa není dosažitelnárecipient.bounced | Adresa příjemce vrátila trvalou chybu (neexistující poštovní schránka, mrtvá doména). Opakované pokusy se zastavují: opravte adresu a obálku odešlete znovu. |
Co můžete ovládat
Každý řádek je volání uzlu HTTP Request s ověřením Header Auth a vaším klíčem Certyneo.
Vytvořit obálku
POST /envelopes — vytvoří obálku ze šablony Certyneo nebo již nahraných dokumentů s jejími příjemci.
Odeslat obálku
POST /envelopes/:id/send — vyjme obálku z konceptu a odešle pozvánky k podepsání.
Vypsat obálky
GET /envelopes — stránkovaný seznam, nejnovější první, s volitelným filtrem stavu.
Nahrát dokument
POST /documents — odešle PDF z libovolného uzlu n8n, včetně e-mailové přílohy nebo souboru z Drivu.
Vypsat šablony
GET /templates — načte identifikátory vašich šablon, abyste je nemuseli kódovat v pracovním postupu.
Stáhnout podepsané PDF
GET /envelopes/:id/signed-document — načte podepsaný dokument, a /audit-trail pro složku důkazů.
Nastavení integrace
Workflow, který poskytujeme, již obsahuje webhook, směrování podle událostí, volání předplatného a příklad odeslání. Počítejte s pěti minutami.
- 1
Importovat workflow
V n8n otevřete nabídku workflow a zvolte « Import from URL… » a vložte adresu našeho šablony. Můžete také stáhnout soubor a přetáhnout jej na plátno.
- 2
Generování vaší API klíče
Otevřete Certyneo → Nastavení → REST API a vytvořte klíč s rozsahy obálek a webhooků. Zkopírujte ji: zobrazuje se pouze jednou.
- 3
Vytvořit identifikátor Header Auth
V n8n přidejte identifikátor « Header Auth »: název « Authorization », hodnota « Bearer » následovaná vaším klíčem. Vyberte jej v uzlech HTTP Request workflowu.
- 4
Přihlásit se k odběru a aktivovat
Zkopírujte URL produkčního uzlu Webhook, vložte ji do volání předplatného, spusťte jej jednou a poté aktivujte workflow. Uschovejte « secret » který je vrácen: slouží k ověření podpisu událostí.
- 5
Připojit Google Drive
Šablona uloží podepsaný PDF a jeho auditní důkaz do vašeho Drive: vyberte svůj účet Google v obou archivačních uzlech. Můžete je nahradit S3, SharePointem nebo jakýmkoli jiným úložištěm, konzumují stejné binární pole.
Bezpečnost a shody
Integrace n8n vychází z veřejného API Certyneo se stejnou úrovní požadavků jako zbytek platformy.
- Šifrování dat v HTTPS od začátku k konci.
- Omezené API klíče: přidávejte pouze potřebné práva.
- Každá událost je podepsána v HMAC-SHA256 — ověřte ji před tím, než na ni budete jednat.
- Zrušení klíče v libové chvíli z vašeho panelu.
Často se ptáte
Je třeba nainstalovat uzel Certyneo v n8n?
Není to povinné. Workflow, který publikujeme, používá pouze uzly Webhook a HTTP Request dodávané s n8n: nic k instalaci a funguje stejně dobře na n8n Cloud. Existuje komunální uzel, pokud jej preferujete — n8n-nodes-certyneo na npm, s uzlem akce, uzlem spouště a jeho identifikátorem — a instaluje se z Settings → Community nodes na samostatně hostované instanci. Dokumentace n8n rezervuje n8n Cloud pouze pro uzly, které ověřila.
Jaké předplatné Certyneo je potřebné k používání n8n?
Skutečný klíč (sk_live_…) vyžaduje nabídku zahrnující přístup k API (Standard a více). Nabídky Zdarma a Osobní mají klíč sandbox (sk_test_…) k procházení celého procesu na testovacích obálkách bez e-mailu odeslaného signatářům.
Jak získat moje API klíč?
V aplikaci Certyneo přejděte na Nastavení → REST API a vytvořte klíč s rozsahy envelopes:read, envelopes:write a webhooks:write. Začíná na sk_live_ (nebo sk_test_ pro testovací prostředí) a je zobrazen pouze jednou: zkopírujte jej okamžitě.
Funguje to na vlastní instanci n8n?
Ano, a to je nejzajímavější případ použití. Vaše instance musí být jednoduše dosažitelná z internetu, aby mohla přijímat naše webhooky: stačí veřejná URL v HTTPS. Žádná data se nepředávají třetí straně.
Jaké podpisové události jsou zahrnuty?
Jedenáct událostí životního cyklu: obálka vytvořena, poslána, podepsána, odmítnuta, zrušena, vypršela, vrácena odesílateli, znovu odeslána a příjemce otevřel, podepsal nebo schválil. Zvolíte si, na které se chcete přihlásit.
Jak ověřit, že událost skutečně pochází z Certyneo?
Každé doručení obsahuje hlavičku X-Certyneo-Signature, která má HMAC-SHA256 těla požadavku vypočítaný pomocí tajného klíče vráceného při vytvoření předplatného. Porovnejte jej v uzlu Code před zpracováním události.
Je integrace n8n zpoplatněná?
Certyneo si neúčtuje žádný příplatek. Na straně n8n je vlastní instance bez poplatků; v n8n Cloud každé provedení spotřebovává kvótu vašeho plánu.
Dále
Automatické závody od současného dne
Importujte pracovní postup, vložte svůj klíč API a nechte své podpisy spustit zbytek.