एक्शन में QR कोड वेबहुक: 6 रियल-टाइम ऑटोमेशन यूज़ केस
SMLLR का Webhooks फीचर छह अलग QR/स्कैन इवेंट को आपके अपने सर्वर, Slack, या Zapier पर उसी पल पुश करता है जब वे होते हैं। यहां है हर इवेंट किसलिए है, रेस्टोरेंट, रिटेल, और इवेंट्स के लिए असली ऑटोमेशन उदाहरणों के साथ।
छोटा जवाब
Webhooks (Pro प्लान और उससे ऊपर) SMLLR का रियल-टाइम पुश चैनल है: आपके सिस्टम द्वारा यह चेक करने के लिए कि क्या हुआ एक शेड्यूल पर SMLLR के REST API को पोल करने के बजाय, SMLLR उस पल एक साइन्ड JSON पेलोड आपके कंट्रोल की गई एक URL पर भेजता है जब कुछ होता है — एक QR स्कैन होता है, एक QR बनाया या एडिट किया जाता है, या एक डायनामिक रीडायरेक्ट रूल फायर होता है। Settings → Webhooks & Slack के तहत प्रति अकाउंट 10 तक एंडपॉइंट रजिस्टर करें, चुनें कि छह इवेंट टाइप में से हर एक को कौन सा मिलना चाहिए, और बस यही पूरा सेटअप है — लिखने और मेंटेन करने के लिए कोई सर्वर-साइड पोलिंग लूप नहीं।
छह इवेंट, साफ तौर पर समझाए गए
हर इवेंट वही एनवलप शेयर करता है (एक event नाम, एक timestamp, और एक data ऑब्जेक्ट) लेकिन हर एक अलग वजह से फायर होता है:
- **scan.created** — हर एक QR स्कैन पर फायर होता है। वर्कहॉर्स इवेंट, पेलोड में डिवाइस, ब्राउज़र, और मोटी लोकेशन के साथ।
- **qr.created** — जिस पल एक नया QR कोड डैशबोर्ड से सेव होता है फायर होता है।
- **qr.updated** — जब भी एक मौजूदा QR कोड की डेस्टिनेशन या सेटिंग बदलती है फायर होता है।
- **qr.scan_limit_reached** — ठीक एक बार फायर होता है, उस खास स्कैन पर जहां एक स्कैन-लिमिट रीडायरेक्ट रूल (Basic+) अपनी लिमिट URL से अपनी फॉलबैक URL में क्रॉस करता है — इसके बाद हर स्कैन पर नहीं।
- **qr.scheduled_redirect_fired** — हर उस स्कैन पर फायर होता है जो एक शेड्यूल्ड/टाइम-विंडो रीडायरेक्ट रूल (Pro+) से मैच करता है।
- **qr.device_redirect_matched** — हर उस स्कैन पर फायर होता है जो एक डिवाइस-आधारित रीडायरेक्ट रूल (Basic+/Pro+) से मैच करता है, और बताता है कि कौन सा बकेट मैच हुआ: iOS, Android, या डेस्कटॉप।
यह असल में कहां इस्तेमाल होता है
कुछ ठोस पैटर्न, सब ऊपर दिए इवेंट और कुछ नहीं से बनाने योग्य:
- **रीस्टॉक अलर्ट।** एक पैकेजिंग QR कोड में एक स्कैन-लिमिट रीडायरेक्ट है: पहले 100 स्कैन को लॉन्च-डे डिस्काउंट मिलता है, इसके बाद हर किसी को रेगुलर प्रोडक्ट पेज पर भेजा जाता है। `qr.scan_limit_reached` पर एक एंडपॉइंट सब्सक्राइब करें और ऑप्स टीम को ठीक उसी पल पिंग किया जाता है जब प्रोमो खत्म होता है, समय-समय पर डैशबोर्ड चेक करने के बजाय।
- **लॉन्च-डे मॉनिटरिंग।** एक नया कैंपेन QR एक बिलबोर्ड या एक मेलर में लाइव जाता है। उस अकाउंट के लिए `scan.created` पर सब्सक्राइब्ड एक एंडपॉइंट का मतलब है मार्केटिंग टीम पहला स्कैन रियल टाइम में लैंड होते देखती है — यह पुष्टि कि प्लेसमेंट काम कर रहा है, एनालिटिक्स रीफ्रेश किए बिना।
- **ऐप-इंस्टॉल फनल।** एक डिवाइस रीडायरेक्ट रूल वाला एक QR कोड iOS स्कैनर को App Store और Android स्कैनर को Google Play भेजता है। `qr.device_redirect_matched` एक ग्रोथ टीम को iOS-बनाम-Android स्कैन वॉल्यूम को अपने खुद के अट्रिब्यूशन टूलिंग में जैसे-जैसे यह होता है पाइप करने देता है, बाद में एक्सपोर्ट की गई रिपोर्ट से इसे मिलाने के बजाय।
- **चेंज ऑडिटिंग।** कई क्लाइंट की ओर से QR कोड मैनेज करने वाली एक एजेंसी `qr.updated` पर एक एंडपॉइंट सब्सक्राइब करती है ताकि एक क्लाइंट की QR डेस्टिनेशन में कोई भी बदलाव एजेंसी के अपने इंटरनल लॉग में दिखे — जब कई टीम मेंबर उसी अकाउंट को एडिट कर सकते हों तो जवाबदेही के लिए उपयोगी।
- **टाइम-विंडो कैंपेन।** एक रेस्टोरेंट का QR मेन्यू सुबह 11 बजे से पहले एक ब्रेकफास्ट मेन्यू और शाम 5 बजे के बाद एक डिनर मेन्यू पर एक शेड्यूल्ड रीडायरेक्ट रूल इस्तेमाल करते हुए रीडायरेक्ट करता है। `qr.scheduled_redirect_fired` पुष्टि करता है कि स्विच असल में सही समय पर हुआ, जो सुनने से ज़्यादा मायने रखता है पहली बार जब एक टाइमज़ोन मिसकॉन्फ़िगरेशन चुपचाप एक कैंपेन तोड़ देता है।
एक इवेंट पाने के तीन तरीके
इवेंट खुद डेस्टिनेशन के बावजूद एक जैसा है — सिर्फ डिलीवरी फॉर्मेट बदलता है। एक जेनेरिक एंडपॉइंट को HTTPS पर रॉ JSON पेलोड मिलता है एक X-Smllr-Signature हेडर (HMAC-SHA256) के साथ यह वेरीफाई करने के लिए कि यह असल में SMLLR से आया है — आपके अपने बैकएंड, एक डेटा वेयरहाउस, या एक कस्टम इंटीग्रेशन को फीड करने के लिए स्टैंडर्ड चॉइस। एक Slack एंडपॉइंट एक Slack Incoming Webhook URL है — कोई OAuth नहीं, कोई ऐप इंस्टॉल नहीं — और SMLLR उसी इवेंट को रॉ JSON के बजाय एक वन-लाइन ह्यूमन-रीडेबल Slack मैसेज के तौर पर फॉर्मेट करता है; वे मैसेज असल में कैसे दिखते हैं इसके लिए डेडिकेटेड Slack गाइड देखें। Zapier को SMLLR-विशिष्ट कुछ भी बिल्कुल नहीं चाहिए — Zapier के अपने बिल्ट-इन "Webhooks by Zapier → Catch Hook" ट्रिगर को एक जेनेरिक SMLLR एंडपॉइंट URL पर पॉइंट करें और आप 6,000+ ऐप में वायर्ड हो जाते हैं बिना SMLLR को Zapier की डायरेक्टरी में एक पब्लिश्ड ऐप चाहिए; एग्जैक्ट स्टेप के लिए Zapier ऑटोमेशन गाइड देखें।
कोई लीड डेटा नहीं, कभी नहीं
हर इवेंट पेलोड जानबूझकर मिनिमल है — सिर्फ QR और स्कैन एनालिटिक्स (QR नाम, कैंपेन, स्कैन टाइमस्टैंप, डिवाइस, ब्राउज़र, मोटा देश/क्षेत्र/शहर, टारगेट URL, इवेंट पर निर्भर करते हुए)। छह इवेंट में से कोई भी, किसी भी परिस्थिति में, Lead Hub से एक स्कैनर का नाम, ईमेल, फोन नंबर, या सहमति रिकॉर्ड नहीं ले जाता। यह कोई सेटिंग नहीं है जिसे आप गलती से चालू कर सकें — यह एक स्ट्रक्चरल गुण है कि SMLLR शुरू से पेलोड में क्या बनाता है।
इसकी कीमत क्या है
Webhooks, Slack, और Zapier सभी SMLLR के Pro प्लान (₹4,999/महीना) और उससे ऊपर उपलब्ध हैं — वही प्लान, वही फीचर फ्लैग, कोई अलग ऐड-ऑन नहीं। प्रति अकाउंट 10 तक एंडपॉइंट, जेनेरिक और Slack मिलाकर। पूरे टेक्निकल संदर्भ के लिए पेलोड में क्या है और सिग्नेचर वेरिफिकेशन कैसे काम करता है देखें।
अक्सर पूछे जाने वाले सवाल
QR कोड वेबहुक के लिए मुझे किस प्लान की ज़रूरत है?
Pro प्लान और उससे ऊपर (₹4,999/महीना)। वही ज़रूरत वेबहुक, Slack, और Zapier को कवर करती है।
एक वेबहुक एंडपॉइंट कितने इवेंट पा सकता है?
छह इवेंट टाइप में से जो भी सबसेट आप एंडपॉइंट बनाते या एडिट करते समय चुनते हैं। नए एंडपॉइंट डिफ़ॉल्ट रूप से दो हाईएस्ट-वॉल्यूम, हर-मैचिंग-स्कैन-पर-फायर होने वाले इवेंट (शेड्यूल्ड और डिवाइस रीडायरेक्ट) को छोड़कर बाकी सब पाते हैं, जिन्हें साफ ऑप्ट-इन चाहिए।
क्या qr.scan_limit_reached लिमिट के बाद हर बार किसी के स्कैन करने पर फायर होता है?
नहीं — यह ठीक एक बार फायर होता है, उस खास स्कैन पर जहां QR अपनी लिमिट URL से अपनी फॉलबैक URL में क्रॉस करता है। इसके बाद हर स्कैन एक सामान्य scan.created इवेंट है, दोहराया गया qr.scan_limit_reached नहीं।
क्या एक वेबहुक Slack के बजाय एक SMS या WhatsApp मैसेज ट्रिगर कर सकता है?
SMLLR से सीधे नहीं, लेकिन वही जेनेरिक वेबहुक एंडपॉइंट Zapier पर पॉइंट कर सकता है, जो फिर अपनी खुद की ऐप लाइब्रेरी से एक SMS/WhatsApp एक्शन ट्रिगर कर सकता है।
एक अकाउंट में कितने एंडपॉइंट हो सकते हैं?
10 तक, जेनेरिक वेबहुक एंडपॉइंट और Slack एंडपॉइंट के बीच शेयर्ड।
क्या इवेंट होने और वेबहुक फायर होने के बीच कोई देरी है?
नहीं — इवेंट उसी पल एनक्यू होता है जब यह होता है और एक डेडिकेटेड डिलीवरी प्रोसेस द्वारा डिलीवर किया जाता है, जानबूझकर स्कैन-रीडायरेक्ट पाथ से अलग रखा गया ताकि एक धीमा या पहुंच से बाहर एंडपॉइंट कभी एक असली स्कैन रीडायरेक्ट में लेटेंसी न जोड़े।
अगर एक इवेंट फायर होते समय मेरा एंडपॉइंट डाउन हो तो क्या होता है?
SMLLR अपने आप रीट्राई करता है। 5 फेल्ड अटेम्प्ट के बाद, वह खास डिलीवरी रीट्राई करना बंद कर देती है और परमानेंटली फेल्ड के तौर पर लॉग होती है — हर अटेम्प्ट, सफलता हो या असफलता, डिलीवरी हिस्ट्री में 90 दिन तक विज़िबल है।