المشاريع والقنوات
أنشئ مشروعًا، واربط البوت، وتابع حالته. قنوات متعددة، وتغيير الرمز المميز، والإيقاف المؤقت، واستعادة البوت بعد تجميده بسبب الباقة.
في هذه الصفحة
يجمع المشروع إعدادات بوتك أو خدمتك وتفاعلاته وبياناته. أما القناة فتربطه بمكان محدد للتواصل، مثل بوت Telegram أو دردشة موقعك أو تطبيق مراسلة آخر. يمكن لمدرسة، مثلًا، استخدام مشروع واحد بقناتين: Telegram والموقع.
أنشئ المشروع من المشاريع، ثم أضف قناة. للربط مع Telegram، ستحتاج إلى رمز @BotFather المميز الذي يتيح إدارة البوت. يمكنك التنقل بين المشاريع من أعلى لوحة التحكم.
لا يقتصر البوت على Telegram. يمكنك ربط WhatsApp وVK بالمشروع نفسه، واستخدام التفاعلات ذاتها في التطبيقات الثلاثة. راجع القنوات وإعداد WhatsApp.
ربط البوت
- إذا لم يكن لديك مشروع، فافتح المشاريع واضغط إضافة مشروع. في بطاقته اضغط إضافة قناة واختر Telegram. ويمكنك استخدام معالج الإعداد عند إنشاء بوتك الأول.
- الصق الرمز من @BotFather واضغط تحقّق. سيعرض GetMyBot اسم
@usernameالذي عثر عليه لتتأكد من صحة البوت. - اضغط ربط. يُحفظ الرمز مشفّرًا، ويبدأ استقبال الأحداث فورًا.
ستظهر قناة Telegram في بطاقة المشروع إلى جانب القنوات الأخرى. تعرض البطاقة اسم المشروع، و@username الخاص بالبوت، وعدد المستخدمين، والتفاعلات النشطة، وطلبات اليوم. راجع رصيد الطلبات في الفوترة أو الإحصائيات.
إدارة عدة بوتات
يمكن للحساب الواحد إدارة مشاريع وبوتات متعددة، حتى الحد المحدد في الباقة («الحد الأقصى للبوتات»). بدّل المشروع من المحدّد بالأعلى أو من المشاريع. تعرض التفاعلات والمحادثات والإحصائيات بيانات المشروع المحدد فقط.
كيف يستقبل البوت الرسائل؟
بعد الربط، يتلقى GetMyBot أحداث Telegram تلقائيًا: الرسائل، والضغط على الأزرار، والانضمام إلى الدردشات، والمدفوعات. لا تحتاج إلى إعداد مستقل للاستقبال ما دام الرمز صالحًا. بحسب إعداد الخادم، يرسل Telegram الأحداث إلى عنوان المنصة عبر webhook، أو تطلبها المنصة دوريًا من Telegram عبر long polling.
تشغيل البوت وإيقافه
لكل بوت حالة تشغيل أو إيقاف تغيّرها من بطاقة حالة البوت في الإعدادات. لا يردّ البوت المتوقف على الرسائل. يسري التغيير فورًا بلا حاجة إلى إعادة الربط.
حالة المشروع وتوفّر القناة
تعرض قائمة المشاريع حالة المشروع: نشط أو متوقف مؤقتًا أو مجمّد. هذه ليست نتيجة فحص توصيل رسائل Telegram. ولكل قناة حالة مستقلة: متصل أو لا توجد إشارة أو مُعدّ أو معطل أو المشروع غير نشط. لذلك لا يظهر مشروع نشط يضم دردشة ويب بلا Telegram كما لو كان متوقفًا.
إذا كان للمشروع النشط قناة Telegram واحدة مشغّلة، فتعني متصل أن عملية الخدمة أرسلت إشارة حديثة؛ وإذا غابت تظهر لا توجد إشارة. عند وجود عدة قنوات Telegram مشغّلة، تظهر مُعدّ لأن إشارة المشروع المشتركة لا تثبت حالة كل قناة على حدة. وفي القنوات المشغّلة على المنصات الأخرى، تعني مُعدّ أن القناة مربوطة، لا أن كل رسالة قد سُلّمت.
تعمل المنصة بعدة عمليات خدمة متكافئة. ترسل كل عملية إشارة للبوت الذي تخدمه كل 30 ثانية. تبقى الإشارة حديثة لمدة دقيقة ونصف؛ لذا لا تغيّر إشارة واحدة فائتة الحالة فورًا.
عمليًا:
- قد يتأخر ظهور الحالة. بعد الربط أو إعادة تشغيل المنصة، قد لا تظهر متصل إلا ضمن مدة التحقق هذه.
- إذا استمرت لا توجد إشارة لأكثر من دقيقتين في قناة Telegram مشغّلة، فتحقق من الرمز المميز وبطاقة Bot health في الإعدادات. يظل المشروع نشطًا ما لم توقفه أنت مؤقتًا أو تجمّده المنصة بسبب الباقة.
- الإشارة مشتركة بين عمليات الخدمة ولا تعتمد على الخادم الذي ردّ على طلبك. ومع عدة قنوات Telegram، لا تثبت توفّر كل واحدة منفردة.
ماذا يحدث عندما يصبح البوت غير متصل؟
تفحص المنصة إشارات الخدمة مرة كل دقيقة. إذا لم تجد إشارة حديثة لبوت مشغّل، تفتح حادثة، وتحدد سببها مرة واحدة، ثم تحاول استعادة عمل البوت تلقائيًا.
تعرض بطاقة Bot health في الإعدادات أربعة أسباب محتملة:
- Webhook: لا تصل تحديثات Telegram إلى عنوان المنصة؛ تعيد المنصة تسجيل العنوان.
- رمز ملغى: يعيد
getMeالرمز 401. لا تصلح إعادة التشغيل هذه الحالة؛ أنشئ رمزًا جديدًا في @BotFather وأدخله عبر تغيير الرمز المميز. - لا يوجد خادم خدمة: لا تعالج أي عملية التحديثات، فتُعيد المنصة تشغيل البوت.
- سبب غير معروف: لم يردّ Telegram على طلب الفحص.
تؤدي إعادة التشغيل عمل زر مزامنة نفسه: تفحص الرمز عبر getMe ثم تعيد تسجيل webhook. تتباعد المحاولات تدريجيًا. يسجل Restart log وقت كل محاولة ونتيجتها ورسالة الخطأ إن وجدت، وتظهر كذلك المحاولة التالية في البطاقة.
إذا ظل البوت صامتًا أطول من الحد الموجود في Bot health (5 دقائق افتراضيًا)، يتلقى المالك إشعار «Бот офлайн» («البوت غير متصل») عبر جرس التطبيق والبريد الإلكتروني. ويرسل البوت رسالة أيضًا إلى المحادثات المحددة لتلقي التنبيهات. يصدر تنبيه واحد لكل حادثة. وعندما تعود الإشارات، يوضح إشعار «Бот снова онлайн» («عاد البوت للاتصال») مدة الانقطاع. تبقى الحوادث السابقة ومددها وأسبابها في البطاقة نفسها.
التجميد بسبب الباقة
إلى جانب التشغيل والإيقاف، قد يكون البوت مجمّدًا. لا يجمّده المستخدم؛ بل المنصة عندما لا تكفي الباقة السارية لعدد البوتات المربوطة. ويوجد سببان فقط:
- تجاوز الحد الأقصى للبوتات: انتقلت إلى باقة تسمح ببوتات أقل من العدد المربوط حاليًا.
- عدم تجديد الاشتراك: انتهت الباقة المدفوعة، وأصبح حد الباقة المجانية ساريًا.
لا يستقبل البوت المجمّد الرسائل؛ يتوقف استقبال التحديثات عنه فعليًا. تبقى بياناته وتفاعلاته ومشتركوه محفوظين، ويمكن إلغاء التجميد.
لاستعادته، اشترِ باقة تكفي لعدد البوتات المطلوب. عند تفعيل الباقة المدفوعة، تعود البوتات تلقائيًا بدءًا بالأقدم حتى يمتلئ حد الباقة الجديدة. لا يمكنك اختيار أي بوت يعود أولًا. إذا أردت بوتًا آخر، فاحذف الاتصالات غير اللازمة قبل شراء الباقة.
تجميد الحساب كله حالة مستقلة: تتوقف عندها جميع البوتات والرسائل الجماعية، ويظهر تنبيه «الحساب مجمّد» في لوحة التحكم. لا تُرفع هذه الحالة إلا عبر الدعم. راجع المدفوعات والرصيد.
الملف الشخصي والمزامنة
زر مزامنة في الإعدادات يحدّث اسم البوت من Telegram إذا غيّرته في @BotFather. تُجلب صورة ملف البوت الشخصي تلقائيًا.
تغيير الرمز المميز
إذا أعدت إصدار الرمز في @BotFather (Bot Settings ← Revoke / New token)، حدّثه في الإعدادات ← القنوات ← Telegram 🔑. يجب أن ينتمي الرمز الجديد إلى نفس البوت (بنفس المعرف الداخلي في Telegram) — لضمان الحفاظ على جميع التفاعلات والمشتركين والبيانات. إذا لم تظهر قناة Telegram، فاختر «تغيير الرمز المميز» في النافذة نفسها.
نقل المشروع إلى حساب آخر
من الإعدادات → تغيير المالك، أرسل دعوة لنقل المشروع إلى حساب GetMyBot آخر عبر البريد الإلكتروني. تبقى الدعوة صالحة 72 ساعة. إلى أن يقبلها المستلم، يظل المشروع لديك ويمكنك إلغاء النقل. عند قبول الدعوة يتغير المالك وتفقد أنت الوصول إلى المشروع. استخدم النقل عند تسليم مشروع إلى عميل أو زميل.
قوالب البوتات
القالب نسخة محفوظة من إعدادات المشروع وجميع تفاعلاته يمكن تطبيقها على مشروع آخر:
- إنشاء قالب في الإعدادات يحفظ المشروع الحالي باسم تختاره.
- تطبيق قالب يستبدل إعدادات المشروع المحدد بإعدادات القالب، ويضيف تفاعلات القالب إلى التفاعلات الموجودة.
استخدم القوالب لتكرار إعداد مشروع نموذجي.
تثبيت حل جاهز من الكتالوج
يستخدم كتالوج الحلول الجاهزة معالج إعداد. أدخل المعلمات، وتحقق من التوافق والاتصالات المطلوبة، ثم راجع الموارد التي سيُنشئها. بعد التثبيت أكمل الخطوات المتبقية وجرّب السيناريو بطلب اختباري.
يختلف هذا المعالج عن تطبيق قالب البوت المذكور أعلاه. يكشف الفحص السابق للتثبيت المعلمات أو الإمكانات الناقصة؛ وضع علامة على خطوة مكتملة لا يثبت أن الخدمة الخارجية تعمل بالفعل.
قياس نتائج الحل الجاهز
اختر الفترة التي تريد تقييم عمل الحل المثبّت خلالها. للمقارنة، اختر وضعًا متاحًا وراجع حجم العينة ومعلومات التشخيص. نقص البيانات أو عدم توفر مقارنة يختلف عن نتيجة تساوي صفرًا.
الخطوات التالية
- الإعدادات والفريق والصلاحيات: إعدادات السلوك والأدوار والقوالب ورموز API.
- أساسيات التفاعلات: إعداد سلوك البوت.
- الاستيراد من sambot: نقل بوت موجود.
- المدفوعات والرصيد: الباقات والحد الأقصى للبوتات.