Firma elettronica (Clicksign)
Invia i preventivi per la firma elettronica utilizzando il tuo account Clicksign (modello BYO).
L'integrazione Firma elettronica con Clicksign utilizza IL TUO account Clicksign (modello BYO: porti il tuo account). I documenti vengono creati e fatturati sul tuo account Clicksign: non c'è alcun costo, margine o intermediazione da parte nostra. Noi colleghiamo solo i campi e il pulsante per inviare il preventivo alla firma.
L'integrazione parte inerte: non succede nulla finché non compili i campi e attivi. Il token di accesso e il segreto del webhook sono memorizzati cifrati nel CRM e non vengono mai mostrati di nuovo.
Prerequisiti
- Un account Clicksign (Sandbox per i test o Produzione) con permesso API.
- Accesso al pannello Clicksign per generare il token di accesso (Impostazioni → API) e creare un webhook con un segreto HMAC.
- In Sellio, accesso da amministratore per salvare le credenziali e attivare l'integrazione in Impostazioni → Integrazioni.
Cosa devi compilare
- Ambiente: Sandbox (per i test, su sandbox.clicksign.com) oppure Produzione (per l'uso reale, su app.clicksign.com). Ogni ambiente ha il proprio token di accesso.
- Token di accesso: il token di accesso API, generato nel pannello Clicksign in Impostazioni → API. Autentica le chiamate (tramite ?access_token=). Viene memorizzato cifrato nel CRM.
- Segreto del webhook (HMAC): un segreto che definisci quando crei il webhook in Clicksign. Serve a verificare la firma HMAC-SHA256 degli eventi che Clicksign ci invia. Viene memorizzato cifrato nel CRM.
Come configurare
- Apri Impostazioni → Integrazioni e trova la scheda "Firma elettronica (Clicksign)".
- Scegli l'ambiente, incolla il Token di accesso e il Segreto del webhook, quindi clicca su "Salva credenziali".
- Copia l'"URL webhook (Clicksign)" che appare e, in Clicksign → Impostazioni → API/Webhook, crea un webhook che punti a quell'URL usando esattamente lo stesso segreto.
- Torna al CRM e clicca su "Attiva".
Come inviare un preventivo per la firma
- Apri un'opportunità e vai alla sezione Preventivi.
- Sulla versione desiderata, clicca su "Firma", inserisci l'email del firmatario (e facoltativamente il nome).
- Se hai DocuSign e Clicksign attivi contemporaneamente, appaiono due pulsanti ("Invia con DocuSign" e "Invia con Clicksign"), quindi scegli Clicksign. Se è attivo solo Clicksign, un unico pulsante lo usa già.
- Il CRM crea il documento in Clicksign, aggiunge il firmatario e richiede la firma; Clicksign invia l'email di firma al firmatario.
- Man mano che il firmatario procede, lo stato appare nell'elenco "Firme" del preventivo (Inviato → Consegnato → Firmato).
💡 Quando il documento è completamente firmato (evento di chiusura di Clicksign) e la richiesta è collegata a un preventivo, il preventivo viene contrassegnato automaticamente come accettato. I webhook sono verificati tramite firma HMAC-SHA256 (header Content-Hmac): se il segreto non corrisponde, l'evento viene rifiutato. Se provi a inviare senza aver configurato Clicksign, il CRM ti avvisa chiaramente e la funzione rimane inerte finché le credenziali non sono impostate.
Come testare
- Usa l'ambiente Sandbox con il token di accesso sandbox.
- Su un preventivo, clicca su "Firma", inserisci la tua email come firmatario e conferma.
- Conferma di aver ricevuto l'email di Clicksign e che l'elenco "Firme" mostra "Inviato".
- Firma il documento e verifica che lo stato passi a "Firmato" e che il preventivo venga contrassegnato come accettato, segno che il webhook (con HMAC valido) è arrivato.
Risoluzione dei problemi
- 401 durante l'invio: il token di accesso è sbagliato o appartiene a un altro ambiente (un token sandbox usato in produzione, o viceversa). Conferma l'ambiente e incolla di nuovo il token per quell'ambiente.
- Lo stato non si aggiorna sul preventivo: il webhook non sta arrivando o la firma fallisce. Conferma che il webhook in Clicksign punti all'"URL webhook (Clicksign)" e usi ESATTAMENTE lo stesso segreto salvato nel CRM (header Content-Hmac, HMAC-SHA256).
- Evento rifiutato (firma non valida): il segreto del webhook è diverso tra Clicksign e il CRM. Salva lo stesso valore su entrambi i lati.
- Non succede nulla all'invio: l'integrazione è inerte per mancanza di credenziali o non è stata attivata. Compila ambiente + token + segreto e clicca su Attiva.