यह गाइड यह मानकर बनाई गई है कि आपने पहले ही कनेक्टर इंस्टॉल कर लिया है। यदि नहीं, तो पहले इंस्टॉलेशन गाइड देखें।
कॉन्फ़िगरेशन स्क्रीन खोलना
Gateway of Tally से, SurveyAnalytica Connector चुनें। कॉन्फ़िगरेशन स्क्रीन में दो सेक्शन हैं: ऊपर Global Settings और नीचे एक Transaction Types टेबल।
चरण 1 — अपना एनवायरनमेंट चुनें
स्क्रीन के ऊपर, Environment ड्रॉपडाउन का उपयोग करके चुनें:
- Test — डेटा SurveyAnalytica के स्टेजिंग एनवायरनमेंट में भेजता है। सेटअप और टेस्टिंग के दौरान इसका उपयोग करें।
- Production — डेटा आपके लाइव SurveyAnalytica खाते में भेजता है। टेस्टिंग पूरी होने के बाद इस पर स्विच करें।
चरण 2 — SurveyAnalytica से अपना Webhook URL और API Key प्राप्त करें
- SurveyAnalytica में, वह वर्कफ़्लो खोलें जिसे Tally डेटा प्राप्त करना है।
- Trigger स्टेप पर क्लिक करें और सुनिश्चित करें कि ट्रिगर टाइप Webhook पर सेट है।
- KEY वैल्यू नोट करें — यह कनेक्टर के लिए आपकी API Key है।
- Workflow ID नोट करें — यह वह यूनीक पहचानकर्ता है जो वेबहुक URL में
/webhook/ के बाद दिखाया जाता है।
चरण 3 — ट्रांज़ैक्शन टाइप कॉन्फ़िगर करें
Transaction Types टेबल में आपकी Tally कंपनी में उपलब्ध सभी वाउचर टाइप और मास्टर रिकॉर्ड सूचीबद्ध हैं, जिनमें अन्य TDL मॉड्यूल द्वारा जोड़े गए कोई भी कस्टम टाइप शामिल हैं।
जिस भी ट्रांज़ैक्शन टाइप को आप सिंक करना चाहते हैं, उसके लिए:
- Enable को Yes पर सेट करें।
- SurveyAnalytica से Workflow ID दर्ज करें (आपके वेबहुक URL में
/webhook/ के बाद वाला हिस्सा)।
- API Key दर्ज करें (ट्रिगर ड्रॉअर से मिली KEY वैल्यू)।
- एक Auth Type चुनें:
- API Key — अधिकतर वर्कफ़्लो के लिए मानक विकल्प।
- Basic Auth — API Key फ़ील्ड में यूज़रनेम और पासवर्ड को कोलन से अलग करके उपयोग करें।
- OAuth 2.0 — अपने OAuth क्लाइंट क्रेडेंशियल दर्ज करें; कनेक्टर टोकन को अपने आप प्राप्त और रिफ्रेश करता है।
- HMAC-SHA256 — बेहतर सुरक्षा के लिए एक रिक्वेस्ट सिग्नेचर जनरेट करता है।
- एक Trigger Mode चुनें:
- Realtime — इस टाइप का वाउचर सेव होते ही तुरंत डेटा भेजता है।
- Batch — वाउचर्स को एकत्र करता है और उन्हें एक तय अंतराल (5, 15, 30, या 60 मिनट) पर एक साथ भेजता है। उच्च-वॉल्यूम ट्रांज़ैक्शन टाइप के लिए नेटवर्क ट्रैफ़िक कम करने हेतु इसका उपयोग करें।
- Scheduled — आपके निर्दिष्ट समय पर प्रतिदिन, साप्ताहिक, या मासिक एक पूर्ण सिंक चलाता है। दिन के अंत की रिपोर्ट्स के लिए उपयुक्त।
- One-time — तदर्थ (ad-hoc) एक्सपोर्ट के लिए कनेक्टर मेन्यू में मैन्युअल Sync Now बटन का उपयोग करें।
आप प्रत्येक ट्रांज़ैक्शन टाइप के लिए अलग-अलग Workflow ID, Auth Type, और Trigger Mode स्वतंत्र रूप से कॉन्फ़िगर कर सकते हैं।
चरण 4 — कॉन्फ़िगरेशन सेव करें
Ctrl+A दबाएँ या Save Config पर क्लिक करें। आपकी सेटिंग्स Tally के भीतर सेव हो जाती हैं और रीस्टार्ट के बाद भी बनी रहती हैं।
चरण 5 — कनेक्शन का परीक्षण करें
- Gateway of Tally → SurveyAnalytica Connector मेन्यू से, Test Connection चुनें।
- कनेक्टर प्रत्येक सक्षम वर्कफ़्लो को एक टेस्ट पिंग भेजता है और प्रत्येक ट्रांज़ैक्शन टाइप के लिए सफलता या विफलता का संदेश दिखाता है।
- SurveyAnalytica में, वर्कफ़्लो ट्रिगर पर जाएँ और यह पुष्टि करने के लिए Check Status पर क्लिक करें कि टेस्ट पेलोड प्राप्त हो गया था।
एक टेस्ट वाउचर भेजना
Tally में सक्षम टाइप का कोई भी वाउचर सेव करें (उदाहरण के लिए, एक टेस्ट Sales Voucher बनाएं)। यदि ट्रिगर मोड Realtime है, तो डेटा कुछ ही सेकंड में आपके SurveyAnalytica वर्कफ़्लो में दिखाई देता है। आप इसे ट्रिगर ड्रॉअर में वर्कफ़्लो के Check Status पैनल में देख सकते हैं।
समस्या निवारण
डेटा SurveyAnalytica में नहीं पहुँच रहा है
- जांचें कि वर्कफ़्लो SurveyAnalytica में Active स्थिति में है।
- पुष्टि करें कि Workflow ID और API Key सही ढंग से दर्ज की गई हैं — टाइप करने के बजाय उन्हें कॉपी-पेस्ट करें।
- पुष्टि करें कि कनेक्टर में सही एनवायरनमेंट (Test बनाम Production) चयनित है।
- यदि Batch मोड का उपयोग कर रहे हैं, तो अंतराल बीतने की प्रतीक्षा करें, या कनेक्शन काम कर रहा है यह पुष्टि करने के लिए अस्थायी रूप से Realtime पर स्विच करें।
SurveyAnalytica Connector मेन्यू Gateway of Tally से गायब है
- पुष्टि करें कि TDL फ़ाइल F12 → TDL & Add-On के तहत सूचीबद्ध और सक्षम है।
- Help → TDL & Add-On के माध्यम से TDL लोड त्रुटियों की जांच करें।
- सुनिश्चित करें कि आपका Tally Prime वर्शन 7.0 या उसके बाद का है।
Test Connection विफलता दिखाता है
- जांचें कि आपके Tally PC में इंटरनेट एक्सेस है और वह
integration.surveyanalytica.com (Production) या Test URL तक पहुँच सकता है।
- यदि आपकी कंपनी प्रॉक्सी या फ़ायरवॉल का उपयोग करती है, तो अपनी IT टीम से उन डोमेन के लिए आउटबाउंड HTTPS ट्रैफ़िक की अनुमति देने के लिए कहें।