Signature électronique (Clicksign)
Envoyez des devis pour signature électronique en utilisant votre propre compte Clicksign (modèle BYO).
L'intégration Signature électronique avec Clicksign utilise VOTRE compte Clicksign (modèle BYO : vous apportez votre propre compte). Les documents sont créés et facturés dans votre compte Clicksign : il n'y a aucun coût, marge ou intermédiation de notre côté. Nous nous contentons de relier 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é la fonctionnalité. Le jeton d'accès et le secret du webhook sont stockés chiffrés dans le CRM et ne sont jamais réaffichés.
Prérequis
- Un compte Clicksign (Sandbox pour les tests ou Production) avec autorisation API.
- Un accès au tableau de bord Clicksign pour générer le jeton d'accès (Paramètres → API) et créer un webhook avec un secret HMAC.
- 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
- Environnement : Sandbox (pour les tests, sur sandbox.clicksign.com) ou Production (en réel, sur app.clicksign.com). Chaque environnement possède son propre jeton d'accès.
- Jeton d'accès : le jeton d'accès API, généré dans le tableau de bord Clicksign sous Paramètres → API. Il authentifie les appels (via ?access_token=). Il est stocké chiffré dans le CRM.
- Secret du webhook (HMAC) : un secret que vous définissez lors de la création du webhook dans Clicksign. Il sert à vérifier la signature HMAC-SHA256 des événements que Clicksign nous envoie. Il est stocké chiffré dans le CRM.
Comment configurer
- Ouvrez Paramètres → Intégrations et repérez la carte « Signature électronique (Clicksign) ».
- Choisissez l'environnement, collez le jeton d'accès et le secret du webhook, puis cliquez sur « Enregistrer les identifiants ».
- Copiez l'« URL du webhook (Clicksign) » qui apparaît et, dans Clicksign → Paramètres → API/Webhooks, créez un webhook pointant vers cette URL en utilisant exactement le même secret.
- Retournez 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 facultativement son nom).
- Si vous avez DocuSign et Clicksign actifs en même temps, deux boutons apparaissent (« Envoyer via DocuSign » et « Envoyer via Clicksign »), choisissez alors Clicksign. Si seul Clicksign est actif, un seul bouton l'utilise déjà.
- Le CRM crée le document dans Clicksign, ajoute le signataire et demande la signature ; Clicksign envoie l'e-mail de signature au signataire.
- Au fur et à mesure que le signataire avance, le statut apparaît dans la liste « Signatures » du devis (Envoyé → Livré → Signé).
💡 Lorsque le document est entièrement signé (événement de clôture de Clicksign) et que la demande est liée à un devis, le devis est marqué comme accepté automatiquement. Les webhooks sont vérifiés par signature HMAC-SHA256 (en-tête Content-Hmac) : si le secret ne correspond pas, l'événement est rejeté. Si vous essayez d'envoyer sans avoir configuré Clicksign, le CRM vous avertit clairement, et la fonctionnalité reste inerte tant que les identifiants ne sont pas en place.
Comment tester
- Utilisez l'environnement Sandbox avec le jeton d'accès sandbox.
- Sur un devis, cliquez sur « Signature », saisissez votre propre e-mail comme signataire et confirmez.
- Confirmez que vous avez bien reçu l'e-mail Clicksign et que la liste « Signatures » indique « Envoyé ».
- Signez le document et vérifiez que le statut passe à « Signé » et que le devis est marqué comme accepté, signe que le webhook (avec HMAC valide) est bien arrivé.
Dépannage
- 401 lors de l'envoi : le jeton d'accès est incorrect ou provient d'un autre environnement (un jeton sandbox utilisé en production, ou l'inverse). Vérifiez l'environnement et recollez le jeton correspondant.
- Le statut ne se met pas à jour sur le devis : le webhook n'arrive pas ou la signature échoue. Vérifiez que le webhook dans Clicksign pointe vers l'« URL du webhook (Clicksign) » et utilise EXACTEMENT le même secret que celui enregistré dans le CRM (en-tête Content-Hmac, HMAC-SHA256).
- Événement rejeté (signature invalide) : le secret du webhook diffère entre Clicksign et le CRM. Enregistrez la même valeur des deux côtés.
- Rien ne se passe à l'envoi : l'intégration est inerte faute d'identifiants ou n'a pas été activée. Renseignez environnement + jeton + secret puis cliquez sur Activer.