سبعة أحداث، مباشرةً من المحرّك
اشترك لكل نقطة في الأحداث التي تحتاجها تماماً — من أحكام الرسائل المزعجة إلى تغيّرات العضوية.
spam.detectedmessage.suspicioususer.banneduser.kickeduser.muteduser.joineduser.leftيُشحن كل حدث في مغلّف JSON مضغوط: id وtype وcreated_at وgroup_id وبيانات الحدث — ويبقى id ثابتاً عبر إعادات المحاولة، فتكون إزالة التكرار عملية بحث واحدة في مجموعة.
جدول إعادة المحاولة، تماماً كما يعمل
ست محاولات على مدى نحو ثماني ساعات — تكفي لتجاوز عملية نشر، أو إعادة تشغيل، أو انقطاع كامل في جانبك.
0فوري+1m+5m+30m+2h+6hالمحاولة الأخيرةتسليم يمكنك البناء عليه
تسليم مرّة واحدة على الأقل
يُسلَّم كل حدث مرّةً واحدةً على الأقل. تؤكّد نقطتك بأي استجابة 2xx — وأي شيء غير ذلك يعود إلى طابور إعادة المحاولة.
مُعرّفات ثابتة لإزالة التكرار
لكل حدث id ثابت ينجو من إعادات المحاولة. وإزالة التكرار في جانبك عملية بحث واحدة، لا استدلال تخميني.
لا نقاط ميتة
النقطة التي تُخفق أياماً تُعطَّل تلقائياً — وتصلك رسالة Telegram مباشرة بدلاً من فجوة صامتة في بياناتك.
رسالة اختبار
حدث اختبار بنقرة واحدة، موقّع كالحقيقي تماماً — تحقّق من مُعالِجك قبل أن يعتمد عليه حدث حقيقي واحد.
سجلّ قابل للفحص
سجلّ تسليم كامل لكل نقطة: كل محاولة وحالة وطابع زمني — فتنقيح المستقبِل لديك لا يتضمّن تخميناً أبداً.
HTTPS فقط، وموقّع دائماً
يجب أن تكون النقاط عناوين HTTPS عمومية، وكل حمولة موقّعة. فالنقل والمُنشِئ كلاهما مغطّى.
تحقّق من كل عملية تسليم
ثلاثة أسطر في جانبك — ولا يستطيع أحد تزوير حدث أو إعادة تشغيله.
# 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 ثابت لإزالة التكرار؛ وتُعيد الإخفاقات المحاولة على جدول متصاعد — فوراً، ثم بعد دقيقة و5 دقائق، و30 دقيقة، وساعتين و6 ساعات. والنقطة التي تظلّ تُخفق أياماً تُعطَّل تلقائياً، وتصلك رسالة Telegram بذلك بدلاً من فجوة صامتة.
وكل شيء قابل للفحص: أرسِل رسالة اختبار قبل الانطلاق، وتصفّح سجلّ التسليم — محاولةً بمحاولة، وحالةً بحالة — متى احتجت إلى تنقيح جانبك من الأنبوب.
الأسئلة الشائعة
كيف أتحقّق من أن الحدث جاء فعلاً من Telm؟
تحمل كل عملية تسليم ترويسة X-Telm-Signature: قيمة HMAC-SHA256 لـ «timestamp.body» محسوبةً بسرّ نقطتك. أعِد حسابها في جانبك، وقارنها في زمن ثابت، وارفض أي شيء أقدم من بضع دقائق لاستبعاد إعادة التشغيل (replay).
ماذا يحدث إن كان خادمي متعطّلاً عند إطلاق حدث؟
يُعيد Telm المحاولة على جدول متصاعد — فوراً، ثم بعد دقيقة واحدة، و5 دقائق، و30 دقيقة، وساعتين و6 ساعات. وأي استجابة 2xx تُحتسَب تسليماً. وتحمل الأحداث id ثابتاً، فلا تتحوّل إعادة المحاولة أبداً إلى تكرار في نظامك.
هل يمكن لنقطة معطوبة أن تُغرق للأبد؟
لا. النقطة التي تُخفق نحو عشرين مرّةً متتالية دون نجاح لثلاثة أيام تُعطَّل تلقائياً، وتصلك إشعار Telegram. أصلِح جانبك وأعِد تفعيلها بنقرة واحدة.
كيف أختبر تكاملي قبل الانطلاق؟
أرسِل رسالة اختبار إلى أي نقطة مباشرةً من لوحة التحكّم أو من API — تصل موقّعةً تماماً كحدث حقيقي. ويعرض سجلّ التسليم كل محاولة مع حالتها.
أي الخطط تشمل Webhooks؟
Webhooks جزء من حزمة API الكاملة، مضمّنة في خطتَي Pro وBusiness.
أين تستخدم الفرق هذا
أنواع مجتمعات حقيقية تؤدّي فيها هذه الميزة العبء الأكبر.
احفظ قنوات الدعم خالية من الرسائل المزعجة مع السماح للمستخدمين الجدد بطرح الأسئلة. يجعل وضع الدعم عملية الانضمام سهلة.
إدارة احترافية لمجموعات الشركات ومجتمعات العملاء. حماية قوية مع سجلات تدقيق مفصّلة.
احمِ قاعدة معجبيك من المحتالين الذين يتظاهرون بأنهم أنت. أنشئ مساحة آمنة لمجتمعك للتواصل.
ميزات ذات صلة
اكتشف المزيد من الطرق التي يمكن لـ Telm مساعدة مجتمعك بها