Αυτοματοποιήστε τις υπογραφές σας με το n8n
Το n8n είναι η πλατφόρμα αυτοματοποίησης ανοικτού κώδικα που μπορείτε να φιλοξενήσετε μόνοι σας. Δύο δρόμοι προς το Certyneo: εισάγετε τη δική μας ετοιμόχρηστη ροή εργασίας, η οποία χρησιμοποιεί μόνο τους κόμβους Webhook και HTTP Request που παρέχονται με το n8n και επομένως δεν απαιτεί κανένα κόμβο εγκατάστασης, ή εγκαταστήστε τον κόμβο κοινότητας n8n-nodes-certyneo εάν προτιμάτε έναν κόμβο Certyneo στον πίνακα ελέγχου σας. Και στις δύο περιπτώσεις, επικολλήστε το κλειδί API σας και τα γεγονότα υπογραφής σας θα οδηγήσουν το υπόλοιπο stack σας.
Η ροή εργασίας δεν απαιτεί κανένα κόμβο εγκατάστασης: χρησιμοποιεί μόνο τους κόμβους που παρέχονται με το n8n, επομένως λειτουργεί παντού, συμπεριλαμβανομένου του n8n Cloud. Ο κόμβος κοινότητας n8n-nodes-certyneo δημοσιεύεται στο npm και εγκαθίσταται από το Settings → Community nodes σε μια αυτό-φιλοξενούμενη παρουσία. το n8n Cloud, από την άλλη πλευρά, προσφέρει μόνο τους κόμβους που το n8n έχει επαληθεύσει.
Γιατί να συνδέσετε το Certyneo με το n8n
Το n8n σας δίνει την επιλογή: η διαχειριζόμενη υπηρεσία ή ο δικός σας διακομιστής. Και στις δύο περιπτώσεις, η ολοκλήρωση Certyneo χρησιμοποιεί το δημόσιο API και webhooks, χωρίς κάποιο ιδιόκτητο ενδιάμεσο μεταξύ των συμβάσεών σας και των εργαλείων σας.
Τα 11 συμβάντα, όχι τέσσερα
Ο κόμβος Webhook λαμβάνει ολόκληρο τον κύκλο ζωής των φακέλων — δημιουργία, αποστολή, άνοιγμα, υπογραφή, άρνηση, ακύρωση, λήξη, επιστροφή στον αποστολέα. Κανένα σκανδάλι δεν αφήνεται έξω, σε αντίθεση με τους συνδέσμους με σταθερή λίστα.
Ολόκληρο το API, χωρίς αναμονή
Ο κόμβος HTTP Request καλεί οποιοδήποτε τελικό σημείο του Certyneo API μόλις υπάρχει: δημιουργία φακέλου, αποστολή του, κατάθεση εγγράφου, ανάκτηση του υπογεγραμμένου PDF ή του φακέλου απόδειξης.
Αυτο-φιλοξενία δυνατή
Σε μια παρουσία n8n που φιλοξενείτε, τα μεταδεδομένα των συμβάσεών σας δεν διέρχονται από κανέναν τρίτο: η κίνηση πηγαίνει από τον διακομιστή σας στο Certyneo, και πουθενά αλλού. Ένα ισχυρό επιχείρημα για τα νομικά τμήματα και τους CIO.
Κλειδί API και υπογραφή HMAC
Η σύνδεση ταυτοποιείται μέσω ενός κλειδιού API περιορισμένου εύρους, που μπορεί να ανακληθεί ανά πάσα στιγμή. Κάθε εισερχόμενο γεγονός υπογράφεται σε HMAC-SHA256: η ροή εργασίας σας μπορεί να επαληθεύσει ότι προέρχεται πράγματι από το Certyneo.
Διαθέσιμα γεγονότα
Εγγραφείτε τον κόμβο Webhook στα γεγονότα της επιλογής σας. Φτάνουν σε πραγματικό χρόνο, με την κεφαλίδα υπογραφής X-Certyneo-Signature που πρέπει να επαληθευθεί στο n8n.
| Εγχείρηση | Εκτελείται όταν… |
|---|---|
Φάκελος δημιουργήθηκεenvelope.created | Ένας φάκελος μόλις δημιουργήθηκε, ακόμα σε κατάσταση σχεδίου. |
Φάκελος εστάληenvelope.sent | Ένας φάκελος φεύγει από το σχέδιο και κατευθύνεται προς τους παραλήπτες του. |
Φάκελος υπογεγραμμένοςenvelope.completed | Όλοι οι παραλήπτες έχουν υπογράψει: ο φάκελος ολοκληρώνεται, με έναν σύνδεσμο λήψης του υπογεγραμμένου PDF. |
Φάκελος απορρίφθηκεenvelope.declined | Ένας παραλήπτης αρνείται να υπογράψει, με το λόγο που υπέδειξε. |
Φάκελος ακυρώθηκεenvelope.voided | Ο αποστολέας ακυρώνει ένα φάκελο που είχε ήδη αποσταλεί: οι σύνδεσμοι υπογραφής καθίστανται άχρηστοι. |
Φάκελος έληξεenvelope.expired | Η προθεσμία έχει περάσει χωρίς όλοι οι παραλήπτες να έχουν υπογράψει. |
Φάκελος επιστράφηκε στον αποστολέαenvelope.returned_to_sender | Ένας παραλήπτης επιστρέφει το φάκελο για διόρθωση αντί να τον υπογράψει. |
Φάκελος υποβλήθηκε ξανάenvelope.resubmitted | Ο αποστολέας διορθώνει και στη συνέχεια επαναποστέλλει ένα φάκελο που του είχε επιστραφεί. |
Ο παραλήπτης υπέγραψεrecipient.signed | Ένας παραλήπτης ολοκληρώνει την υπογραφή του. Ενεργοποιείται μία φορά ανά υπογράφοντα, όχι μόνο στο τέλος. |
Ο παραλήπτης άνοιξεrecipient.viewed | Ένας παραλήπτης ανοίγει το φάκελο για πρώτη φορά — χρήσιμο για να κάνετε υπενθύμιση στην κατάλληλη στιγμή. |
Ο παραλήπτης ενέκρινεrecipient.approved | Ένας παραλήπτης του οποίου ο ρόλος είναι «εγκριτής» επικυρώνει το φάκελο χωρίς να προσθέσει υπογραφή. |
Διεύθυνση μη προσβάσιμηrecipient.bounced | Η διεύθυνση ενός παραλήπτη επιστρέφει μόνιμη αποτυχία (ανύπαρκτη θυρίδα, νεκρό domain). Οι επανεκκινήσεις σταματούν: διορθώστε τη διεύθυνση και στείλτε ξανά το φάκελο. |
Αυτό που μπορείτε να ελέγχετε
Κάθε γραμμή είναι μια κλήση του κόμβου HTTP Request, με την ταυτοποίηση Header Auth και το κλειδί Certyneo σας.
Δημιουργία φακέλου
POST /envelopes — συνθέτει έναν φάκελο από ένα πρότυπο Certyneo ή έγγραφα που έχουν ήδη κατατεθεί, με τους παραλήπτες του.
Αποστολή φακέλου
POST /envelopes/:id/send — βγάζει τον φάκελο από το σχέδιο και στέλνει τις προσκλήσεις υπογραφής.
Λίστα φακέλων
GET /envelopes — κατάλογος με σελιδοποίηση, τα πιο πρόσφατα πρώτα, με ένα προαιρετικό φίλτρο κατάστασης.
Κατάθεση ενός εγγράφου
POST /documents — στέλνει ένα PDF από οποιονδήποτε κόμβο n8n, συμπεριλαμβανομένης μιας συνημμένης αρχείου ηλεκτρονικού ταχυδρομείου ή ενός αρχείου Drive.
Λίστα προτύπων
GET /templates — ανακτά τα αναγνωριστικά των προτύπων σας για να μην χρειάζεται να τα κωδικοποιήσετε στη ροή εργασίας.
Λήψη του υπογεγραμμένου PDF
GET /envelopes/:id/signed-document — ανακτά το υπογεγραμμένο έγγραφο και /audit-trail για το αρχείο αποδείξεων.
Εγκατάσταση της ενδυνάμωσης
Η ροή εργασίας που παρέχουμε περιέχει ήδη το webhook, την δρομολόγηση κατά συμβάν, την κλήση συνδρομής και ένα παράδειγμα αποστολής. Υπολογίστε πέντε λεπτά.
- 1
Εισαγωγή της ροής εργασίας
Στο n8n, ανοίξτε το μενού ροής εργασίας και επιλέξτε « Import from URL… » και επικολλήστε τη διεύθυνση του προτύπου μας. Μπορείτε επίσης να κατεβάσετε το αρχείο και να το ρίξετε στον καμβά.
- 2
Δημιουργήστε την API Key σας
Ανοίξτε το Certyneo → Ρυθμίσεις → API REST και δημιουργήστε ένα κλειδί με τις εμβέλειες envelopes και webhooks. Αντιγράψτε το: εμφανίζεται μόνο μία φορά.
- 3
Δημιουργία του αναγνωριστικού Header Auth
Στο n8n, προσθέστε ένα αναγνωριστικό « Header Auth »: όνομα « Authorization », τιμή « Bearer » ακολουθούμενη από το κλειδί σας. Επιλέξτε το στους κόμβους HTTP Request της ροής εργασίας.
- 4
Συνδρομή και ενεργοποίηση
Αντιγράψτε την URL παραγωγής του κόμβου Webhook, επικολλήστε την στην κλήση συνδρομής, εκτελέστε την μία φορά και στη συνέχεια ενεργοποιήστε τη ροή εργασίας. Διατηρήστε το « secret » που επιστράφη: χρησιμοποιείται για την επαλήθευση της υπογραφής των συμβάντων.
- 5
Σύνδεση Google Drive
Το πρότυπο καταχωρεί το υπογεγραμμένο PDF και την απόδειξη ελέγχου του στη Μονάδα σας: επιλέξτε τον λογαριασμό σας Google στους δύο κόμβους αρχειοθέτησης. Μπορείτε να τα αντικαταστήσετε με S3, SharePoint ή οποιοδήποτε άλλο αποθηκευτικό χώρο, καταναλώνουν το ίδιο δυαδικό πεδίο.
Ασφάλεια και συμμόρφωση
Η ολοκλήρωση n8n βασίζεται στο δημόσιο API Certyneo, με το ίδιο επίπεδο απαίτησης με το υπόλοιπο της πλατφόρμας.
- Εξαλέχθηκαν τα δεδομένα με HTTPS απ' έως έως.
- API Keys με περιορισμό: δώστε μόνο τους υπάρχοντες δικαιώματα.
- Κάθε συμβάν υπογράφεται σε HMAC-SHA256 — επαληθεύστε το πριν ενεργήσετε σε αυτό.
- Ακύρωση μιας κλείδας από το πίνακα διαχείρισης σε οπτική ύπαρξη.
Επικαιρότερα ερωτήματα
Πρέπει να εγκαταστήσω έναν κόμβο Certyneo στο n8n;
Δεν είναι υποχρεωτικό. Η ροή εργασίας που δημοσιεύουμε χρησιμοποιεί μόνο τους κόμβους Webhook και HTTP Request που παρέχονται με το n8n: τίποτα να εγκαταστήσετε και λειτουργεί εξίσου καλά στο n8n Cloud. Υπάρχει ένας κόμβος κοινότητας εάν το προτιμάτε — n8n-nodes-certyneo στο npm, με έναν κόμβο δράσης, έναν κόμβο ενεργοποίησης και το αναγνωριστικό του — και εγκαθίσταται από το Settings → Community nodes σε μια αυτό-φιλοξενούμενη παρουσία. Η τεκμηρίωση του n8n διατηρεί το n8n Cloud για τους κόμβους που έχει επαληθεύσει.
Ποια συνδρομή Certyneo χρειάζομαι για να χρησιμοποιήσω το n8n;
Ένα πραγματικό κλειδί (sk_live_…) απαιτεί ένα πακέτο που περιλαμβάνει πρόσβαση API (Standard και άνω). Τα πακέτα Δωρεάν και Προσωπικό διαθέτουν ένα κλειδί sandbox (sk_test_…) για να εκτελέσετε ολόκληρη τη διαδικασία σε φακέλους δοκιμής, χωρίς να αποστέλλονται μηνύματα ηλεκτρονικού ταχυδρομείου στους υπογράφοντες.
Πώς να ξεκινήσω την προσβαση στην API?
Από το Certyneo, μεταβείτε στις Ρυθμίσεις → API REST και δημιουργήστε ένα κλειδί με τις εμβέλειες envelopes:read, envelopes:write και webhooks:write. Ξεκινά με sk_live_ (ή sk_test_ για το sandbox) και εμφανίζεται μόνο μία φορά: αντιγράψτε το αμέσως.
Λειτουργεί αυτό σε μια αυτοφιλοξενούμενη παρουσία n8n;
Ναι, και αυτή είναι η πιο ενδιαφέρουσα περίπτωση χρήσης. Η παρουσία σας πρέπει απλώς να είναι προσβάσιμη από το Διαδίκτυο για να λαμβάνει τα webhooks μας: ένα δημόσιο URL σε HTTPS είναι αρκετό. Κανένα δεδομένο δεν διακινείται τότε μέσω υπηρεσίας τρίτου.
Ποια συμβάντα υπογραφής καλύπτονται;
Οι έντεκα συμβάντα του κύκλου ζωής: φάκελος δημιουργήθηκε, απεστάλη, υπογράφη, απορρίφθηκε, ακυρώθηκε, λήξη ισχύος, επιστράφηκε στον αποστολέα, υποβλήθηκε ξανά, και παραλήπτης που άνοιξε, υπέγραψε ή ενέκρινε. Επιλέγετε αυτά στα οποία εγγράφεστε.
Πώς μπορώ να επαληθεύσω ότι ένα συμβάν προέρχεται πραγματικά από το Certyneo;
Κάθε παράδοση φέρει μια κεφαλίδα X-Certyneo-Signature που περιέχει το HMAC-SHA256 του σώματος της αίτησης, υπολογισμένο με το μυστικό που επιστράφηκε κατά τη δημιουργία της συνδρομής. Συγκρίνετέ το σε έναν κόμβο Κώδικα πριν επεξεργαστείτε το συμβάν.
Είναι η ενσωμάτωση n8n επί πληρωμή;
Το Certyneo δεν χρεώνει επιπλέον χρέωση. Στο n8n, μια αυτοφιλοξενούμενη παρουσία είναι δωρεάν· στο n8n Cloud, κάθε εκτέλεση καταναλώνει το όριο του πακέτου σας.
Πηγαίνετε Πιο Πάνω
Αυτοματίστε τις συνθήκες από σήμερα
Εισάγετε τη ροή εργασίας, επικολλήστε το κλειδί API σας και αφήστε τις υπογραφές σας να ενεργοποιήσουν τα υπόλοιπα.