इलेक्ट्रॉनिक हस्ताक्षर (DocuSign)
अपने खुद के DocuSign अकाउंट (BYO मॉडल) का उपयोग करके कोटेशन्स को इलेक्ट्रॉनिक हस्ताक्षर के लिए भेजें।
Electronic signature इंटीग्रेशन आपके DocuSign अकाउंट का उपयोग करता है (BYO मॉडल: आप अपना खुद का अकाउंट लाते हैं)। Envelopes आपके DocuSign अकाउंट में बनते और बिल होते हैं: हमारी तरफ से कोई लागत, मार्जिन या बिचौलियापन नहीं है। हम सिर्फ फील्ड्स और कोटेशन को हस्ताक्षर के लिए भेजने वाला बटन जोड़ते हैं।
इंटीग्रेशन निष्क्रिय (inert) शुरू होता है: जब तक आप फील्ड्स भरकर सक्रिय नहीं करते, तब तक कुछ नहीं होता। access token CRM में एन्क्रिप्टेड स्टोर किया जाता है और कभी वापस नहीं दिखाया जाता।
पूर्वापेक्षाएं
- एक DocuSign अकाउंट (demo/test या production environment) जिसे envelopes भेजने की अनुमति हो।
- Apps and Keys (Account ID और Base URI) देखने, एक OAuth access token जनरेट करने और DocuSign Connect (Admin → Connect) कॉन्फ़िगर करने के लिए DocuSign dashboard तक एक्सेस।
- Sellio में, Settings → Integrations में क्रेडेंशियल्स सेव करने और इंटीग्रेशन सक्रिय करने के लिए एडमिनिस्ट्रेटर एक्सेस।
आपको क्या भरना है
- Account ID (API Account ID): आपके DocuSign अकाउंट का पहचानकर्ता (identifier), जो DocuSign dashboard में Settings → Apps and Keys के तहत मिलता है।
- Account Base URI: आपके अकाउंट का base address, जो test environment में https://demo.docusign.net होता है, या production में कुछ इस तरह https://na3.docusign.net (subdomain अकाउंट के अनुसार अलग होता है; यह उसी Apps and Keys स्क्रीन पर दिखाई देता है)।
- Access token (OAuth): एक access token जो आप DocuSign में कॉल्स को अधिकृत (authorize) करने के लिए जनरेट करते हैं। यह CRM में एन्क्रिप्टेड स्टोर किया जाता है।
- Connect HMAC key (webhooks प्राप्त करने के लिए ज़रूरी): वह secret key जिसका उपयोग DocuSign हर webhook पर हस्ताक्षर करने के लिए करता है। Admin → Connect के तहत HMAC सक्षम करें और जनरेट की गई key कॉपी करें। इसके बिना, webhooks अस्वीकृत हो जाते हैं (हस्ताक्षर स्टेटस अपने-आप आगे नहीं बढ़ेगा)।
कैसे कॉन्फ़िगर करें
- Settings → Integrations खोलें और "इलेक्ट्रॉनिक हस्ताक्षर (DocuSign)" कार्ड ढूंढें।
- Account ID, Base URI, Access token और Connect HMAC key पेस्ट करें और "क्रेडेंशियल सहेजें" पर क्लिक करें।
- दिखाई देने वाला "वेबहुक URL (DocuSign Connect)" कॉपी करें और, DocuSign Admin → Connect में, उस URL पर पॉइंट करने वाला एक कस्टम configuration बनाएं, envelope events (sent, delivered, completed, declined, voided) को चुनते हुए।
- उसी Connect configuration में, CRM में पेस्ट की गई उसी key का उपयोग करते हुए HMAC को ENABLE करें (Include HMAC signature)। इसके बाद DocuSign हर event पर X-DocuSign-Signature-1 header में हस्ताक्षर करता है और CRM उसे वेरिफाई करता है।
- CRM पर वापस जाएं और "Activate" पर क्लिक करें।
कोटेशन को हस्ताक्षर के लिए कैसे भेजें
- एक अवसर (opportunity) खोलें और Quotes सेक्शन में जाएं।
- मनचाहे वर्जन पर, "हस्ताक्षर" पर क्लिक करें, हस्ताक्षरकर्ता का ईमेल (और वैकल्पिक रूप से नाम) दर्ज करें और कन्फर्म करें।
- CRM कोटेशन डॉक्यूमेंट के साथ DocuSign में एक envelope बनाता है और हस्ताक्षरकर्ता को हस्ताक्षर वाला ईमेल भेजता है।
- जैसे-जैसे हस्ताक्षरकर्ता आगे बढ़ता है, स्टेटस कोटेशन की "हस्ताक्षर" सूची में दिखाई देता है (Sent → Delivered → Signed)।
💡 जब हस्ताक्षर पूरा हो जाता है और अनुरोध किसी कोटेशन से जुड़ा होता है, तो कोटेशन अपने-आप स्वीकृत (accepted) के रूप में चिह्नित हो जाता है। अगर आप DocuSign कॉन्फ़िगर किए बिना भेजने की कोशिश करते हैं, तो CRM आपको साफ़ चेतावनी देता है, और जब तक क्रेडेंशियल्स मौजूद न हों, फीचर निष्क्रिय रहता है।
आज ऑथेंटिकेशन एक access token का उपयोग करता है जिसे आप पेस्ट करते हैं (सबसे आसान रास्ता)। भविष्य में एक सुधार JWT grant (integration key + private key) होगा, जो टोकन को बिना मैनुअल पेस्ट किए अपने-आप रिन्यू करेगा।
कैसे टेस्ट करें
- एक test access token के साथ demo environment (Base URI https://demo.docusign.net) का उपयोग करें।
- किसी कोटेशन पर, "हस्ताक्षर" पर क्लिक करें, हस्ताक्षरकर्ता के रूप में अपना खुद का ईमेल दर्ज करें और कन्फर्म करें।
- जांचें कि आपको DocuSign का ईमेल मिला और कोटेशन की "हस्ताक्षर" सूची "Sent" दिखाती है।
- डॉक्यूमेंट पर हस्ताक्षर करें; पुष्टि करें कि स्टेटस आगे बढ़ता है (Delivered → Signed) और कोटेशन स्वीकृत के रूप में चिह्नित होता है, यह संकेत है कि DocuSign Connect CRM तक पहुंच गया।
समस्या निवारण
- भेजते समय 401: access token एक्सपायर हो गया (DocuSign OAuth tokens अल्पकालिक होते हैं) या गलत है। एक नया token जनरेट करें और दोबारा पेस्ट करें। Account ID और Base URI एक ही अकाउंट के होने चाहिए।
- Account/URL एरर: सही Base URI की पुष्टि करें (test में demo.docusign.net; production में naX.docusign.net, जहां subdomain Apps and Keys में दिखाई देता है) और API Account ID की।
- कोटेशन पर स्टेटस अपडेट नहीं होता: या तो DocuSign Connect नहीं पहुंच रहा है, या HMAC सिग्नेचर मेल नहीं खा रहा। Admin → Connect में, पुष्टि करें कि configuration "वेबहुक URL (DocuSign Connect)" पर पॉइंट करता है, envelope events के साथ और CRM में पेस्ट की गई उसी key का उपयोग करते हुए HMAC सक्षम है।
- Webhook अस्वीकृत (invalid signature / कोई HMAC key नहीं): सुरक्षा के लिए, CRM केवल साइन किए गए webhooks स्वीकार करता है। अगर Connect HMAC key CRM में नहीं भरी है, या DocuSign द्वारा उपयोग की जा रही key से अलग है, तो events अस्वीकृत हो जाते हैं। दोनों तरफ एक ही key मिलाएं और Connect में HMAC फिर से सक्षम करें।
- बटन दिखाई नहीं देता / कुछ नहीं होता: क्रेडेंशियल्स न होने के कारण इंटीग्रेशन निष्क्रिय है, या सक्रिय नहीं किया गया था। फील्ड्स भरें और Activate पर क्लिक करें।
- Connect URL पर 404: इंटीग्रेशन निष्क्रिय कर दिया गया था या URL टोकन बदल गया। दोबारा सक्रिय करें और DocuSign में URL को फिर से कॉन्फ़िगर करें।