नए ऑर्डर अपने सिस्टम या ईमेल पर भेजने के लिए वेबहुक कैसे सेट करें?

वेबहुक क्या करता है

वेबहुक आपके स्टोर में होने वाले किसी इवेंट की जानकारी उसी पल किसी दूसरी जगह भेज देता है। आप इवेंट चुनते हैं और यह भी कि वह कहाँ जाए:

• API: Storeep इवेंट का डेटा आपके सर्वर, CRM, Zapier या Make सिनेरियो, या विज्ञापन ट्रैकिंग टूल के किसी वेब पते (URL) पर भेजता है।
• ईमेल: Storeep इवेंट का डेटा किसी ईमेल पते पर भेजता है, जैसे हर नए ऑर्डर के लिए ईमेल पाने के लिए।

सेटिंग्स > वेबहुक खोलें। आपके पास सेटिंग्स की अनुमति होनी चाहिए।

कई टूल के लिए पहले से तैयार ऐप है, जो ज़्यादा आसान है: Google Sheets, कूरियर नेटवर्क और विज्ञापन पिक्सेल। पहले ऐप्स मार्केट देखें।

वेबहुक बनाना

नया वेबहुक जोड़ें पर क्लिक करें, फ़ॉर्म भरें और जोड़ें पर क्लिक करें।

• चालू करें: डिफ़ॉल्ट रूप से टिक होता है। टिक होने पर इवेंट तुरंत भेजे जाते हैं। वेबहुक रखते हुए उसे रोकने के लिए टिक हटा दें।
• नाम: आपकी सूची के लिए एक लेबल, जैसे "CRM new orders"।
• प्रकार: API या ईमेल।
• इवेंट:
  • ऑर्डर बना: कोई ग्राहक नया ऑर्डर देता है।
  • ऑर्डर अपडेट हुआ: किसी ऑर्डर का स्टेटस या जानकारी बदलती है।
  • सेशन बना: कोई नया विज़िटर आपके स्टोर पर आता है। सिर्फ़ API प्रकार के लिए।
• फ़ॉर्मेट: Json।
• URL (API प्रकार): जिस पते पर भेजना है। https:// वाला हिस्सा अपने आप जुड़ जाता है, इसलिए बाकी टाइप करें, जैसे api.example.com/orders।
• ईमेल पता (ईमेल प्रकार): जहाँ ईमेल जाएगा।

ईमेल वेबहुक सिर्फ़ ऑर्डर इवेंट भेजता है। अगर आप ईमेल के साथ सेशन बना चुनते हैं, तो कुछ नहीं भेजा जाता।

URL में ऑर्डर का डेटा डालना

आप इवेंट डेटा का कोई भी फ़ील्ड डबल ब्रेसेस के साथ URL के अंदर रख सकते हैं, {{field_name}}। उदाहरण के लिए:

example.com/postback?cid={{fbclid}}&payout={{order_total}}

यह Facebook क्लिक ID और ऑर्डर का कुल किसी विज्ञापन ट्रैकिंग या एफ़िलिएट प्लेटफ़ॉर्म को भेजता है, बिना किसी अतिरिक्त सर्वर के। जो फ़ील्ड मौजूद नहीं है, वह खाली हो जाता है। फ़ील्ड के नाम देखने के लिए उसी इवेंट के लिए एक ईमेल वेबहुक बनाएँ और मिलने वाला डेटा देखें।

वेबहुक की सूची

हर पंक्ति नाम, URL / ईमेल, प्रकार, इवेंट, फ़ॉर्मेट और स्टेटस (चालू या बंद) दिखाती है। एडिट करने के लिए किसी पंक्ति पर क्लिक करें। हमेशा के लिए हटाने के लिए पंक्तियों पर टिक लगाएँ और वेबहुक हटाएँ चुनें। हर स्टोर के लिए वेबहुक की एक अधिकतम संख्या है, और वहाँ तक पहुँचने पर आपको एक मैसेज दिखता है।

आप एक ही इवेंट के लिए कई वेबहुक बना सकते हैं, जैसे एक अपने CRM के लिए और एक अपने विज्ञापन ट्रैकर के लिए।

जब डिलीवरी असफल हो

• आपके सर्वर को सफलता कोड (2xx) के साथ जल्दी जवाब देना चाहिए। धीमा जवाब असफलता गिना जाता है।
• अगर आपका सर्वर बंद या व्यस्त है (5xx या 429 जवाब, या कोई जवाब नहीं), तो Storeep अगले कुछ मिनटों में कई बार फिर से कोशिश करता है। सिर्फ़ असफल हुए वेबहुक फिर से भेजे जाते हैं, ताकि बाकियों को डुप्लिकेट न मिलें।
• अगर आपका सर्वर रिक्वेस्ट ठुकरा देता है (404 या 403 जैसा 4xx जवाब), तो Storeep फिर से कोशिश नहीं करता, क्योंकि पता या उसकी सुरक्षा गलत है।
• जब कोई वेबहुक लगातार कई बार असफल होता है, तो स्टोर मालिक को एक ईमेल मिलता है: "ज़रूरी कार्रवाई: आपका Storeep वेबहुक फ़ेल हो रहा है", जिसमें वेबहुक का नाम, पता, इवेंट और आखिरी गलती का कोड होता है। वेबहुक के फिर से काम करने के बाद, आगे कोई समस्या होने पर नई चेतावनी आ सकती है। आप यह ईमेल सूचनाएँ में बंद कर सकते हैं।
• ईमेल वेबहुक एक ही बार भेजे जाते हैं, बिना रीट्राई के।

बकाया बैलेंस की वजह से रुके वेबहुक

अगर आपके स्टोर पर बकाया राशि है और आपका वॉलेट उसे पूरा नहीं कर सकता, तो वेबहुक रुके रहते हैं। आपके फ़ंड जोड़ने और राशि चुकने के बाद वे भेजे जाते हैं। देखें वॉलेट और बिलिंग।

टिप्स

• अगर आपके सर्वर को पासवर्ड या key चाहिए, तो उसे URL क्वेरी में डालें, जैसे ?key=yoursecret।
• सेशन बना हर विज़िटर के लिए चलता है, जो व्यस्त स्टोर पर बहुत ज़्यादा हो सकता है। इसे तभी इस्तेमाल करें जब आपका सर्वर इसे संभाल सके।
• किसी टूल को जब चाहे आपके ऑर्डर और प्रोडक्ट्स पढ़ने देने के लिए इसकी जगह एक्सेस टोकन इस्तेमाल करें।