মডারেশনের শক্তি,
আপনার কোড থেকে কলযোগ্য
Telm-কে আপনার নিজের সিস্টেমে যুক্ত করুন: প্রোডাকশন অ্যান্টি-স্প্যাম ইঞ্জিন দিয়ে যেকোনো টেক্সট যাচাই করুন, কোড থেকে গ্রুপ সেটিংস ও নিয়ম পরিচালনা করুন, সিদ্ধান্তের জার্নাল ও অ্যানালিটিক্স পড়ুন — সবই একটি পরিচ্ছন্ন REST API-এর মাধ্যমে, আপনার নিয়ন্ত্রণে থাকা কী দিয়ে।
- স্থিতিশীল REST v1
- প্রতিটি প্ল্যানে স্প্যাম যাচাই
- webhooks অন্তর্ভুক্ত
৩০ সেকেন্ডে আপনার প্রথম কল
কোনো SDK আনুষ্ঠানিকতা নেই: আপনার কী দিয়ে একটি 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 গ্রুপগুলোকে সুরক্ষিত রাখে, ঠিক সেই ইঞ্জিনের ভেতর দিয়ে যেকোনো টেক্সট চালান — একক কল, ২০ পর্যন্ত ব্যাচ, এবং CAS ও Telm-এর নিজস্ব ডেটাসেটের বিপরীতে ইউজার যাচাই।
POST /spam/checkPOST /spam/check-batchPOST /users/checkগ্রুপ ও সেটিংস
সুরক্ষা সেটিংস পড়ুন ও প্যাচ করুন, কাস্টম মডারেশন নিয়ম এবং হোয়াইটলিস্ট পরিচালনা করুন — একটি গ্রুপের জন্য অথবা গোটা বহরের জন্য।
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 |
সীমা প্রযোজ্য হয় প্রতি অ্যাকাউন্টে, প্রতি কী-তে নয়। প্রতিটি রেসপন্স X-Quota-Limit, X-Quota-Used এবং X-Quota-Reset হেডার বহন করে, এবং সীমায় পৌঁছালে Retry-After সহ একটি পরিষ্কার 429 ফেরত আসে — কোনো চমক নেই।
যেমন হওয়া উচিত ঠিক তেমন কী
একবার দেখানো, হ্যাশ করে সংরক্ষিত
সম্পূর্ণ কী ঠিক একবারই দেখা যায়, তৈরির সময়। Telm শুধু একটি হ্যাশ সংরক্ষণ করে — আমরা সহ কেউই আপনার কী আবার পড়তে পারে না।
Read/write স্কোপ
কী read এবং write স্কোপ বহন করে। আপনার রিপোর্টিং স্ক্রিপ্টকে একটি read-only কী দিন — এটি প্রযুক্তিগতভাবেই কোনো সেটিংস পরিবর্তন করতে পারবে না।
তাৎক্ষণিক প্রত্যাহার
ড্যাশবোর্ড থেকে যেকোনো কী প্রত্যাহার করুন এবং তা সঙ্গে সঙ্গে কাজ করা বন্ধ করে দেয়। একটি প্রতি-অ্যাকাউন্ট কিল সুইচ একবারে সমস্ত API অ্যাক্সেস স্তব্ধ করে দিতে পারে।
সম্পূর্ণ API এবং webhooks Pro এবং Business-এ অন্তর্ভুক্ত। স্প্যাম যাচাই প্রতিটি প্ল্যানে উপলব্ধ — Free সহ — দৈনিক কোটার মধ্যে।
সেই একই ইঞ্জিন, এখন আপনার নিয়ন্ত্রণে
পাবলিক API সেই একই মডারেশন ইঞ্জিন উন্মুক্ত করে যা Telm-এর বট চালায় — কোনো সরলীকৃত নকল নয়। /spam/check-এ একটি টেক্সট POST করুন এবং তা আপনার গ্রুপগুলো যে অভিন্ন পাইপলাইন ব্যবহার করে তার ভেতর দিয়েই যায়: রেপুটেশন সিগন্যাল, নিয়ম এবং ঐচ্ছিকভাবে AI ক্লাসিফায়ার। এর মানে আপনি Telm-এর বিচারকে যেকোনো জায়গায় বসাতে পারেন: একটি সাপোর্ট ফর্ম, আপনার নিজের বট, একটি কমেন্ট সেকশন, একটি অভ্যন্তরীণ টুল।
যাচাইয়ের বাইরেও, API আপনার গ্রুপগুলোকে কোড হিসেবে পরিচালনা করে। সুরক্ষা সেটিংস পড়ুন ও প্যাচ করুন, মডারেশন নিয়ম তৈরি করুন, হোয়াইটলিস্ট বজায় রাখুন — ড্যাশবোর্ডের মতোই একই কাজ, কিন্তু স্ক্রিপ্ট করার উপযোগী। কয়েক ডজন কমিউনিটি চালানো এজেন্সিগুলো কয়েক ডজন ক্লিকের বদলে একটিমাত্র লুপে পলিসি পরিবর্তন রোল আউট করতে পারে।
ইতিহাস এখানে প্রথম শ্রেণির নাগরিক: জার্নাল এন্ডপয়েন্ট ইঞ্জিনের নেওয়া প্রতিটি সিদ্ধান্ত ফেরত দেয় — রায়, স্কোর, কোন নিয়মগুলো সক্রিয় হয়েছে, কী পদক্ষেপ নেওয়া হয়েছে — আর্কাইভিংয়ের জন্য তৈরি কার্সর পেজিনেশন সহ। অ্যানালিটিক্স এন্ডপয়েন্টের সঙ্গে মিলিয়ে আপনি আপনার গ্রুপের প্রকৃত ডেটার উপর কমপ্লায়েন্স আর্কাইভ, অভ্যন্তরীণ ড্যাশবোর্ড বা অ্যালার্টিং তৈরি করতে পারেন।
অথেন্টিকেশন ইচ্ছাকৃতভাবেই নিরুত্তেজ: আপনার ড্যাশবোর্ডে তৈরি bearer কী, একবারই দেখানো হয়, হ্যাশ করে সংরক্ষণ করা হয়, 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 কী কীভাবে পাব?
ড্যাশবোর্ডে সেটিংস → API ও Webhooks-এ। কী শুধু তৈরির সময় একবারই দেখানো হয় — সংরক্ষিত থাকে কেবল এর হ্যাশ। আপনি সর্বোচ্চ 10টি সক্রিয় কী রাখতে পারেন, সেগুলোকে 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 কীভাবে আপনার কমিউনিটিকে সাহায্য করতে পারে তার আরও উপায় অন্বেষণ করুন