मॉडरेशन की ताक़त,
आपके कोड से कॉल करने योग्य
Telm को अपने सिस्टम में जोड़ें: प्रोडक्शन एंटी-स्पैम इंजन से किसी भी टेक्स्ट को चेक करें, कोड से ग्रुप सेटिंग्स और नियम मैनेज करें, फ़ैसलों का जर्नल और एनालिटिक्स पढ़ें — सब कुछ एक साफ़-सुथरे REST API के ज़रिए, उन keys के साथ जिन्हें आप नियंत्रित करते हैं।
- स्थिर REST v1
- हर प्लान पर स्पैम चेक
- Webhooks शामिल
30 सेकंड में आपकी पहली कॉल
कोई SDK ताम-झाम नहीं: आपकी key के साथ एक HTTPS कॉल बस इतना ही काफ़ी है।
$ curl -X POST https://api.telm.com/api/public/v1/spam/check \
-H "Authorization: Bearer tk_live_..." \
-d '{"text": "Earn $500/day from home!! DM me now"}'
// HTTP 200
{
"verdict": "spam",
"score": 97,
"reasons": ["contact_flow", "money_lure"]
}एक रिक्वेस्ट, प्रोडक्शन इंजन से एक वर्डिक्ट — स्कोर और उन कारणों के साथ जो चले। नियम-आधारित चेक के लिए रिस्पॉन्स एक सेकंड से काफ़ी कम में आ जाता है।
API क्या कर सकता है
स्पैम और यूज़र चेक
किसी भी टेक्स्ट को उसी इंजन से गुज़ारें जो Telm ग्रुपों की रक्षा करता है — एकल कॉल, 20 तक के बैच, और CAS के साथ-साथ Telm के अपने डेटासेट के विरुद्ध यूज़र स्क्रीनिंग।
POST /spam/checkPOST /spam/check-batchPOST /users/checkग्रुप और सेटिंग्स
प्रोटेक्शन सेटिंग्स पढ़ें और patch करें, कस्टम मॉडरेशन नियम और whitelist मैनेज करें — एक ग्रुप के लिए या पूरे बेड़े के लिए।
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistजर्नल और एनालिटिक्स
इंजन के हर फ़ैसले को वर्डिक्ट, स्कोर और ट्रिगर हुए नियमों के साथ पढ़ें, रोज़ाना की एनालिटिक्स सीरीज़ खींचें और अपने कोटा उपयोग को ट्रैक करें।
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageWebhooks मैनेजमेंट
webhook एंडपॉइंट बनाएँ और मैनेज करें, टेस्ट पिंग भेजें और डिलीवरी हिस्ट्री जाँचें — पूरी तरह API के ज़रिए।
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesईमानदार सीमाएँ, खुलकर बताई गईं
| प्लान | प्रति दिन कॉल | रेट लिमिट | API एक्सेस |
|---|---|---|---|
| Free | 100 | 60/min | स्पैम चेक |
| Pro | 10 000 | 600/min | पूरा API + webhooks |
| Business | 50 000 | 1 800/min | पूरा API + webhooks |
सीमाएँ प्रति अकाउंट लागू होती हैं, प्रति key नहीं। हर रिस्पॉन्स में X-Quota-Limit, X-Quota-Used और X-Quota-Reset हेडर होते हैं, और सीमा पर पहुँचने पर एक साफ़ 429 Retry-After के साथ लौटता है — कोई हैरानी नहीं।
जैसी बननी चाहिए वैसी keys
एक बार दिखाई, हैश करके संग्रहीत
पूरी key ठीक एक बार दिखती है, बनाते समय। Telm सिर्फ़ एक हैश संग्रहीत करता है — कोई भी, हम सहित, आपकी key वापस नहीं पढ़ सकता।
read/write स्कोप
keys में read और write स्कोप होते हैं। अपनी रिपोर्टिंग स्क्रिप्ट को एक read-only key दें — वह भौतिक रूप से किसी सेटिंग को बदल ही नहीं सकती।
तुरंत रद्दीकरण
डैशबोर्ड से किसी भी key को रद्द करें और वह तुरंत काम करना बंद कर देती है। प्रति-अकाउंट किल स्विच एक ही बार में सारी API एक्सेस फ़्रीज़ कर सकता है।
पूरा API और webhooks Pro और Business में शामिल हैं। स्पैम चेकिंग हर प्लान पर उपलब्ध है — Free सहित — रोज़ाना कोटा के भीतर।
वही इंजन, अब आपके नियंत्रण में
पब्लिक API वही मॉडरेशन इंजन उजागर करता है जो Telm का बॉट चलाता है — कोई सरलीकृत नक़ल नहीं। किसी टेक्स्ट को /spam/check पर POST करें और वह उसी पाइपलाइन से गुज़रता है जो आपके ग्रुप इस्तेमाल करते हैं: रेपुटेशन सिग्नल, नियम, और वैकल्पिक रूप से AI क्लासिफ़ायर। इसका मतलब है कि आप Telm के फ़ैसले को कहीं भी जोड़ सकते हैं: एक सपोर्ट फ़ॉर्म, अपना बॉट, एक कमेंट सेक्शन, एक इंटरनल टूल।
चेक से आगे, API आपके ग्रुपों को कोड की तरह मैनेज करता है। प्रोटेक्शन सेटिंग्स पढ़ें और patch करें, मॉडरेशन नियम बनाएँ, whitelist बनाए रखें — डैशबोर्ड जैसे ही ऑपरेशन, पर स्क्रिप्ट-योग्य। दर्जनों समुदाय चलाने वाली एजेंसियाँ दर्जनों क्लिक के बजाय एक लूप से पॉलिसी बदलाव रोल आउट कर सकती हैं।
हिस्ट्री प्रथम-श्रेणी की है: जर्नल एंडपॉइंट इंजन के हर फ़ैसले को लौटाता है — वर्डिक्ट, स्कोर, कौन-से नियम चले, क्या कार्रवाई हुई — आर्काइविंग के लिए बने कर्सर पेजिनेशन के साथ। एनालिटिक्स एंडपॉइंट के साथ मिलाकर आप अपने ग्रुप के असली डेटा पर कम्प्लायंस आर्काइव, इंटरनल डैशबोर्ड या अलर्टिंग बना सकते हैं।
ऑथेंटिकेशन जानबूझकर उबाऊ है: आपके डैशबोर्ड में बनी bearer keys, एक बार दिखाई जातीं, हैश करके संग्रहीत, read/write स्कोप और तुरंत रद्दीकरण के साथ। हर रिस्पॉन्स में कोटा हेडर होते हैं ताकि आपका इंटीग्रेशन हमेशा जाने कि वह कहाँ खड़ा है।
अक्सर पूछे जाने वाले सवाल
किन प्लान में API एक्सेस शामिल है?
स्पैम चेकिंग (/spam/check) हर प्लान पर, Free समेत, रोज़ाना कोटा के भीतर काम करती है। पूरा API — ग्रुप सेटिंग्स, नियम, जर्नल, एनालिटिक्स, यूज़र स्क्रीनिंग और webhooks — Pro और Business में शामिल है।
रिक्वेस्ट की सीमाएँ क्या हैं?
प्लान के हिसाब से रोज़ाना कोटा: Free 100, Pro 10,000, Business 50,000 कॉल। रेट लिमिट: Free पर प्रति मिनट 60 रिक्वेस्ट, Pro पर 600, Business पर 1,800। हर रिस्पॉन्स में X-Quota-Limit, X-Quota-Used और X-Quota-Reset हेडर होते हैं।
मुझे API key कैसे मिलेगी?
डैशबोर्ड में सेटिंग्स → API और Webhooks में। key बनाते समय सिर्फ़ एक बार दिखाई जाती है — हमारे पास केवल उसका हैश संग्रहीत रहता है। आप 10 तक सक्रिय keys रख सकते हैं, उन्हें read-only स्कोप तक सीमित कर सकते हैं और किसी को भी तुरंत रद्द कर सकते हैं।
क्या API के ज़रिए AI क्लासिफ़ायर इस्तेमाल किया जा सकता है?
हाँ, Pro और Business पर: /spam/check रिक्वेस्ट में include_ai जोड़ें, और हर AI जाँच एक अलग रोज़ाना API कोटा से गिनी जाती है — Pro पर 1,000, Business पर 10,000। Free पर API से होने वाली स्पैम जाँचें सिर्फ़ नियमों पर आधारित होती हैं। यह कोटा सिर्फ़ API कॉल के लिए है: आपके Telegram ग्रुप के अंदर AI मॉडरेशन हर प्लान में शामिल है।
क्या कोई OpenAPI स्पेसिफ़िकेशन है?
हाँ, पूरा मशीन-पठनीय OpenAPI 3.1 स्पेक डेवलपर दस्तावेज़ के साथ प्रकाशित है, ताकि आप क्लाइंट जेनरेट कर सकें या इसे अपने टूल्स से जोड़ सकें।
संबंधित सुविधाएं
जानें कि Telm आपके समुदाय की और कैसे मदद कर सकता है