Firma elettronica (DocuSign)

Invia i preventivi per la firma elettronica usando il tuo account DocuSign personale (modello BYO).

L'integrazione Firma elettronica usa IL TUO account DocuSign (modello BYO: porti il tuo account personale). Le buste vengono create e fatturate nel tuo account DocuSign: non c'è costo, margine o intermediazione da parte nostra. Ci limitiamo a collegare i campi e il pulsante per inviare il preventivo alla firma.

L'integrazione parte inerte: nulla accade finché non compili i campi e attivi. Il token di accesso è memorizzato cifrato nel CRM e non viene mai mostrato di nuovo.

Prerequisiti

• Un account DocuSign (ambiente demo/test o produzione) con permesso di inviare buste.
• Accesso alla dashboard DocuSign per visualizzare Apps and Keys (Account ID e Base URI), generare un token di accesso OAuth e configurare DocuSign Connect (Admin → Connect).
• In Sellio, accesso come amministratore per salvare le credenziali e attivare l'integrazione in Impostazioni → Integrazioni.

Cosa devi compilare

• Account ID (API Account ID): l'identificatore del tuo account DocuSign, che trovi sotto Settings → Apps and Keys nella dashboard DocuSign.
• Account Base URI: l'indirizzo base del tuo account, che è https://demo.docusign.net nell'ambiente di test, oppure qualcosa come https://na3.docusign.net in produzione (il sottodominio varia in base all'account; appare nella stessa schermata Apps and Keys).
• Token di accesso (OAuth): un token di accesso che generi in DocuSign per autorizzare le chiamate. Viene memorizzato cifrato nel CRM.
• Chiave HMAC di Connect (necessaria per ricevere i webhook): la chiave segreta che DocuSign usa per firmare ogni webhook. Abilita HMAC sotto Admin → Connect e copia la chiave generata. Senza di essa, i webhook vengono rifiutati (lo stato della firma non avanzerà da solo).

Come configurare

1. Apri Impostazioni → Integrazioni e trova il riquadro "Firma elettronica (DocuSign)".
2. Incolla l'Account ID, il Base URI, il Token di accesso e la Chiave HMAC di Connect e clicca "Salva credenziali".
3. Copia l'"URL webhook (DocuSign Connect)" che appare e, in DocuSign Admin → Connect, crea una configurazione personalizzata puntando a quell'URL, selezionando gli eventi della busta (inviata, consegnata, completata, rifiutata, annullata).
4. Nella stessa configurazione Connect, ABILITA HMAC (Include HMAC signature) usando la stessa chiave che hai incollato nel CRM. DocuSign firma quindi ogni evento nell'header X-DocuSign-Signature-1 e il CRM lo verifica.
5. Torna al CRM e clicca "Attiva".

Come inviare un preventivo alla firma

1. Apri un'opportunità e vai alla sezione Preventivi.
2. Sulla versione desiderata, clicca "Firma", inserisci l'email del firmatario (e opzionalmente il nome) e conferma.
3. Il CRM crea una busta in DocuSign con il documento del preventivo e invia l'email di firma al firmatario.
4. Man mano che il firmatario procede, lo stato appare nell'elenco "Firme" del preventivo (Inviata → Consegnata → Firmata).

Oggi l'autenticazione usa un token di accesso che incolli (il percorso più semplice). Un'evoluzione futura è il JWT grant (integration key + chiave privata), che rinnova il token automaticamente senza incollarlo manualmente.

Come testare

1. Usa l'ambiente demo (Base URI https://demo.docusign.net) con un token di accesso di test.
2. Su un preventivo, clicca "Firma", inserisci la tua stessa email come firmatario e conferma.
3. Verifica di aver ricevuto l'email DocuSign e che l'elenco "Firme" del preventivo mostri "Inviata".
4. Firma il documento; conferma che lo stato avanzi (Consegnata → Firmata) e che il preventivo venga segnato come accettato, segno che DocuSign Connect ha raggiunto il CRM.

Risoluzione problemi

• 401 all'invio: il token di accesso è scaduto (i token OAuth di DocuSign hanno vita breve) o è sbagliato. Genera un nuovo token e reincollalo. L'Account ID e il Base URI devono provenire dallo STESSO account.
• Errore di account/URL: verifica il Base URI corretto (demo.docusign.net in test; naX.docusign.net in produzione, dove il sottodominio appare in Apps and Keys) e l'API Account ID.
• Lo stato non si aggiorna sul preventivo: DocuSign Connect non sta arrivando OPPURE la firma HMAC non corrisponde. In Admin → Connect, verifica la configurazione che punta all'"URL webhook (DocuSign Connect)", con gli eventi della busta e con HMAC abilitato usando la STESSA chiave incollata nel CRM.
• Webhook rifiutato (firma non valida / nessuna chiave HMAC): per sicurezza, il CRM accetta solo webhook firmati. Se la chiave HMAC di Connect non è compilata nel CRM, o è diversa da quella usata da DocuSign, gli eventi vengono rifiutati. Allinea la stessa chiave su entrambi i lati e riabilita HMAC in Connect.
• Il pulsante non appare / non succede nulla: l'integrazione è inerte per mancanza di credenziali o non è stata attivata. Compila i campi e clicca Attiva.
• 404 sull'URL Connect: l'integrazione è stata disattivata o il token dell'URL è cambiato. Riattiva e riconfigura l'URL in DocuSign.

Open this article inside the system →