इलेक्ट्रॉनिक हस्ताक्षर (Clicksign)
अपने खुद के Clicksign अकाउंट (BYO मॉडल) का उपयोग करके कोटेशन इलेक्ट्रॉनिक हस्ताक्षर के लिए भेजें।
Clicksign के साथ इलेक्ट्रॉनिक हस्ताक्षर इंटीग्रेशन आपके अपने Clicksign अकाउंट का उपयोग करता है (BYO मॉडल: आप अपना खुद का अकाउंट लाते हैं)। दस्तावेज़ आपके Clicksign अकाउंट में बनाए और बिल किए जाते हैं: हमारी तरफ से कोई लागत, मार्जिन या बिचौलियापन नहीं है। हम केवल फ़ील्ड और कोटेशन को हस्ताक्षर के लिए भेजने वाला बटन जोड़ते हैं।
इंटीग्रेशन निष्क्रिय शुरू होता है: जब तक आप फ़ील्ड नहीं भरते और सक्रिय नहीं करते, कुछ नहीं होता। access token और webhook secret CRM में एन्क्रिप्टेड रूप से संग्रहीत होते हैं और कभी वापस दिखाए नहीं जाते।
पूर्वापेक्षाएँ
- API अनुमति वाला एक Clicksign अकाउंट (परीक्षण के लिए Sandbox या Production)।
- access token जनरेट करने के लिए Clicksign डैशबोर्ड तक पहुँच (Settings → API) और HMAC secret के साथ एक webhook बनाना।
- Sellio में, क्रेडेंशियल सहेजने और Settings → Integrations में इंटीग्रेशन सक्रिय करने के लिए एडमिनिस्ट्रेटर एक्सेस।
आपको क्या भरना होगा
- Environment: Sandbox (परीक्षण के लिए, sandbox.clicksign.com पर) या Production (वास्तविक उपयोग के लिए, app.clicksign.com पर)। प्रत्येक environment का अपना access token होता है।
- Access token: Clicksign डैशबोर्ड में Settings → API के तहत जनरेट किया गया API access token। यह कॉल्स को प्रमाणित करता है (?access_token= के माध्यम से)। यह CRM में एन्क्रिप्टेड रूप से संग्रहीत होता है।
- Webhook secret (HMAC): एक secret जो आप Clicksign में webhook बनाते समय परिभाषित करते हैं। यह Clicksign द्वारा हमें भेजे गए events के HMAC-SHA256 हस्ताक्षर को सत्यापित करने के लिए उपयोग होता है। यह CRM में एन्क्रिप्टेड रूप से संग्रहीत होता है।
कैसे कॉन्फ़िगर करें
- Settings → Integrations खोलें और "इलेक्ट्रॉनिक हस्ताक्षर (Clicksign)" कार्ड ढूँढें।
- Environment चुनें, Access token और Webhook secret पेस्ट करें, और "क्रेडेंशियल सहेजें" पर क्लिक करें।
- दिखाई देने वाला "वेबहुक URL (Clicksign)" कॉपी करें और, Clicksign में → Settings → API/Webhooks में, उस URL को इंगित करते हुए बिल्कुल उसी secret का उपयोग करके एक webhook बनाएँ।
- CRM पर वापस लौटें और "सक्रिय करें" पर क्लिक करें।
हस्ताक्षर के लिए कोटेशन कैसे भेजें
- एक अवसर (opportunity) खोलें और Quotes सेक्शन में जाएँ।
- इच्छित संस्करण पर, "हस्ताक्षर" पर क्लिक करें, हस्ताक्षरकर्ता का ईमेल दर्ज करें (और वैकल्पिक रूप से नाम)।
- यदि आपके पास DocuSign और Clicksign दोनों एक साथ सक्रिय हैं, तो दो बटन दिखाई देते हैं ("DocuSign के माध्यम से भेजें" और "Clicksign के माध्यम से भेजें"), इसलिए Clicksign चुनें। यदि केवल Clicksign सक्रिय है, तो एक ही बटन पहले से उसी का उपयोग करता है।
- CRM Clicksign में दस्तावेज़ बनाता है, हस्ताक्षरकर्ता को जोड़ता है और हस्ताक्षर का अनुरोध करता है; Clicksign हस्ताक्षरकर्ता को हस्ताक्षर ईमेल भेजता है।
- जैसे-जैसे हस्ताक्षरकर्ता आगे बढ़ता है, स्थिति कोटेशन की "हस्ताक्षर" सूची में दिखाई देती है (भेजा गया → वितरित → हस्ताक्षरित)।
💡 जब दस्तावेज़ पूरी तरह से हस्ताक्षरित हो जाता है (Clicksign का क्लोजिंग इवेंट) और अनुरोध किसी कोटेशन से जुड़ा होता है, तो कोटेशन को स्वचालित रूप से स्वीकृत के रूप में चिह्नित किया जाता है। Webhooks को HMAC-SHA256 हस्ताक्षर (Content-Hmac header) द्वारा सत्यापित किया जाता है: यदि secret मेल नहीं खाता, तो event अस्वीकृत कर दिया जाता है। यदि आप Clicksign कॉन्फ़िगर किए बिना भेजने की कोशिश करते हैं, तो CRM आपको स्पष्ट रूप से चेतावनी देता है, और जब तक क्रेडेंशियल मौजूद नहीं होते तब तक फ़ीचर निष्क्रिय रहता है।
कैसे परीक्षण करें
- sandbox access token के साथ Sandbox environment का उपयोग करें।
- किसी कोटेशन पर, "हस्ताक्षर" पर क्लिक करें, हस्ताक्षरकर्ता के रूप में अपना खुद का ईमेल दर्ज करें और पुष्टि करें।
- पुष्टि करें कि आपको Clicksign ईमेल मिला और "हस्ताक्षर" सूची "भेजा गया" दिखाती है।
- दस्तावेज़ पर हस्ताक्षर करें और जाँचें कि स्थिति "हस्ताक्षरित" तक बढ़ती है और कोटेशन स्वीकृत के रूप में चिह्नित होता है, जो यह संकेत है कि webhook (वैध HMAC के साथ) पहुँच गया।
समस्या निवारण
- भेजते समय 401: access token गलत है या किसी अन्य environment का है (production में उपयोग किया गया sandbox token, या इसके विपरीत)। environment की पुष्टि करें और उस environment के लिए token फिर से पेस्ट करें।
- कोटेशन पर स्थिति अपडेट नहीं होती: webhook नहीं पहुँच रहा है या हस्ताक्षर विफल हो रहा है। पुष्टि करें कि Clicksign में webhook "वेबहुक URL (Clicksign)" को इंगित करता है और CRM में सहेजा गया बिल्कुल वही secret उपयोग करता है (Content-Hmac header, HMAC-SHA256)।
- Event अस्वीकृत (अमान्य हस्ताक्षर): Clicksign और CRM के बीच webhook secret अलग है। दोनों तरफ एक ही मान सहेजें।
- भेजते समय कुछ नहीं होता: क्रेडेंशियल की कमी के कारण इंटीग्रेशन निष्क्रिय है या सक्रिय नहीं किया गया था। environment + token + secret भरें और सक्रिय करें पर क्लिक करें।