Automatizza le tue firme con n8n
n8n è la piattaforma di automazione open source che puoi ospitare da solo. Due percorsi verso Certyneo: importa il nostro workflow pronto all'uso, che utilizza solo i nodi Webhook e HTTP Request forniti con n8n e quindi non richiede alcuna installazione, oppure installa il nodo della comunità n8n-nodes-certyneo se preferisci un nodo Certyneo nel tuo pannello. In entrambi i casi, incolla la tua chiave API e i tuoi eventi di firma pilotano il resto del tuo stack.
Il workflow non richiede alcuna installazione: utilizza solo i nodi forniti con n8n, quindi funziona ovunque, incluso su n8n Cloud. Il nodo della comunità n8n-nodes-certyneo è pubblicato su npm e si installa da Settings → Community nodes su un'istanza auto-ospitata; n8n Cloud, invece, propone solo i nodi che n8n ha verificato.
Perché collegare Certyneo a n8n
n8n ti lascia la scelta: il servizio gestito, oppure il tuo server. In entrambi i casi, l'integrazione Certyneo utilizza l'API pubblica e i webhook, senza intermediari proprietari tra i tuoi contratti e i tuoi strumenti.
Gli 11 eventi, non quattro
Il nodo Webhook riceve l'intero ciclo di vita delle buste — creazione, invio, apertura, firma, rifiuto, annullamento, scadenza, restituzione al mittente. Nessun trigger viene trascurato, a differenza dei connettori con elenco fisso.
Tutta l'API, senza aspettare
Il nodo HTTP Request chiama qualsiasi endpoint dell'API Certyneo non appena esiste: creare una busta, inviarla, depositare un documento, recuperare il PDF firmato o il fascicolo di prova.
Auto-hosting possibile
Su un'istanza n8n che ospiti tu, i metadati dei tuoi contratti non passano per nessuna terza parte: il traffico va dal tuo server a Certyneo, e da nessun'altra parte. Un argomento pesante per i team legali e i responsabili IT.
Chiave API e firma HMAC
La connessione si autentica con una chiave API a portata limitata, revocabile in qualsiasi momento. Ogni evento in arrivo è firmato in HMAC-SHA256: il tuo workflow può verificare che provenga davvero da Certyneo.
Eventi disponibili
Iscriviti al nodo Webhook agli eventi di tua scelta. Arrivano in tempo reale, con l'intestazione di firma X-Certyneo-Signature da verificare lato n8n.
| Evento | Si attiva quando… |
|---|---|
Busta creataenvelope.created | Una busta è appena stata creata, ancora nello stato di bozza. |
Busta inviataenvelope.sent | Una busta esce dalla bozza e si avvia verso i suoi destinatari. |
Busta firmataenvelope.completed | Tutti i destinatari hanno firmato: la busta è finalizzata, con un link per scaricare il PDF firmato. |
Busta rifiutataenvelope.declined | Un destinatario rifiuta di firmare, con il motivo che ha indicato. |
Busta annullataenvelope.voided | Il mittente annulla una busta già inviata: i link di firma diventano inutilizzabili. |
Busta scadutaenvelope.expired | La data limite è passata senza che tutti i destinatari abbiano firmato. |
Busta restituita al mittenteenvelope.returned_to_sender | Un destinatario restituisce la busta per correzione invece di firmarla. |
Busta riinviataenvelope.resubmitted | Il mittente corregge e quindi rinvia una busta che gli era stata restituita. |
Destinatario ha firmatorecipient.signed | Un destinatario completa la sua firma. Si attiva una volta per firmatario, non solo alla fine. |
Destinatario ha apertorecipient.viewed | Un destinatario apre la busta per la prima volta — utile per fare un sollecito al momento giusto. |
Destinatario ha approvatorecipient.approved | Un destinatario il cui ruolo è "approvatore" convalida la busta senza apporvvi una firma. |
Indirizzo irraggiungibilerecipient.bounced | L'indirizzo di un destinatario restituisce un errore permanente (casella inesistente, dominio inattivo). I tentativi si arrestano: correggere l'indirizzo e rinviare la busta. |
Ciò che puoi controllare
Ogni riga è una chiamata del nodo HTTP Request, con l'autenticazione Header Auth e la tua chiave Certyneo.
Crea una busta
POST /envelopes — compone una busta da un modello Certyneo o da documenti già depositati, con i suoi destinatari.
Inviare la busta
POST /envelopes/:id/send — estrae la busta dalla bozza e invia gli inviti a firmare.
Elenca le buste
GET /envelopes — elenco paginato, i più recenti per primi, con un filtro di stato opzionale.
Depositare un documento
POST /documents — invia un PDF da qualsiasi nodo n8n, incluso un allegato di email o un file Drive.
Elencare i modelli
GET /templates — recupera gli identificativi dei tuoi modelli per non doverli codificare nel workflow.
Scarica il PDF firmato
GET /envelopes/:id/signed-document — recupera il documento firmato, e /audit-trail per il fascicolo di prova.
Configurare l'integrazione
Il workflow che forniamo contiene già il webhook, l'instradamento per evento, la chiamata di sottoscrizione e un esempio di invio. Contiamo cinque minuti.
- 1
Importa il workflow
In n8n, apri il menu del workflow, poi « Import from URL… » e incolla l'indirizzo del nostro modello. Puoi anche scaricare il file e rilasciarlo sulla tela.
- 2
Generare la tua chiave API
Apri Certyneo → Impostazioni → API REST e crea una chiave con gli ambiti buste e webhook. Copiali: viene visualizzata una sola volta.
- 3
Crea l'identificativo Header Auth
In n8n, aggiungi un identificativo « Header Auth »: nome « Authorization », valore « Bearer » seguito dalla tua chiave. Selezionalo sui nodi HTTP Request del workflow.
- 4
Sottoscrivi e attiva
Copia l'URL di produzione del nodo Webhook, incollala nella chiamata di sottoscrizione, eseguila una volta, quindi attiva il workflow. Conserva il « secret » restituito: serve a verificare la firma degli eventi.
- 5
Collegare Google Drive
Il modello deposita il PDF firmato e la sua prova di audit nel vostro Drive: selezionate il vostro account Google su entrambi i nodi di archiviazione. Potete sostituirli con S3, SharePoint o qualsiasi altro storage, consumano lo stesso campo binario.
Sicurezza e conformità
L'integrazione n8n si basa sull'API pubblica Certyneo, con lo stesso livello di rigore del resto della piattaforma.
- Scambi crittografati end-to-end in HTTPS.
- Chiavi API con ambito limitato: concedi solo i diritti necessari.
- Ogni evento è firmato in HMAC-SHA256 — verificalo prima di agire su di esso.
- Revoca di una chiave in qualsiasi momento dal tuo dashboard.
Domande frequenti
È necessario installare un nodo Certyneo in n8n?
Non è obbligatorio. Il workflow che pubblichiamo utilizza solo i nodi Webhook e HTTP Request forniti con n8n: niente da installare, e funziona altrettanto bene su n8n Cloud. Esiste un nodo della comunità se lo preferisci — n8n-nodes-certyneo su npm, con un nodo d'azione, un nodo trigger e il suo identificatore — e si installa da Settings → Community nodes su un'istanza auto-ospitata. La documentazione n8n riserva n8n Cloud ai nodi che ha verificato.
Quale abbonamento Certyneo serve per usare n8n?
Una chiave reale (sk_live_…) richiede un piano che includa l'accesso API (Standard e superiori). I piani Gratuito e Personale hanno una chiave sandbox (sk_test_…) per completare l'intero percorso su buste di prova, senza email inviata ai firmatari.
Come ottengo la mia chiave API?
Da Certyneo, vai in Impostazioni → API REST e crea una chiave con gli scope envelopes:read, envelopes:write e webhooks:write. Inizia con sk_live_ (o sk_test_ per la sandbox) e viene visualizzata una sola volta: copiarla immediatamente.
Funziona su un'istanza n8n auto-ospitata?
Sì, ed è il caso d'uso più interessante. La tua istanza deve semplicemente essere raggiungibile da Internet per ricevere i nostri webhook: un URL pubblico HTTPS è sufficiente. Nessun dato transita quindi attraverso un servizio di terze parti.
Quali eventi di firma sono coperti?
Gli undici eventi del ciclo di vita: busta creata, inviata, firmata, rifiutata, annullata, scaduta, restituita al mittente, riinoltrata, e destinatario che ha aperto, firmato o approvato. Scegli quelli a cui ti abboni.
Come verificare che un evento provenga davvero da Certyneo?
Ogni consegna contiene un'intestazione X-Certyneo-Signature che contiene l'HMAC-SHA256 del corpo della richiesta, calcolato con il segreto restituito al momento della creazione dell'abbonamento. Confrontalo in un nodo Code prima di elaborare l'evento.
L'integrazione n8n è a pagamento?
Certyneo non applica costi aggiuntivi. Dal lato n8n, un'istanza auto-ospitata è gratuita; su n8n Cloud, ogni esecuzione consuma la quota del tuo piano.
Approfondisci
Automatizza i tuoi contratti da oggi
Importa il workflow, incolla la tua chiave API e lascia che le tue firme attivino il resto.