Signature électronique (DocuSign)
Envoyez des devis pour signature électronique en utilisant votre propre compte DocuSign (modèle BYO).
L'intégration Signature électronique utilise VOTRE compte DocuSign (modèle BYO : vous apportez votre propre compte). Les enveloppes sont créées et facturées sur votre compte DocuSign : il n'y a aucun coût, marge ou intermédiation de notre part. Nous nous contentons de connecter les champs et le bouton pour envoyer le devis en signature.
L'intégration démarre inerte : rien ne se passe tant que vous n'avez pas rempli les champs et activé. Le jeton d'accès est stocké chiffré dans le CRM et n'est jamais réaffiché.
Prérequis
- Un compte DocuSign (environnement démo/test ou production) avec la permission d'envoyer des enveloppes.
- Un accès au tableau de bord DocuSign pour consulter Apps and Keys (Account ID et Base URI), générer un jeton d'accès OAuth et configurer DocuSign Connect (Admin → Connect).
- Dans Sellio, un accès administrateur pour enregistrer les identifiants et activer l'intégration dans Paramètres → Intégrations.
Ce que vous devez renseigner
- Account ID (API Account ID) : l'identifiant de votre compte DocuSign, disponible sous Settings → Apps and Keys dans le tableau de bord DocuSign.
- Account Base URI : l'adresse de base de votre compte, qui est https://demo.docusign.net dans l'environnement de test, ou quelque chose comme https://na3.docusign.net en production (le sous-domaine varie selon le compte ; il apparaît sur le même écran Apps and Keys).
- Jeton d'accès (OAuth) : un jeton d'accès que vous générez dans DocuSign pour autoriser les appels. Il est stocké chiffré dans le CRM.
- Clé HMAC Connect (requise pour recevoir les webhooks) : la clé secrète que DocuSign utilise pour signer chaque webhook. Activez HMAC sous Admin → Connect et copiez la clé générée. Sans elle, les webhooks sont rejetés (le statut de signature n'avancera pas tout seul).
Comment configurer
- Ouvrez Paramètres → Intégrations et trouvez la carte « Signature électronique (DocuSign) ».
- Collez l'Account ID, le Base URI, le jeton d'accès et la clé HMAC Connect, puis cliquez sur « Enregistrer les identifiants ».
- Copiez « l'URL du webhook (DocuSign Connect) » qui apparaît et, dans DocuSign Admin → Connect, créez une configuration personnalisée pointant vers cette URL, en cochant les événements d'enveloppe (envoyé, livré, complété, refusé, annulé).
- Dans la même configuration Connect, ACTIVEZ HMAC (Include HMAC signature) en utilisant la même clé que vous avez collée dans le CRM. DocuSign signe alors chaque événement dans l'en-tête X-DocuSign-Signature-1 et le CRM le vérifie.
- Revenez dans le CRM et cliquez sur « Activer ».
Comment envoyer un devis en signature
- Ouvrez une opportunité et allez dans la section Devis.
- Sur la version souhaitée, cliquez sur « Signature », saisissez l'e-mail du signataire (et éventuellement son nom) et confirmez.
- Le CRM crée une enveloppe dans DocuSign avec le document du devis et envoie l'e-mail de signature au signataire.
- À mesure que le signataire progresse, le statut apparaît dans la liste « Signatures » du devis (Envoyé → Livré → Signé).
💡 Lorsque la signature est terminée et que la demande est liée à un devis, le devis est marqué comme accepté automatiquement. Si vous essayez d'envoyer sans avoir configuré DocuSign, le CRM vous avertit clairement, et la fonctionnalité reste inerte tant que les identifiants ne sont pas en place.
Aujourd'hui, l'authentification utilise un jeton d'accès que vous collez (le chemin le plus simple). Une évolution future est le JWT grant (integration key + clé privée), qui renouvelle le jeton automatiquement sans collage manuel.
Comment tester
- Utilisez l'environnement démo (Base URI https://demo.docusign.net) avec un jeton d'accès de test.
- Sur un devis, cliquez sur « Signature », saisissez votre propre e-mail comme signataire et confirmez.
- Vérifiez que vous avez reçu l'e-mail DocuSign et que la liste « Signatures » du devis affiche « Envoyé ».
- Signez le document ; vérifiez que le statut avance (Livré → Signé) et que le devis est marqué comme accepté, signe que DocuSign Connect a atteint le CRM.
Dépannage
- 401 lors de l'envoi : le jeton d'accès a expiré (les jetons OAuth de DocuSign ont une durée de vie courte) ou est incorrect. Générez un nouveau jeton et recollez-le. L'Account ID et le Base URI doivent provenir du MÊME compte.
- Erreur de compte/URL : vérifiez le bon Base URI (demo.docusign.net en test ; naX.docusign.net en production, où le sous-domaine apparaît dans Apps and Keys) et l'API Account ID.
- Le statut ne se met pas à jour sur le devis : DocuSign Connect n'arrive pas OU la signature HMAC ne correspond pas. Dans Admin → Connect, vérifiez que la configuration pointe vers « l'URL du webhook (DocuSign Connect) », avec les événements d'enveloppe et avec HMAC activé en utilisant la MÊME clé collée dans le CRM.
- Webhook rejeté (signature invalide / pas de clé HMAC) : par sécurité, le CRM n'accepte que les webhooks signés. Si la clé HMAC Connect n'est pas renseignée dans le CRM, ou diffère de celle utilisée par DocuSign, les événements sont rejetés. Alignez la même clé des deux côtés et réactivez HMAC dans Connect.
- Le bouton n'apparaît pas / rien ne se passe : l'intégration est inerte faute d'identifiants ou n'a pas été activée. Renseignez les champs et cliquez sur Activer.
- 404 sur l'URL Connect : l'intégration a été désactivée ou le token de l'URL a changé. Réactivez et reconfigurez l'URL dans DocuSign.