फीचर
SMLLR Webhooks: रियल-टाइम QR और स्कैन इवेंट, आपको पुश किए गए।
एक URL, एक Slack चैनल, या एक Zapier ट्रिगर रजिस्टर करें, और जिस पल एक QR बनता, स्कैन होता, या एक रीडायरेक्ट नियम ट्रिगर होता है, SMLLR उसे एक साइन्ड JSON पेलोड पोस्ट करता है — रियल टाइम, कोई पोलिंग नहीं।
छह इवेंट, होते ही डिलीवर
Settings → Webhooks & Slack (Pro प्लान और उससे ऊपर) के तहत एक HTTPS एंडपॉइंट (या एक Slack चैनल) रजिस्टर करें और जिस पल एक सब्सक्राइब्ड इवेंट होता है, SMLLR उसे एक साइन्ड JSON पेलोड POST करता है — कोई पोलिंग नहीं, कोई देरी नहीं। यह REST API और MCP सर्वर को पूरा करता है, जो दोनों पुल-बेस्ड हैं; webhooks उसी अकाउंट एनालिटिक्स के लिए पुश-बेस्ड समकक्ष हैं।
- इवेंट टाइप: scan.created, qr.created, qr.updated, qr.scan_limit_reached, qr.scheduled_redirect_fired, qr.device_redirect_matched
- हर एंडपॉइंट चुनता है कि वह किन इवेंट को सब्सक्राइब करता है — नए एंडपॉइंट डिफ़ॉल्ट रूप से दो सबसे हाई-वॉल्यूम, प्रति-स्कैन रीडायरेक्ट इवेंट को छोड़कर सब कुछ लेते हैं
- scan.created पेलोड: qrCodeId, qrCodeName, campaignId, scanId, scannedAt, device, os, browser, country, region, city, targetUrl
- डिलीवरी अकाउंट-वाइड है — अकाउंट में हर मैचिंग इवेंट पर हर एनेबल्ड एंडपॉइंट फायर होता है (v1 में कोई प्रति-QR स्कोपिंग नहीं)
- प्रति अकाउंट 10 एंडपॉइंट तक, जेनेरिक और Slack मिलाकर
- सिर्फ HTTPS एंडपॉइंट URL
कभी कोई लीड डेटा नहीं
हर इवेंट पेलोड जानबूझकर न्यूनतम है — वही एग्रीगेटेड स्कैन/QR फील्ड जो REST API और MCP सर्वर पहले से एक्सपोज़ करते हैं, कभी पूरा इंटरनल स्कैन रिकॉर्ड नहीं (जिसमें IP एड्रेस, सटीक GPS, और फ्रॉड-डिटेक्शन सिग्नल भी होते हैं), और कभी Lead Hub से कुछ नहीं। एक webhook पेलोड डिज़ाइन के हिसाब से कभी भी एक स्कैनर का नाम, ईमेल, फोन नंबर, या सहमति रिकॉर्ड नहीं ले जा सकता — सिर्फ कॉन्फ़िगरेशन के हिसाब से नहीं।
Slack और Zapier, एक ही इंफ्रास्ट्रक्चर पर
एक Slack एंडपॉइंट बस एक Slack Incoming Webhook URL है — इसे पेस्ट करें और SMLLR उस चैनल में एक फॉर्मेटेड मैसेज पोस्ट करता है, किसी अलग ऐप इंस्टॉल या OAuth अप्रूवल की ज़रूरत नहीं। Zapier उल्टे तरीके से वैसे ही काम करता है: 6,000+ ऐप से कनेक्ट करने के लिए Zapier के बिल्ट-इन 'Webhooks by Zapier → Catch Hook' ट्रिगर को एक जेनेरिक SMLLR एंडपॉइंट URL पर पॉइंट करें, Zapier डायरेक्टरी में किसी SMLLR ऐप की ज़रूरत नहीं।
डिलीवरी वेरिफाई करना
हर जेनेरिक-एंडपॉइंट डिलीवरी में एक X-Smllr-Signature हेडर (टाइमस्टैंप और रॉ रिक्वेस्ट बॉडी पर HMAC-SHA256, उस सीक्रेट का इस्तेमाल करके जो आपके एंडपॉइंट बनाते समय एक बार दिखाया जाता है) और एक X-Smllr-Timestamp हेडर शामिल होता है। अपनी तरफ सिग्नेचर को दोबारा कैलकुलेट करें और तुलना करें — यह पुष्टि करता है कि पेलोड असल में SMLLR से आया है और ट्रांज़िट में रीप्ले या छेड़छाड़ नहीं की गई। Slack एंडपॉइंट में कोई सिग्नेचर नहीं है — Incoming Webhook URL खुद ही सीक्रेट है।
डिलीवरी और रीट्राई
फेल हुई डिलीवरी (एंडपॉइंट डाउन, नॉन-2xx रिस्पॉन्स, टाइमआउट) अपने आप रीट्राई होती हैं; लगातार फेल होने वाली डिलीवरी 5 अटेम्प्ट के बाद एक डेड-लेटर क्यू में चली जाती हैं। हर अटेम्प्ट — सफल या असफल — लॉग होता है और Settings → Webhooks & Slack के तहत 90 दिनों तक दिखता है, जिसमें HTTP स्टेटस और रिस्पॉन्स टाइम शामिल है, ताकि आप बिना अंदाज़ा लगाए एक गलत कॉन्फ़िगर किए गए एंडपॉइंट को डीबग कर सकें।
अक्सर पूछे जाने वाले सवाल
क्या SMLLR आउटबाउंड webhooks सपोर्ट करता है?
हां, Pro प्लान और उससे ऊपर। Settings → Webhooks & Slack के तहत एक HTTPS URL रजिस्टर करें और SMLLR आपके सब्सक्राइब किए गए हर इवेंट के लिए उसे एक साइन्ड JSON पेलोड POST करता है।
कौन-से इवेंट एक webhook को ट्रिगर कर सकते हैं?
छह इवेंट टाइप: scan.created, qr.created, qr.updated, qr.scan_limit_reached, qr.scheduled_redirect_fired, और qr.device_redirect_matched। आप चुनते हैं कि हर एंडपॉइंट कौन-से पाता है।
एक webhook पेलोड में क्या डेटा होता है?
सिर्फ एग्रीगेटेड QR/स्कैन एनालिटिक्स: QR कोड, कैंपेन, स्कैन ID, टाइमस्टैंप, डिवाइस, OS, ब्राउज़र, और देश/क्षेत्र/शहर, इवेंट पर निर्भर करते हुए। कभी IP एड्रेस, सटीक GPS, या कोई Lead Hub कॉन्टैक्ट डेटा नहीं।
क्या SMLLR Slack के साथ इंटीग्रेट करता है?
हां — अपने वर्कस्पेस से एक Slack Incoming Webhook URL बनाएं और इसे Settings → Webhooks & Slack में एक Slack-टाइप एंडपॉइंट के तौर पर पेस्ट करें। कोई OAuth या ऐप इंस्टॉल अप्रूवल की ज़रूरत नहीं।
क्या SMLLR Zapier के साथ इंटीग्रेट करता है?
हां — Zapier के बिल्ट-इन 'Webhooks by Zapier' ट्रिगर (Catch Hook) को एक जेनेरिक SMLLR webhook एंडपॉइंट URL पर पॉइंट करें। इसके काम करने के लिए SMLLR को Zapier डायरेक्टरी में एक अलग ऐप लिस्टिंग की ज़रूरत नहीं है।
मैं कैसे वेरिफाई करूं कि एक webhook SMLLR से आया?
जेनेरिक एंडपॉइंट में एक X-Smllr-Signature हेडर शामिल होता है — टाइमस्टैंप और रिक्वेस्ट बॉडी पर एक HMAC-SHA256 सिग्नेचर, उस सीक्रेट से कैलकुलेट किया गया जो आपके एंडपॉइंट बनाते समय एक बार दिखाया जाता है। इसे अपनी तरफ दोबारा कैलकुलेट करें और तुलना करें। Slack एंडपॉइंट में कोई सिग्नेचर नहीं है; Incoming Webhook URL खुद ही सीक्रेट है।
अगर मेरा एंडपॉइंट डाउन हो तो क्या होता है?
SMLLR फेल हुई डिलीवरी को अपने आप रीट्राई करता है। 5 फेल्ड अटेम्प्ट के बाद, वह डिलीवरी हमेशा रीट्राई करते रहने के बजाय एक डेड-लेटर क्यू में चली जाती है। हर अटेम्प्ट Settings → Webhooks & Slack में लॉग होता है।
क्या मैं एक webhook को सिर्फ एक QR कोड तक सीमित कर सकता हूं?
मौजूदा वर्ज़न में नहीं — अकाउंट में हर मैचिंग इवेंट पर हर एनेबल्ड एंडपॉइंट फायर होता है। प्रति-QR स्कोपिंग एक स्वाभाविक भविष्य का विस्तार है, अभी नहीं बना।
webhooks के लिए मुझे किस प्लान की ज़रूरत है?
Pro प्लान और उससे ऊपर — यही ज़रूरत webhooks, Slack, और Zapier तीनों को कवर करती है।
हर फीचर अनलॉक करें
3 स्टैटिक QR कोड के साथ मुफ्त में शुरू करें। डायनामिक QR कोड, ज़्यादा कोड, और स्कैन एनालिटिक्स अनलॉक करने के लिए कभी भी अपग्रेड करें।