الدليل الكامل لـ BotFather

ما هو BotFather في تيليجرام؟

BotFather هو بوت رسمي تديره تيليجرام، باسم المستخدم @BotFather، وهو الطريقة الوحيدة لتسجيل بوت جديد. تتحدث إليه كما في أي محادثة أخرى: ترسل له أوامر، يطرح أسئلة، تجيب، ويحفظ النتيجة.

BotFather مجاني. إنشاء البوتات لا يكلف شيئاً، ولا توجد رسوم شهرية من تيليجرام، ولا توجد رسوم لكل رسالة مُرسلة، وهو الفرق الرئيسي في التكلفة مقارنة بواجهة WhatsApp Business API. يمكنك تسجيل عدة بوتات من حساب تيليجرام واحد.

قبل أن تضغط Start، تحقق من أن الحساب الذي فتحته يحمل علامة التوثيق الزرقاء واسم المستخدم الدقيق @BotFather. توجد حسابات مزيفة بأسماء مستخدمين مشابهة، وهدفها الوحيد هو جمع الرموز التي يلصقها الناس فيها.

كيف تنشئ بوتاً باستخدام BotFather؟

ترسل /newbot، تجيب عن سؤالين، وتنسخ الرمز. العملية كلها تستغرق نحو دقيقتين وتسير كالتالي:

1. افتح @BotFather. ابحث عن "BotFather" في تيليجرام، افتح الحساب الموثق، واضغط Start.
2. أرسل /newbot. يرد BotFather بطلب اسم بوتك الجديد.
3. أرسل الاسم المعروض. مثلاً "Sunrise Cafe". هذا ما يراه المستخدمون أعلى المحادثة. المسافات والأحرف الكبيرة والرموز التعبيرية مسموحة، ويمكنك تغييره لاحقاً بالأمر /setname.
4. أرسل اسم المستخدم. يجب أن يكون بين 5 و32 حرفاً، ويستخدم فقط حروفاً لاتينية وأرقاماً وشرطات سفلية، و يجب أن ينتهي بكلمة "bot": SunriseCafeBot وsunrise_cafe_bot كلاهما صالح، أما SunriseCafe فلا. أسماء المستخدمين فريدة في كل تيليجرام، فإذا كان اسمك مستخدماً يطلب منك BotFather ببساطة اسماً آخر.
5. انسخ الرمز. يهنئك BotFather ويطبع رمز API مثل 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw. انسخه في مكان آمن وتعامل معه كأنه كلمة مرور.
6. افتح بوتك واضغط Start. اضغط على رابط t.me في رد BotFather. البوت موجود، لكنه لن يرد على أي شيء بعد. هذا متوقع.
7. ألصق الرمز في أي شيء سيشغّل البوت. كود الخادم الخاص بك، أو أداة بناء بلا كود تعرّف فيها الأوامر والردود. يصبح البوت نشطاً بمجرد أن يبدأ شيء ما باستقبال التحديثات لهذا الرمز.

اختر اسم المستخدم بعناية. لدى BotFather أوامر لتغيير اسم البوت وصورته ووصفه، لكن لا يوجد أمر لتغيير اسم المستخدم، لذا فإن إعادة التسمية عملياً تعني إنشاء بوت جديد وتوجيه روابطك إليه.

إذا أردت المسار الكامل للمبتدئين مع لقطات شاشة لما يحدث بعد الرمز، راجع كيفية إنشاء بوت تيليجرام بدون برمجة.

ما هي جميع أوامر BotFather؟

هذه هي الأوامر المهمة لبناء البوت وتشغيله. إرسال /help إلى BotFather يطبع القائمة الحالية في أي وقت، و /mybots يعرض معظمها كأزرار بدلاً من ذلك.

لدى BotFather أوامر إضافية قليلة يمكنك تجاهلها بأمان في البداية، منها أوامر الألعاب (/newgame، /mygames، /listgames، /editgame، /deletegame)، وأوامر ضبط الوضع المضمّن (/setinlinegeo، /setinlinefeedback) و /setdomain، الذي يربط نطاق موقع بأداة Telegram Login Widget.

ما هو رمز بوت تيليجرام وكيف تحصل عليه مجدداً؟

رمز البوت هو بيانات الاعتماد الوحيدة التي تتيح للبرنامج التصرف كبوتك، ويمكنك رؤيته مجدداً في أي وقت بالأمر /token أو عبر /mybots ثم API Token. يبدو هكذا:

110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw

الأرقام قبل النقطتين هي المعرّف الرقمي العام للبوت. السلسلة بعد النقطتين هي السر. كل استدعاء لواجهة Bot API في تيليجرام هو مجرد طلب إلى https://api.telegram.org/bot<token>/methodName، لذا فإن أي شخص يملك السلسلة الكاملة يمكنه استدعاء أي طريقة كبوتك.

يمكن استخدام رمز واحد فقط من قِبل نظام واحد يعمل في كل مرة. يسمح تيليجرام بعنوان webhook واحد فقط لكل بوت، واستطلاع التحديثات بينما يكون webhook مضبوطاً يعيد خطأ 409 Conflict. إذا نقلت بوتاً من منصة إلى أخرى، افصل القديمة بدلاً من تشغيل الاثنتين معاً.

ماذا يحدث إذا تسرّب رمز بوتك، وكيف تلغيه؟

تعامل مع الرمز كأنه كلمة مرور: أي شخص يملكه يتحكم بالبوت بالكامل، والحل هو /revoke. لا يوجد وصول جزئي ولا وضع للقراءة فقط.

باستخدام رمز مسروق، يستطيع المهاجم:

• قراءة كل رسالة يرسلها المستخدمون إلى بوتك من تلك اللحظة، بما في ذلك أي شيء يُكتب في نماذجك
• إرسال وتعديل وحذف رسائل كبوتك إلى أي شخص بدأ محادثته معه بالفعل
• توجيه webhook إلى خادمه الخاص، بحيث تذهب حركة مرورك إليه بصمت بدلاً منك
• تغيير قائمة الأوامر والوصف والسلوك المضمّن عبر Bot API

من المفيد أيضاً معرفة ما لا يستطيع فعله. الرمز لا يمنح وصولاً إلى حسابك الشخصي في تيليجرام، ولا يستطيع حذف البوت (ذلك يتطلب حسابك داخل BotFather)، ولا يستطيع مراسلة أشخاص لم يبدأوا محادثة مع بوتك، وليس لدى Bot API أي طريقة لتنزيل قائمة بمستخدميك، لذا فإن قائمة مشتركيك ليست قابلة للتصدير ببساطة.

لتدوير رمز:

1. أرسل /revoke إلى BotFather
2. اختر البوت المتأثر من لوحة المفاتيح المعروضة
3. يبطل BotFather الرمز القديم فوراً ويرد بالرمز الجديد
4. ألصق الرمز الجديد في كل مكان كان يُحفظ فيه القديم، لأن البوت يبقى دون اتصال حتى تفعل ذلك

الوقاية هي في الأساس عادة واحدة: لا تضع الرمز أبداً في مكان عام. لا ترفعه إلى GitHub، ولا تلصقه في محادثة جماعية أو تذكرة دعم، واقصصه خارج لقطات الشاشة. تُفحص المستودعات العامة باستمرار بحثاً عن نمط الأرقام والنقطتين والحروف، وغالباً ما تُستغل الرموز المسربة خلال دقائق. المزيد من قواعد النظافة مثل هذه مجموعة في مقالنا عن أفضل ممارسات بوتات تيليجرام.

كيف تغيّر اسم بوت أو وصفه أو نص السيرة أو صورته؟

استخدم /setname و/setdescription و/setabouttext و /setuserpic، أو افتح /mybots، اختر البوت واختر Edit Bot للقيام بالأربعة من قائمة واحدة. كل أمر يسأل أولاً أي بوت تريد تعديله، ثم يطلب القيمة الجديدة.

حقلا النص يسهل الخلط بينهما. الوصف يصل حتى 512 حرفاً ويظهر على شاشة المحادثة الفارغة، فوق زر Start، فهو آخر ما يقرأه المستخدم قبل أن يقرر استخدام بوتك. نص السيرة يصل حتى 120 حرفاً ويظهر في صفحة ملف البوت وفي معاينات الروابط عندما يشاركه أحد.

التغييرات تسري فوراً، ولا يمس أي منها الرمز أو اسم المستخدم. إذا كان لديك مستخدمون بالفعل، فإعادة التسمية آمنة: تستمر محادثاتهم في العمل.

كيف تضبط قائمة الأوامر التي يراها المستخدمون؟

أرسل /setcommands، اختر بوتك، ثم أرسل القائمة كاملة في رسالة واحدة بأمر واحد لكل سطر بصيغة command - description، دون شرطة مائلة في البداية. على سبيل المثال:

start - تشغيل البوت وفتح القائمة الرئيسية
menu - عرض القائمة الحالية والأسعار
book - حجز طاولة
hours - ساعات العمل والعنوان
help - كيفية استخدام هذا البوت

قواعد تيليجرام لهذه القائمة: أسماء الأوامر تستخدم حروفاً لاتينية صغيرة وأرقاماً وشرطات سفلية، بطول من 1 إلى 32 حرفاً، وكل وصف بطول من 1 إلى 256 حرفاً. يمكن أن يحتوي البوت على حتى 100 أمر في القائمة. بعد الحفظ، تظهر القائمة عندما يكتب المستخدم "/" وخلف زر القائمة بجانب حقل الرسالة.

هناك أمر يخدع الجميع تقريباً: تسجيل أمر في BotFather يجعله ظاهراً فقط. لا يجعله يعمل. إذا أضفت /hours إلى القائمة لكن لا شيء في الطرف المستقبل يتعامل مع /hours، يضغط المستخدمون عليه ويحصلون على صمت، وهو أسوأ من عدم إدراجه أصلاً.

ما الذي لا يفعله BotFather؟

يسجّل BotFather البوت، ويضبط ملفه الشخصي، ويسلّمك رمزاً، وهذا كل عمله. يمنح بوتك سلوكاً صفرياً، ولهذا فإن بوتاً جديداً تماماً لا يرد أبداً على أي شيء، مهما طال انتظارك.

كل رسالة يرسلها مستخدم إلى بوتك تصبح تحديثاً على جانب تيليجرام. شيء ما يجب أن يستقبل تلك التحديثات، إما عبر webhook أو عبر polling، ويقرر ما يجب أن يكون الرد، ويستدعي Bot API لإرساله. لديك خياران واقعيان لذلك الشيء:

• كتابته واستضافته بنفسك. سكربت Python أو Node، خادم أو دالة serverless لتشغيله، نقطة نهاية HTTPS للـ webhook، إضافة إلى المراقبة وإعادة النشر إلى الأبد بعد ذلك.
• استخدام أداة بناء بلا كود. تلصق الرمز في المنصة، وتبني الأوامر والردود في محرر بصري، وهي تتولى استقبال التحديثات وإرسال الردود.

TeleMinute هو من النوع الثاني. تلصق رمز BotFather في app.teleminute.com وتحصل على بوتات تيليجرام غير محدودة، وأوامر وردود بالكلمات المفتاحية غير محدودة، وأزرار وقوائم مضمّنة، ونماذج عملاء محتملين مع تتبع الردود داخل التطبيق، وإشعارات فورية عند وصول رد جديد على نموذج، وبثوث لجميع مستخدمي بوتك مع الجدولة والتقسيم، وإحصاءات مفصلة وتقارير تسليم، وحتى 4 صور لكل أمر. تعمل البوتات عبر webhooks تيليجرام، فتبقى متصلة على مدار الساعة دون خادم تستأجره أو تبقيه مستيقظاً. هناك بوت تجريبي مجاني لمدة 15 دقيقة دون الحاجة لبطاقة، وإذا أردت مقارنة المجال أولاً، راجع مراجعتنا لـ أفضل أدوات بناء بوتات تيليجرام.

أياً كان الطريق الذي تختاره، تنطبق قاعدتان من تيليجرام على كل بوت ولا يمكن لأي منصة رفعهما. يمكن للبوت مراسلة من بدأ محادثته أولاً فقط، فلا يوجد تواصل بارد، والإرسال الجماعي محدود بنحو 30 رسالة في الثانية، لذا فإن البث لجمهور كبير يوضع في طابور ويستغرق وقتاً ليكتمل.

كيف تحذف بوت تيليجرام؟

أرسل /deletebot إلى BotFather، اختر البوت، وأكّد بإرسال الجملة الدقيقة التي يعرضها BotFather (حالياً "Yes, I am totally sure."). يمكنك فعل الشيء نفسه من /mybots ثم Delete Bot.

الحذف نهائي. يتوقف الرمز عن العمل، ويختفي البوت من حسابك، ويحذرك BotFather من أنه لا يمكن التراجع عن ذلك. لا تعامله كزر إيقاف مؤقت.

إذا أردت فقط أن يتوقف البوت عن الرد لفترة، ألغِ الرمز بالأمر /revoke أو افصله في المنصة التي تشغّله. كلاهما يستغرق ثوانٍ وقابل للتراجع.

أهم النقاط

• BotFather هو بوت تيليجرام الرسمي لإنشاء البوتات، عند @BotFather، وهو مجاني بلا أي رسوم لكل رسالة.
• أنشئ بوتاً بالأمر /newbot: اسم معروض، ثم اسم مستخدم من 5 إلى 32 حرفاً يجب أن ينتهي بـ "bot"، ثم الرمز.
• الرمز هو كلمة مرور. /token يعرضه مجدداً، و/revoke يستبدله فوراً إذا تسرب.
• يستطيع BotFather تغيير اسم البوت ووصفه ونص سيرته وصورته وقائمة أوامره وإعدادات مجموعته، لكن ليس اسم مستخدمه.
• لا يجعل BotFather البوت يرد أبداً. الكود الخاص بك المستضاف أو أداة مثل TeleMinute (3.99 دولار أسبوعياً، أو 9.99 دولار شهرياً، أو 49.99 دولار مرة واحدة) تقوم بذلك الجزء.

الخلاصة

BotFather صغير عمداً. إنه مكتب تسجيل: يصدر هوية ورمزاً، ويتركك تصقل الملف الشخصي، ويبقى بعيداً عن الطريق. تعلّم الأوامر الاثني عشر أعلاه ولن تحتاج للبحث عنها مجدداً أبداً.

العمل المثير للاهتمام يبدأ بعد الرمز. قرر بما يجب أن يرد بوتك، وصل الرمز بشيء يستطيع الرد، واختبر أول خمسة أسئلة سيطرحها مستخدموك الحقيقيون. هذا هو الفرق بين بوت مسجّل وبوت مفيد.