Automatizați semnăturile dvs. cu n8n
n8n este platforma de automatizare open source pe care o puteți găzdui singuri. Două căi către Certyneo: importați fluxul nostru de lucru gata de utilizare, care utilizează doar nodurile Webhook și HTTP Request livrate cu n8n și nu necesită deci nicio instalare, sau instalați nodul comunitar n8n-nodes-certyneo dacă preferați un nod Certyneo în panoul dvs. În ambele cazuri, lipiți cheia API și evenimentele dvs. de semnătură conduc restul stivei dvs.
Fluxul de lucru nu necesită nicio instalare: utilizează doar nodurile livrate cu n8n, deci funcționează peste tot, inclusiv pe n8n Cloud. Nodul comunitar n8n-nodes-certyneo este publicat pe npm și se instalează din Settings → Community nodes pe o instanță auto-găzduită; n8n Cloud, pe de altă parte, propune doar nodurile pe care n8n le-a verificat.
De ce să conectați Certyneo la n8n
n8n vă lasă să alegeți: serviciul gestionat sau propriul dvs. server. În ambele cazuri, integrarea Certyneo utilizează API-ul public și webhook-urile, fără intermediar proprietar între contractele dvs. și instrumentele dvs.
Cele 11 evenimente, nu patru
Nodul Webhook primește ciclul de viață complet al plicurilor — creare, trimitere, deschidere, semnare, refuz, anulare, expirare, returnare expeditorului. Nici un declanșator nu este lăsat deoparte, spre deosebire de conectoarele cu listă fixă.
Întreaga API, fără să așteptați
Nodul HTTP Request apelează orice punct de intrare al API Certyneo de îndată ce există: creează un plic, trimiteți-l, depozitați un document, recuperați PDF-ul semnat sau dosarul de probă.
Auto-găzduire posibilă
Pe o instanță n8n pe care o găzduiți, metadatele contractelor dvs. nu trec prin nici un terț: traficul merge de la serverul dvs. la Certyneo și nicăieri altundeva. Un argument greu pentru echipele juridice și CIO-uri.
Cheie API și semnătură HMAC
Conexiunea se autentifică printr-o cheie API cu domeniu limitat, revocabilă oricând. Fiecare eveniment în sosire este semnat în HMAC-SHA256: fluxul dvs. de lucru poate verifica că provine de la Certyneo.
Evenimente disponibile
Abonați nodul Webhook la evenimentele la alegere. Ele sosesc în timp real, cu antetul de semnătură X-Certyneo-Signature pe care trebuie să-l verificați pe n8n.
| Eveniment | Se dezlopetă când… |
|---|---|
Plic createnvelope.created | Un plic tocmai a fost creat, încă în stare de schiță. |
Envelopă trimisăenvelope.sent | Un plic pleacă din schiță și pornește spre destinatarii săi. |
Envelopă semnatăenvelope.completed | Toți destinatarii au semnat: plic este finalizată, cu o legătură de descărcare a PDF-ului semnat. |
Envelopă refuzatăenvelope.declined | Un destinatar refuză să semneze, cu motivul pe care l-a indicat. |
Plic anulatenvelope.voided | Expeditorul anulează un plic deja trimis: linkurile de semnare devin inutilizabile. |
Plic expiratenvelope.expired | Data limită a trecut fără ca toți destinatarii să semneze. |
Plic returnat expeditoruluienvelope.returned_to_sender | Un destinatar returnează plicul pentru corectare în loc să-l semneze. |
Plic retrimisenvelope.resubmitted | Expeditorul corectează și apoi retrimite un plic care i-a fost returnat. |
Destinatar a semnatrecipient.signed | Un destinatar finalizează semnatura sa. Se declanșează o dată per semnatare, nu doar la sfârșit. |
Destinatar a deschisrecipient.viewed | Un destinatar deschide plicul pentru prima dată — util pentru a relua la momentul potrivit. |
Destinatar a aprobatrecipient.approved | Un destinatar al cărui rol este « aprobator » validează plicul fără a pune o semnătură. |
Adresă inaccesibilărecipient.bounced | Adresa unui destinatar returnează o defecțiune permanentă (cutie inexistentă, domeniu mort). Retragerile se opresc: corectați adresa și trimiteți din nou plicul. |
Ce puteți controla
Fiecare linie este un apel al nodului HTTP Request, cu autentificarea Header Auth și cheia dvs. Certyneo.
Creează o envelopă
POST /envelopes — compune un plic dintr-un șablon Certyneo sau documente deja depuse, cu destinatarii săi.
Trimiteți o envelopă
POST /envelopes/:id/send — scoate plicul din ciornă și trimite invitațiile de semnare.
Listați plicurile
GET /envelopes — listă paginată, cele mai recente în primul rând, cu un filtru de stare opțional.
Depunerea unui document
POST /documents — trimite un PDF din orice nod n8n, inclusiv o anexă de e-mail sau un fișier Drive.
Listați modelele
GET /templates — recuperează identificatorii modelelor dvs. pentru a nu trebui să le codificați în greu în flux de lucru.
Descărcați PDF-ul semnat
GET /envelopes/:id/signed-document — recuperează documentul semnat, și /audit-trail pentru dosarul de dovezi.
A face la integrare
Fluxul de lucru pe care l-am furnizat conține deja webhook-ul, rutarea după eveniment, apelul de abonare și un exemplu de trimitere. Estimați cinci minute.
- 1
Importați fluxul de lucru
În n8n, deschideți meniul fluxului de lucru apoi « Import from URL… » și lipiți adresa modelului nostru. Puteți, de asemenea, descărca fișierul și să-l plasați pe pânză.
- 2
Generarea cheii API
Deschideți Certyneo → Setări → API REST și creați o cheie cu domenii de aplicare plicuri și webhooks. Copiați-o: este afișată o singură dată.
- 3
Creați identificatorul Header Auth
În n8n, adăugați un identificator « Header Auth » : nume « Authorization », valoare « Bearer » urmată de cheia dvs. Selectați-l pe nodurile HTTP Request din fluxul de lucru.
- 4
Abonați-vă apoi activați
Copiați URL-ul de producție al nodului Webhook, lipiți-l în apelul de abonare, executați-l o dată, apoi activați fluxul de lucru. Păstrați « secretul » returnat : acesta servește pentru a verifica semnătura evenimentelor.
- 5
Conectați Google Drive
Modelul depozitează PDF-ul semnat și dovada de audit în Drive: selectați contul Google pe ambele noduri de arhivare. Îi puteți înlocui cu S3, SharePoint sau orice altă stocare, acestea consumă același câmp binar.
Securitate și conformitate
Integrarea n8n se bazează pe API-ul public Certyneo, cu același nivel de exigență ca restul platformei.
- Schimburi criptate prin HTTPS de la capăt la capăt.
- Chei API cu domeniu limitat: acordați doar drepturile necesare.
- Fiecare eveniment este semnat în HMAC-SHA256 — verificați-l înainte de a acționa în funcție de acesta.
- Revocare a unei chei în orice moment din tabloul de bord.
Întrebări frecvente
Este necesar să instalez un nod Certyneo în n8n ?
Nu este obligatoriu. Fluxul de lucru pe care îl publicăm utilizează doar nodurile Webhook și HTTP Request livrate cu n8n: nimic de instalat, și funcționează la fel de bine pe n8n Cloud. Un nod comunitar există dacă îl preferați — n8n-nodes-certyneo pe npm, cu un nod de acțiune, un nod declanșator și identificatorul acestuia — și se instalează din Settings → Community nodes pe o instanță auto-găzduită. Documentația n8n rezervă n8n Cloud nodurilor pe care le-a verificat.
Ce abonament Certyneo este necesar pentru a utiliza n8n ?
O cheie reală (sk_live_…) necesită o ofertă care include acces API (Standard și mai sus). Ofertele Gratuit și Personal au o cheie sandbox (sk_test_…) pentru a parcurge întregul parcurs pe plicuri de test, fără e-mail trimis semnatarilor.
Cum pot obține cheia API?
Din Certyneo, accesați Setări → API REST și creați o cheie cu domeniile envelopes:read, envelopes:write și webhooks:write. Aceasta începe cu sk_live_ (sau sk_test_ pentru sandbox) și este afișată o singură dată: copiați-o imediat.
Funcționează aceasta pe o instanță n8n auto-găzduită ?
Da, și acesta este cazul de utilizare cel mai interesant. Instanța dvs. trebuie pur și simplu să fie accesibilă din Internet pentru a primi webhook-urile noastre: o URL publică în HTTPS este suficientă. Nicio dată nu trece atunci printr-un serviciu terț.
Ce evenimente de semnare sunt acoperite?
Cele unsprezece evenimente din ciclul de viață: plic creat, trimis, semnat, refuzat, anulat, expirat, returnat expeditorului, retrimitere, și destinatar care a deschis, semnat sau aprobat. Voi alegeți pe cei la care vă abonați.
Cum să verificați că un eveniment provine cu adevărat de la Certyneo?
Fiecare livrare poartă un antet X-Certyneo-Signature care conține HMAC-SHA256 al corpului cererii, calculat cu secretul returnat la crearea abonamentului. Comparați-l într-un nod Code înainte de a procesa evenimentul.
Integrarea n8n este plătită?
Certyneo nu percepe nicio taxă suplimentară. Din partea n8n, o instanță auto-găzduită este gratuită; pe n8n Cloud, fiecare execuție consumă cota planului dvs.
Să mergem mai departe
Automatizați contractele dumneavoastră de astăzi
Importați fluxul de lucru, lipiți cheia API dvs. și lăsați semnăturile dvs. să declanșeze restul.