जिस पल यह होता है,
आपका सर्वर जान जाता है
मॉडरेशन इवेंट आपके सर्वर तक उसी पल पहुँचाए जाते हैं जब वे होते हैं: स्पैम डिटेक्शन, बैन, जॉइन और बहुत कुछ — हर डिलीवरी HMAC-सिग्नेचर वाली, डिडुप्लिकेटेड और शेड्यूल पर रिट्राई की हुई जब तक आपका एंडपॉइंट उसकी पुष्टि न कर दे।
- रियल टाइम में इवेंट
- HMAC-सिग्नेचर वाले पेलोड
- डिलीवर होने तक रिट्राई
सात इवेंट, सीधे इंजन से
प्रति एंडपॉइंट ठीक उन्हीं इवेंट को सब्सक्राइब करें जिनकी आपको ज़रूरत है — स्पैम वर्डिक्ट से लेकर सदस्यता बदलावों तक।
spam.detectedmessage.suspicioususer.banneduser.kickeduser.muteduser.joineduser.leftहर इवेंट एक सघन JSON एनवेलप में आता है: id, type, created_at, group_id और इवेंट डेटा — id रिट्राई के दौरान स्थिर रहता है, इसलिए डिडुप्लिकेशन एक सेट लुकअप भर है।
रिट्राई शेड्यूल, ठीक जैसा वह चलता है
करीब आठ घंटों में छह प्रयास — एक डिप्लॉय, एक रीस्टार्ट या आपकी ओर के पूरे आउटेज को झेल लेने के लिए काफ़ी।
0तुरंत+1m+5m+30m+2h+6hअंतिम प्रयासऐसी डिलीवरी जिस पर आप भरोसे से बना सकें
कम-से-कम-एक-बार डिलीवरी
हर इवेंट कम-से-कम एक बार डिलीवर होता है। आपका एंडपॉइंट किसी भी 2xx से पुष्टि करता है — बाक़ी कुछ भी रिट्राई क़तार में वापस चला जाता है।
डिडुप के लिए स्थिर id
हर इवेंट का एक स्थिर id होता है जो रिट्राई में बचा रहता है। आपकी ओर डिडुप्लिकेशन एक अकेला लुकअप है, कोई अनुमान नहीं।
कोई ज़ॉम्बी एंडपॉइंट नहीं
कई दिनों तक विफल रहने वाला एंडपॉइंट अपने-आप निष्क्रिय हो जाता है — और आपके डेटा में चुपचाप अंतराल के बजाय आपको एक Telegram DM मिलता है।
टेस्ट पिंग
एक-क्लिक टेस्ट इवेंट, असली जैसा सिग्नेचर वाला — इससे पहले कि कोई असली इवेंट इस पर निर्भर हो, अपने हैंडलर को सत्यापित करें।
जाँची जा सकने वाली हिस्ट्री
प्रति एंडपॉइंट पूरी डिलीवरी हिस्ट्री: हर प्रयास, स्थिति और टाइमस्टैम्प — अपने रिसीवर को डिबग करने में कभी अटकल नहीं लगती।
सिर्फ़ HTTPS, हमेशा सिग्नेचर वाला
एंडपॉइंट पब्लिक HTTPS URL होने चाहिए, और हर पेलोड सिग्नेचर वाला होता है। ट्रांसपोर्ट और लेखकत्व दोनों कवर हैं।
हर डिलीवरी सत्यापित करें
आपकी ओर तीन लाइन — और कोई भी किसी इवेंट को फ़र्ज़ी या रीप्ले नहीं कर सकता।
# X-Telm-Signature: v1=<hex>
expected = hmac_sha256(secret, timestamp + "." + body)
valid = constant_time_eq("v1=" + hex(expected), header)पुश करें, पोल नहीं
किसी API को पोल करना बताता है कि जब आपने पूछा तब क्या हुआ; webhooks उसी पल बता देते हैं जब कुछ होता है। एक HTTPS एंडपॉइंट रजिस्टर करें, जिन इवेंट की आपको परवाह है उन्हें चुनें, और Telm उन्हें JSON के रूप में आपके सर्वर तक पुश करना शुरू कर देता है — एक स्पैम लहर, एक बैन, जॉइन की एक बाढ़ — जिस पल इंजन कार्रवाई करता है।
हर डिलीवरी सिग्नेचर वाली होती है। X-Telm-Signature हेडर टाइमस्टैम्प और बॉडी का एक HMAC-SHA256 रखता है जो आपके एंडपॉइंट के सीक्रेट से गणना किया जाता है, ताकि आपका सर्वर तीन लाइन कोड में लेखकत्व और ताज़गी दोनों सत्यापित कर सके। पेलोड सिर्फ़ HTTPS पर ही चलते हैं।
डिलीवरी असली इंटरनेट के लिए बनाई गई है, जहाँ रिसीवर बंद हो जाते हैं। इवेंट डिडुप्लिकेशन के लिए एक स्थिर id के साथ कम-से-कम-एक-बार डिलीवर होते हैं; विफलताएँ बढ़ते शेड्यूल पर रिट्राई होती हैं — तुरंत, फिर 1 और 5 मिनट बाद, 30 मिनट, 2 और 6 घंटे बाद। एक एंडपॉइंट जो कई दिनों तक विफल रहता है वह अपने-आप निष्क्रिय हो जाता है, और चुपचाप अंतराल के बजाय आपको उसके बारे में एक Telegram संदेश मिलता है।
सब कुछ जाँचा जा सकता है: लाइव जाने से पहले एक टेस्ट पिंग भेजें, और डिलीवरी हिस्ट्री ब्राउज़ करें — प्रयास दर प्रयास, स्थिति दर स्थिति — जब भी आपको अपनी ओर की पाइप डिबग करनी हो।
अक्सर पूछे जाने वाले सवाल
मैं कैसे सत्यापित करूँ कि इवेंट सचमुच Telm से आया है?
हर डिलीवरी में एक X-Telm-Signature हेडर होता है: "timestamp.body" का एक HMAC-SHA256 जो आपके एंडपॉइंट के सीक्रेट से गणना किया जाता है। इसे अपनी ओर दोबारा गणना करें, स्थिर समय में तुलना करें, और रीप्ले से बचने के लिए कुछ मिनट से पुरानी किसी भी चीज़ को अस्वीकार कर दें।
अगर इवेंट होते समय मेरा सर्वर बंद हो तो क्या होगा?
Telm एक बढ़ते शेड्यूल पर रिट्राई करता है — तुरंत, फिर 1 मिनट, 5 मिनट, 30 मिनट, 2 घंटे और 6 घंटे बाद। कोई भी 2xx रिस्पॉन्स डिलीवर हुआ गिना जाता है। इवेंट में एक स्थिर id होता है, इसलिए रिट्राई कभी आपके सिस्टम में डुप्लिकेट नहीं बनता।
क्या एक ख़राब एंडपॉइंट हमेशा के लिए बाढ़ ला सकता है?
नहीं। एक एंडपॉइंट जो लगातार करीब बीस बार विफल होता है और तीन दिनों तक कोई सफलता नहीं, अपने-आप निष्क्रिय हो जाता है, और आपको एक Telegram नोटिफ़िकेशन मिलता है। अपनी ओर ठीक करें और एक क्लिक में उसे फिर से सक्षम करें।
लाइव जाने से पहले मैं अपने इंटीग्रेशन को कैसे टेस्ट करूँ?
डैशबोर्ड या API से सीधे किसी भी एंडपॉइंट पर एक टेस्ट पिंग भेजें — यह असली इवेंट की तरह ही सिग्नेचर वाला आता है। डिलीवरी हिस्ट्री हर प्रयास को उसकी स्थिति के साथ दिखाती है।
किन प्लान में webhooks शामिल हैं?
Webhooks पूरे API पैकेज का हिस्सा हैं, जो Pro और Business प्लान में शामिल है।
जहाँ टीमें इसका उपयोग करती हैं
असली समुदाय प्रकार जहाँ यह सुविधा भारी काम संभालती है।
नए उपयोगकर्ताओं को प्रश्न पूछने की अनुमति देते हुए समर्थन चैनलों को स्पैम से साफ रखें। समर्थन मोड ऑनबोर्डिंग को आसान बनाता है।
कंपनी समूहों और ग्राहक समुदायों के लिए पेशेवर मॉडरेशन। विस्तृत ऑडिट लॉग के साथ मज़बूत सुरक्षा।
अपने प्रशंसक आधार को धोखेबाजों से बचाएं जो आपकी नकल करते हैं। अपने समुदाय के लिए एक सुरक्षित स्थान बनाएं।
संबंधित सुविधाएं
जानें कि Telm आपके समुदाय की और कैसे मदद कर सकता है