SMLLR वेबहुक कैसे सेट अप करें: स्टेप-बाय-स्टेप गाइड
SMLLR में एक वेबहुक एंडपॉइंट सेट अप करने का एक क्लिक-बाय-क्लिक वॉकथ्रू — Settings → Webhooks & Slack से आपकी पहली सफल टेस्ट डिलीवरी तक।
छोटा जवाब
एक वेबहुक सेट अप करने में पांच स्टेप और लगभग दो मिनट लगते हैं: Settings → Webhooks & Slack खोलें, Add Endpoint पर क्लिक करें, वह URL पेस्ट करें जहां आप इवेंट भेजे जाने चाहते हैं, छह इवेंट टाइप में से चुनें कि उस एंडपॉइंट को कौन से मिलने चाहिए, और सेव करें। SMLLR अपने आप प्रति-एंडपॉइंट एक साइनिंग सीक्रेट जेनरेट करता है, और एक Send Test Delivery बटन आपको इस पर भरोसा करने से पहले यह कन्फर्म करने देता है कि एंडपॉइंट असल में पेलोड पा रहा है। यह गाइड एक एंडपॉइंट जोड़ने की मैकेनिक्स कवर करती है — छह इवेंट टाइप में से हर एक का असल में क्या मतलब है इसके लिए, हमारा वेबहुक ओवरव्यू देखें।
शुरू करने से पहले
आपको तीन चीज़ें चाहिए: एक Pro प्लान या ऊपर (₹4,999/महीना) अकाउंट, क्योंकि वेबहुक उस टियर के पीछे गेटेड हैं; एक URL जो एक HTTPS POST रिक्वेस्ट पा सके और एक 2xx रिस्पॉन्स रिटर्न कर सके — आपका अपना बैकएंड, टेस्टिंग के लिए एक रिक्वेस्ट-इंस्पेक्शन टूल, या एक Zapier 'Catch Hook' URL अगर आप इसे अपने खुद के सर्वर के बजाय Zapier में वायर कर रहे हैं; और, अगर आप अपना खुद का रिसीविंग एंडपॉइंट बना रहे हैं, X-Smllr-Signature हेडर वेरीफाई करने की एक योजना ताकि आप बिना साइन्ड रिक्वेस्ट को ऐसे स्वीकार न करें जैसे वे SMLLR से आई हों — सटीक HMAC फॉर्मूला और एक वर्किंग कोड सैंपल के लिए सिग्नेचर वेरिफिकेशन गाइड देखें।
स्टेप-बाय-स्टेप सेटअप
क्रम में पूरा वॉकथ्रू:
- **Settings → Webhooks & Slack खोलें।** यह जेनरिक वेबहुक एंडपॉइंट और Slack एंडपॉइंट दोनों के लिए एक सिंगल स्क्रीन है।
- **Add Endpoint पर क्लिक करें।** एंडपॉइंट टाइप के तौर पर 'Generic' चुनें (Slack का अपना अलग फ्लो है — अगर आपको इसके बजाय वह चाहिए तो [Slack सेटअप गाइड](/support/webhooks/slack-integration) देखें)।
- **डेस्टिनेशन URL पेस्ट करें।** यह आपके अपने सर्वर पर HTTPS एंडपॉइंट है, या Zapier के Catch Hook जैसे एक टूल का URL है जो रॉ JSON पेलोड पाएगा।
- **इवेंट टाइप चुनें।** नए एंडपॉइंट डिफ़ॉल्ट रूप से `qr.scheduled_redirect_fired` और `qr.device_redirect_matched` को छोड़कर हर इवेंट लेते हैं, जो ऑप्ट-इन हैं क्योंकि वे एक बार के बजाय हर मैचिंग स्कैन पर फायर होते हैं। आपको असल में जो चाहिए उससे मेल खाने के लिए चेक या अनचेक करें।
- **सेव करें और एंडपॉइंट सीक्रेट कॉपी करें।** SMLLR इस एंडपॉइंट के लिए एक यूनीक सीक्रेट जेनरेट करता है, क्रिएशन पर एक बार दिखाया गया — इसे वहां स्टोर करें जहां से आपका रिसीविंग सर्वर सीक्रेट पढ़ता है, क्योंकि यह वह की है जो हर डिलीवरी पर `X-Smllr-Signature` हेडर कैलकुलेट करने के लिए इस्तेमाल होती है।
- **एक टेस्ट डिलीवरी भेजें।** नए एंडपॉइंट पर Send Test Delivery पर क्लिक करें। यह सिंक्रोनसली फायर होता है — क्यू में नहीं — इसलिए आपको तुरंत पास/फेल रिज़ल्ट मिलता है और आप SMLLR द्वारा भेजा गया सटीक पेलोड और हेडर देख सकते हैं, प्रोडक्शन में इस पर भरोसा करने से पहले यह कन्फर्म करने के लिए उपयोगी कि आपका सिग्नेचर वेरिफिकेशन लॉजिक असल में एक असली SMLLR रिक्वेस्ट स्वीकार करता है।
डिलीवरी हिस्ट्री पढ़ना
हर एंडपॉइंट एक 90-दिन की डिलीवरी हिस्ट्री रखता है — हर कोशिश, सफल या फेल, आपके सर्वर द्वारा रिटर्न किए गए HTTP स्टेटस के साथ। अगर एक एंडपॉइंट अनरीचेबल है या एक नॉन-2xx स्टेटस रिटर्न करता है, SMLLR अपने आप रीट्राई करता है; एक दिए गए इवेंट के लिए 5 फेल कोशिशों के बाद, वह खास डिलीवरी परमानेंटली फेल्ड मार्क होती है और रीट्राई करना बंद कर देती है, लेकिन एंडपॉइंट खुद भविष्य के इवेंट के लिए एक्टिव रहता है। यह देखने की पहली जगह है अगर आपके पास इवेंट मिसिंग लग रहे हों — फेल्ड डिलीवरी की एक स्ट्रिंग का आमतौर पर मतलब है रिसीविंग सर्वर ने रिक्वेस्ट रिजेक्ट कर दी, टाइमआउट हो गया, या सिग्नेचर चेक एक असल में लेजिटिमेट पेलोड पर फेल हो रहा है।
आम सेटअप गलतियां
एक वेबहुक को टूटा हुआ मानने से पहले चेक करने लायक कुछ चीज़ें:
- **एंडपॉइंट एक 2xx के बजाय एक रीडायरेक्ट रिटर्न करता है।** SMLLR डिलीवरी पर रीडायरेक्ट फॉलो नहीं करता — सुनिश्चित करें कि आपने जो URL पेस्ट किया वह फाइनल डेस्टिनेशन है, कोई ऐसा नहीं जो 301 कहीं और करता है।
- **सिग्नेचर वेरिफिकेशन गलत सीक्रेट इस्तेमाल करता है।** हर एंडपॉइंट का अपना सीक्रेट है, क्रिएशन पर जेनरेट किया गया — अगर आपने इसे पहली बार कॉपी करने के बाद एंडपॉइंट फिर से बनाया है, आपके कोड में पुराना सीक्रेट अब मैच नहीं करेगा।
- **localhost के खिलाफ टेस्टिंग।** एक वेबहुक को एक पब्लिकली रीचेबल HTTPS URL चाहिए; अगर आप एक लोकल डेव सर्वर के खिलाफ टेस्ट कर रहे हैं तो एक टनलिंग टूल (जैसे ngrok) इस्तेमाल करें, और लाइव जाने से पहले असली प्रोडक्शन URL स्वैप करें।
- **10-एंडपॉइंट लिमिट टकराना।** जेनरिक और Slack एंडपॉइंट प्रति अकाउंट 10 का एक पूल शेयर करते हैं — अगर आप लिमिट के करीब हैं तो एक नया प्रोडक्शन एंडपॉइंट जोड़ने से पहले अनइस्तेमाल टेस्ट एंडपॉइंट डिलीट करें।
इसकी कीमत क्या है
एक बार आप Pro प्लान (₹4,999/महीना) या ऊपर पर हों तो वेबहुक सेटअप खुद मुफ्त है — कोई प्रति-एंडपॉइंट चार्ज नहीं, प्रति अकाउंट 10 एंडपॉइंट तक, जेनरिक और Slack मिलाकर। Pro और Premium असल में कैसे अलग हैं इसके लिए Webhooks & Slack Pricing देखें, क्योंकि यह खुद वेबहुक पर नहीं है।
एक SMLLR वेबहुक एंडपॉइंट कैसे सेट अप करें
- 1
Settings → Webhooks & Slack खोलें
अपने SMLLR डैशबोर्ड में लॉगिन करें और Settings → Webhooks & Slack पर जाएं, जेनरिक और Slack दोनों एंडपॉइंट के लिए एक सिंगल स्क्रीन।
- 2
Add Endpoint पर क्लिक करें और Generic चुनें
अगर आप अपने खुद के सर्वर या Zapier जैसे एक टूल को इवेंट भेज रहे हैं तो जेनरिक एंडपॉइंट टाइप चुनें — Slack एंडपॉइंट एक अलग फ्लो इस्तेमाल करते हैं।
- 3
अपना डेस्टिनेशन URL पेस्ट करें
वह HTTPS URL डालें जिसे JSON पेलोड मिलना चाहिए — आपका अपना बैकएंड रूट, या एक ऑटोमेशन टूल से एक Catch Hook URL।
- 4
चुनें कि कौन से इवेंट टाइप पाने हैं
इस एंडपॉइंट को जो इवेंट मिलने चाहिए उनके लिए बॉक्स चेक करें। डिफ़ॉल्ट छह में से चार इवेंट कवर करते हैं; शेड्यूल्ड और डिवाइस रीडायरेक्ट इवेंट ऑप्ट-इन हैं।
- 5
सेव करें और एंडपॉइंट सीक्रेट कॉपी करें
SMLLR एक बार दिखाया गया प्रति-एंडपॉइंट साइनिंग सीक्रेट जेनरेट करता है — इसे सुरक्षित रूप से स्टोर करें, क्योंकि इनकमिंग रिक्वेस्ट पर X-Smllr-Signature हेडर वेरीफाई करने के लिए आपके सर्वर को इसकी ज़रूरत है।
- 6
एक टेस्ट डिलीवरी भेजें
तुरंत एक सिंक्रोनस टेस्ट पेलोड फायर करने के लिए Send Test Delivery पर क्लिक करें, यह कन्फर्म करते हुए कि आपका एंडपॉइंट रिक्वेस्ट स्वीकार करता है और लाइव इस्तेमाल से पहले आपका सिग्नेचर चेक पास होता है।
अक्सर पूछे जाने वाले सवाल
एक वेबहुक सेट अप करने के लिए मुझे कौन सा प्लान चाहिए?
Pro प्लान और ऊपर (₹4,999/महीना) — वही ज़रूरत वेबहुक, Slack, और Zapier को कवर करती है।
मैं डैशबोर्ड में कहां एक वेबहुक जोड़ूं?
Settings → Webhooks & Slack → Add Endpoint।
मुझे कैसे पता चले कि मेरा वेबहुक असल में काम कर रहा है?
एंडपॉइंट पर Send Test Delivery बटन इस्तेमाल करें, जो सिंक्रोनसली फायर होता है और तुरंत पास/फेल रिज़ल्ट दिखाता है, फिर असली इवेंट आने पर एंडपॉइंट की 90-दिन की डिलीवरी हिस्ट्री चेक करें।
अगर मैं कोई इवेंट टाइप न चुनूं तो क्या होता है?
नए एंडपॉइंट डिफ़ॉल्ट रूप से छह में से चार इवेंट टाइप लेते हैं (दो सबसे हाई-वॉल्यूम, ऑप्ट-इन वाले को छोड़कर सब कुछ) — जब तक आपको एक अलग सबसेट न चाहिए, आपको मैन्युअली कुछ भी चुनने की ज़रूरत नहीं है।
क्या मैं एक एंडपॉइंट बनाने के बाद उसके इवेंट टाइप एडिट कर सकता हूं?
हां — Settings → Webhooks & Slack से एंडपॉइंट खोलें और कभी भी चुने गए इवेंट टाइप एडजस्ट करें; पहले से भेजी गई मौजूदा डिलीवरी प्रभावित नहीं होतीं।
क्या मैं कितने वेबहुक एंडपॉइंट जोड़ सकता हूं इसकी कोई लिमिट है?
प्रति अकाउंट 10 तक, जेनरिक वेबहुक एंडपॉइंट और Slack एंडपॉइंट के बीच शेयर्ड।
मुझे यह कहां पता चले कि हर इवेंट टाइप का असल में क्या मतलब है?
सभी छह इवेंट की पूरी व्याख्या असली उदाहरणों के साथ पाने के लिए QR Code Webhooks in Action: 6 Real-Time Automation Use Cases देखें।