যে মুহূর্তে এটি ঘটে,
আপনার সার্ভার জানে
মডারেশন ইভেন্ট ঘটার মুহূর্তেই আপনার সার্ভারে পুশ করা হয়: স্প্যাম শনাক্তকরণ, ব্যান, জয়েন এবং আরও অনেক কিছু — প্রতিটি ডেলিভারি 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 কীভাবে আপনার কমিউনিটিকে সাহায্য করতে পারে তার আরও উপায় অন্বেষণ করুন