वेबहुक कॉन्फ़िगरेशन गाइड
वेबहुक क्या है?
वेबहुक SNSTracker को तब आपके सर्वर या एप्लिकेशन पर अपने‑आप नोटिफ़िकेशन भेजने की अनुमति देता है जब मॉनिटर किया गया कंटेंट आपकी कॉन्फ़िगर की गई सीमाओं को पूरा करता है। उदाहरण के लिए, जब किसी वीडियो के व्यूज़ में उल्लेखनीय वृद्धि होती है, या जब किसी चैनल के नए फ़ॉलोअर्स बढ़ते हैं, तो SNSTracker आपके वेबहुक URL पर एक नोटिफ़िकेशन भेजेगा (आमतौर पर 1 मिनट के भीतर)।
चरण‑दर‑चरण कॉन्फ़िगरेशन गाइड
चरण 1: अपना वेबहुक एंडपॉइंट तैयार करें
SNSTracker में कॉन्फ़िगर करने से पहले, आपके पास एक वेबहुक एंडपॉइंट तैयार होना चाहिए। यह एक ऐसा URL है जो HTTP POST अनुरोध प्राप्त कर सकता है।
आपके वेबहुक एंडपॉइंट के विकल्प:
- अपना सर्वर:
https://api.yourcompany.com/webhook - क्लाउड फ़ंक्शंस: AWS Lambda, Google Cloud Functions, Azure Functions, आदि।
- ऑटोमेशन प्लेटफ़ॉर्म्स: Zapier, Make.com, n8n, आदि।
- टेस्टिंग सर्विसेज़: webhook.site (केवल परीक्षण के लिए)
आवश्यकताएँ:
- HTTPS का उपयोग होना चाहिए (URL
https://से शुरू हो) - POST अनुरोध स्वीकार करने चाहिए
- सफलता के लिए HTTP 200-299 स्टेटस कोड लौटाना चाहिए
चरण 2: SNSTracker में वेबहुक टार्गेट जोड़ें
-
Collections पेज पर जाएँ
- SNSTracker में लॉग इन करें
- बाएँ साइडबार (Track सेक्शन के तहत) में Collections पर क्लिक करें
- या सीधे जाएँ:
/dashboard/collections
-
Manage Notify Targets खोलें
- Collections पेज पर "Manage Notify Targets" बटन खोजें और क्लिक करें
- इससे नोटिफ़िकेशन टार्गेट्स मैनेजमेंट डायलॉग खुलेगा
-
नया टार्गेट जोड़ें
- "Add Target" बटन पर क्लिक करें
- नया नोटिफ़िकेशन टार्गेट बनाने के लिए एक डायलॉग दिखाई देगा
-
Webhook टाइप चुनें
- डायलॉग में "Type" ड्रॉपडाउन खोजें
- विकल्पों में से "Webhook" चुनें
-
Webhook URL दर्ज करें
- "Webhook URL" फ़ील्ड में अपना वेबहुक एंडपॉइंट URL दर्ज करें
- उदाहरण:
https://api.yourcompany.com/webhook - महत्वपूर्ण: URL
https://से शुरू होना चाहिए
-
टिप्पणी जोड़ें (वैकल्पिक)
- "Comment" फ़ील्ड में आप यह याद रखने के लिए नोट जोड़ सकते हैं कि यह वेबहुक किस लिए है
- उदाहरण: "Production webhook for TikTok monitoring"
- अधिकतम 50 अक्षर
-
सिग्नेचर की कॉन्फ़िगर करें (वैकल्पिक, प्रोडक्शन के लिए अनुशंसित)
- "Extra" फ़ील्ड में आप सिग्नेचर की के साथ एक JSON ऑब्जेक्ट जोड़ सकते हैं:
{ "signature_key": "your-secret-key-here" }- यह की अनुरोधों की प्रामाणिकता सत्यापित करने के लिए उपयोग होगी
- यदि प्रदान नहीं की गई, तो SNSTracker आपकी API की या वेबहुक URL को सिग्नेचर की के रूप में उपयोग करेगा
-
वेबहुक टार्गेट सेव करें
- "Save" बटन पर क्लिक करें
- आपका वेबहुक टार्गेट अब बन गया है और उपयोग के लिए तैयार है
चरण 3: Collection में नोटिफ़िकेशन नियम कॉन्फ़िगर करें
-
Collection सेटिंग्स खोलें
- Collections पेज पर वापस जाएँ
- जिस collection के लिए आप नोटिफ़िकेशन कॉन्फ़िगर करना चाहते हैं उसे खोजें
- Edit बटन पर क्लिक करें (या सेटिंग्स खोलने के लिए collection नाम पर क्लिक करें)
-
Feed Notify सक्षम करें (वीडियो/पोस्ट के लिए)
- collection सेटिंग्स में "Feed Notify" सेक्शन खोजें
- "Enable Notifications" स्विच को ON करें
- "Notify Targets" ड्रॉपडाउन से अपना वेबहुक टार्गेट चुनें
- जिन "Metrics" की आप निगरानी करना चाहते हैं उन्हें चुनें:
- Views
- Engagement (likes + comments + shares)
- "Threshold" मान सेट करें:
- संख्या दर्ज करें (जैसे, 1000) ताकि जब मेट्रिक इस मात्रा से बढ़े तब नोटिफ़ाई हो
- हर सफल रिफ़्रेश के बाद नोटिफ़ाई करने के लिए 0 सेट करें
- "Save" या "Update" पर क्लिक करें
-
Channel Notify सक्षम करें (अकाउंट्स के लिए)
- उसी collection सेटिंग्स में "Channel Notify" सेक्शन खोजें
- "Enable Notifications" स्विच को ON करें
- "Notify Targets" ड्रॉपडाउन से अपना वेबहुक टार्गेट चुनें
- जिन "Metrics" की आप निगरानी करना चाहते हैं उन्हें चुनें:
- Followers
- Followings
- Likes
- "Threshold" मान सेट करें:
- संख्या दर्ज करें (जैसे, 500) ताकि जब मेट्रिक इस मात्रा से बढ़े तब नोटिफ़ाई हो
- हर सफल रिफ़्रेश के बाद नोटिफ़ाई करने के लिए 0 सेट करें
- "Save" या "Update" पर क्लिक करें
-
कॉन्फ़िगरेशन सत्यापित करें
- सुनिश्चित करें कि वेबहुक टार्गेट और नोटिफ़िकेशन नियम दोनों सेव हैं
- अब जब कॉन्फ़िगर की गई सीमाएँ पूरी होंगी, आपका वेबहुक नोटिफ़िकेशन प्राप्त करेगा
चरण 4: अपना वेबहुक टेस्ट करें
-
टेस्टिंग सर्विस का उपयोग करें (पहली बार सेटअप के लिए अनुशंसित)
- webhook.site पर जाएँ
- दिया गया यूनिक URL कॉपी करें (जैसे,
https://webhook.site/unique-id) - इस URL को चरण 2 में अपने वेबहुक URL के रूप में उपयोग करें
- threshold 0 के साथ एक नोटिफ़िकेशन कॉन्फ़िगर करें (किसी भी बदलाव पर ट्रिगर करने के लिए)
- SNSTracker के आपके कंटेंट को चेक करने का इंतज़ार करें
- webhook.site पर जाकर देखें कि क्या आपको नोटिफ़िकेशन मिला
-
अपने एंडपॉइंट लॉग्स देखें
- यदि अपना सर्वर उपयोग कर रहे हैं, तो सर्वर लॉग्स देखें
- SNSTracker से आने वाले POST अनुरोध खोजें
- सत्यापित करें कि अनुरोध बॉडी में अपेक्षित डेटा है
-
नोटिफ़िकेशन फ़ॉर्मेट सत्यापित करें
- नोटिफ़िकेशन एक JSON ऑब्जेक्ट होना चाहिए जिसमें:
title: नोटिफ़िकेशन का विवरणtype: "feed" या "channel"timestamp: नोटिफ़िकेशन कब भेजा गयाdata: उन आइटम्स की ऐरे जिनसे नोटिफ़िकेशन ट्रिगर हुआ
- नोटिफ़िकेशन एक JSON ऑब्जेक्ट होना चाहिए जिसमें:
वेबहुक नोटिफ़िकेशन कैसे भेजे जाते हैं
SNSTracker वेबहुक डिलीवरी को अनुकूलित करने के लिए बैचिंग मेकैनिज़्म का उपयोग करता है:
-
तत्काल डिटेक्शन: जब कोई मॉनिटर किया गया संसाधन (फीड या चैनल) सफलतापूर्वक रिफ़्रेश होता है और आपकी नोटिफ़िकेशन सीमा पूरी करता है, तो उसे तुरंत नोटिफ़िकेशन के लिए फ़्लैग कर दिया जाता है।
-
1‑मिनट बैच विंडो: अलग‑अलग नोटिफ़िकेशन तुरंत भेजने के बजाय, SNSTracker 1‑मिनट की विंडो के भीतर सभी पात्र नोटिफ़िकेशन इकट्ठा करता है।
-
समेकित डिलीवरी: प्रत्येक 1‑मिनट अवधि के अंत में, उस विंडो के सभी नोटिफ़िकेशन को एकल वेबहुक अनुरोध में मर्ज करके साथ में भेजा जाता है।
उदाहरण परिदृश्य:
- 10:00:15 पर, Feed A सीमा पूरी करता है → फ़्लैग किया गया
- 10:00:45 पर, Feed B सीमा पूरी करता है → फ़्लैग किया गया
- 10:01:00 पर, Feed A और Feed B दोनों एक ही वेबहुक अनुरोध में भेजे जाते हैं
लाभ:
- आपके एंडपॉइंट पर HTTP अनुरोधों की संख्या कम होती है
- दक्षता बढ़ती है और सर्वर लोड घटता है
- तेज़ डेटा बदलावों के दौरान नोटिफ़िकेशन स्पैम से बचाव होता है
- बैच अवधि के भीतर सभी नोटिफ़िकेशन
dataऐरे में शामिल होते हैं
नोट: किसी संसाधन के सीमा पूरी करने और वेबहुक भेजे जाने के बीच अधिकतम देरी 1 मिनट है। इससे सिस्टम की दक्षता बनाए रखते हुए लगभग रियल‑टाइम नोटिफ़िकेशन सुनिश्चित होते हैं।
आपको कौन सा डेटा मिलेगा?
जब नोटिफ़िकेशन ट्रिगर होता है, तो आपको इस तरह का JSON डेटा वाला POST अनुरोध मिलेगा:
{
"title": "SNSTracker Notification: Feed Views Increased",
"type": "feed",
"timestamp": "2024-01-15T10:30:00Z",
"data": [
{
"feed_id": "feed-123",
"url": "https://www.tiktok.com/@user/video/123",
"platform_name": "TikTok",
"view_count": 10000,
"like_count": 2000,
"changed_views": 1000,
"changed_engagement": 50
}
]
}Feed Notification Data फ़ील्ड्स
feed_id: यूनिक आइडेंटिफ़ायरurl: वीडियो/पोस्ट का डायरेक्ट लिंकplatform_name: प्लेटफ़ॉर्म (TikTok, Instagram, आदि)title: कंटेंट शीर्षकdescription: कंटेंट विवरणauthor_username: क्रिएटर का यूज़रनेमauthor_nickname: क्रिएटर का डिस्प्ले नेमview_count: कुल व्यूज़like_count: कुल लाइक्सcomment_count: कुल कमेंट्सshare_count: कुल शेयरchanged_views: पिछली जांच के बाद बढ़े हुए व्यूज़changed_engagement: बढ़ा हुआ एंगेजमेंट (likes + comments + shares)
Channel Notification Data फ़ील्ड्स
id: चैनल यूनिक आइडेंटिफ़ायरchannel_url: चैनल/प्रोफ़ाइल का डायरेक्ट लिंकplatform_name: प्लेटफ़ॉर्म नामnickname: डिस्प्ले नेमusername: यूज़रनेम/हैंडलfollowers: कुल फ़ॉलोअर्सfollowings: कुल फ़ॉलो किए गए अकाउंट्सlikes: कुल लाइक्सchanged_followers: पिछली जांच के बाद बढ़े हुए फ़ॉलोअर्सchanged_followings: पिछली जांच के बाद बढ़ी हुई फ़ॉलोइंग्सchanged_likes: पिछली जांच के बाद बढ़े हुए लाइक्स
सुरक्षा: सिग्नेचर वेरिफ़िकेशन
SNSTracker अनुरोध की प्रामाणिकता सत्यापित करने के लिए X-Signature हेडर में एक सिग्नेचर शामिल करता है। सिग्नेचर की इस आधार पर तय होती है:
- Extra फ़ील्ड में
signature_key(यदि प्रदान की गई हो) - आपकी पहली सक्रिय API की (यदि signature_key सेट नहीं है)
- आपका वेबहुक URL (फॉलबैक के रूप में)
प्रोडक्शन उपयोग के लिए, अनुरोधों की प्रामाणिकता सुनिश्चित करने हेतु सिग्नेचर वेरिफ़ाई करना अनुशंसित है।
ट्रबलशूटिंग
वेबहुक को नोटिफ़िकेशन नहीं मिल रहे
-
वेबहुक URL जाँचें
- सत्यापित करें कि URL सही और एक्सेसिबल है
- सुनिश्चित करें कि यह
https://से शुरू होता है - POST अनुरोध से URL को मैन्युअली टेस्ट करें
-
नोटिफ़िकेशन सेटिंग्स जाँचें
- सत्यापित करें कि आपकी Collection में नोटिफ़िकेशन सक्षम हैं
- सुनिश्चित करें कि वेबहुक टार्गेट चुना गया है
- सुनिश्चित करें कि thresholds सही सेट हैं
-
एंडपॉइंट स्टेटस जाँचें
- सुनिश्चित करें कि आपका एंडपॉइंट चल रहा है और एक्सेसिबल है
- इनकमिंग अनुरोधों के लिए सर्वर लॉग्स देखें
- सत्यापित करें कि आपका एंडपॉइंट सफलता स्टेटस (200-299) लौटाता है
सामान्य समस्याएँ
समस्या: "Webhook URL already exists"
समाधान: प्रत्येक वेबहुक URL प्रति टीम केवल एक बार उपयोग किया जा सकता है। कोई दूसरा URL उपयोग करें या मौजूदा टार्गेट को एडिट करें।
समस्या: नोटिफ़िकेशन ट्रिगर नहीं हो रहे
समाधान:
- टेस्ट के लिए threshold 0 सेट करें (किसी भी बदलाव पर नोटिफ़ाई करता है)
- SNSTracker के आपके कंटेंट को चेक करने का इंतज़ार करें (चेकिंग समय‑समय पर होती है)
- सत्यापित करें कि आपका कंटेंट वास्तव में threshold मात्रा से बदला है
समस्या: टाइमआउट त्रुटियाँ
समाधान: आपके एंडपॉइंट को 30 सेकंड के भीतर प्रतिक्रिया देनी चाहिए। अपने एंडपॉइंट का रिस्पॉन्स टाइम ऑप्टिमाइज़ करें।
सहायता चाहिए?
यदि आपको समस्याएँ आती हैं:
- सत्यापित करें कि आपका वेबहुक URL एक्सेसिबल है
- जाँचें कि नोटिफ़िकेशन सेटिंग्स सक्षम हैं
- सुनिश्चित करें कि thresholds सही कॉन्फ़िगर हैं
- समस्या बनी रहने पर सपोर्ट से संपर्क करें
हैप्पी ट्रैकिंग! 🚀