تيليجرام — المنصة الأكثر شعبية للبوتات

تيليجرام — المنصة الأكثر شعبية للبوتات

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

بمجرد ربط Hermes بـ تيليجرام، ستحصل على بوت محادثة كامل الميزات يمكنك الدردشة معه من أي مكان. أرسل مذكرة صوتية وسيتم تفريغها تلقائيًا. اطلب تقريرًا مجدولًا وسيصل مباشرة إلى محادثتك. يمكنك حتى إضافة البوت إلى المحادثات الجماعية وجعله ينضم إلى النقاش. يتعامل مع النصوص والصوت والصور والمرفقات — كل ذلك عبر مكتبة python-telegram-bot الموثوقة.

دعنا نستعرض خطوات الإعداد، خطوة بخطوة.

الخطوة 1: إنشاء بوتك مع BotFather

كل بوت تيليجرام يبدأ برمز API من @BotFather، مدير البوتات الرسمي في تيليجرام. إليك كيفية الحصول عليه:

1. افتح تيليجرام وابحث عن @BotFather، أو انتقل إلى t.me/BotFather
2. أرسل /newbot
3. اختر اسمًا ظاهرًا — أي اسم يعجبك، مثل “Hermes Agent”
4. اختر اسم مستخدم — يجب أن يكون فريدًا وينتهي بـ bot (مثل: my_hermes_bot)
5. سيرد BotFather برمز API token الخاص بك، والذي يبدو هكذا:

123456789:ABCdefGHIjklMNOpqrSTUvwxYZ

حافظ على سرية رمزك! أي شخص يمتلك هذا الرمز يمكنه التحكم في بوتك. إذا تسرب لأي سبب، قم بإبطاله فورًا باستخدام /revoke في BotFather.

الخطوة 2: تخصيص بوتك (اختياري لكنه يستحق العناء)

بعض أوامر BotFather السريعة يمكن أن تجعل بوتك يبدو مصقولًا واحترافيًا:

الأمر	الغرض
/setdescription	نص “ماذا يمكن أن يفعل هذا البوت؟” الذي يظهر قبل أن يبدأ شخص ما المحادثة
/setabouttext	نص قصير على صفحة ملف البوت
/setuserpic	رفع صورة رمزية لبوتك
/setcommands	تحديد قائمة الأوامر (زر / في المحادثة)
/setprivacy	التحكم في ما إذا كان البوت يرى جميع رسائل المجموعة (انظر الخطوة 3)

لـ /setcommands، مجموعة بداية مفيدة هي:

help - عرض معلومات المساعدة
new - بدء محادثة جديدة
sethome - تعيين هذه المحادثة كقناة رئيسية

مؤشر الحالة متصل/غير متصل (اختياري)

بوتات تيليجرام لا تملك نقطة “متصل” الخضراء مثل حسابات المستخدمين. أقرب شيء لذلك هو الوصف القصير للبوت — السطر الموجود تحت اسمه في صفحة الملف الشخصي.

فعّل status_indicator وسيقوم Hermes بتعيين هذا الوصف إلى متصل عندما تتصل البوابة وغير متصل عند الإغلاق النظيف:

gateway:
  platforms:
    telegram:
      extra:
        status_indicator: true
        status_online: "🟢 متصل"
        status_offline: "🔴 غير متصل"

ملاحظتان: هذا الوصف عام (مرئي لجميع المستخدمين)، وفقط الإغلاق النظيف يكتب “غير متصل” — بينما الانهيار المفاجئ يترك الحالة الأخيرة. وهو معطل افتراضيًا لأنه يغير ملف تعريف بوتك.

أولوية قائمة الأوامر وسقفها (اختياري)

يقوم Hermes تلقائيًا بتسجيل قائمة أوامره عند بدء تشغيل بوابة تيليجرام. افتراضيًا، يحدها بـ 60 أمرًا — وهو ما يكفي لجميع الأوامر المدمجة بالإضافة إلى المهارات الشائعة. إذا كان لديك أوامر إضافية يجب أن تبقى ظاهرة في منتقي /، يمكنك منحها الأولوية:

platforms:
  telegram:
    extra:
      command_menu:
        max_commands: 60
        priority_mode: prepend  # prepend | append | replace
        priority:
          - my_plugin_command

• prepend: أوامرك أولاً، ثم أوامر Hermes الافتراضية
• append: أوامر Hermes الافتراضية أولاً، ثم أوامرك
• replace: استخدم قائمتك فقط لترتيب الأولوية

يسمح تيليجرام بما يصل إلى 100 أمر، لكن الحمولات الكبيرة قد تفشل. يحدد Hermes الافتراضي على 60 للاعتمادية ويضبط القيم على 1..100.

الخطوة 3: وضع الخصوصية — أمر حاسم للمجموعات

إليك المصدر الأول للالتباس عند استخدام البوتات في المجموعات: وضع الخصوصية مفعّل افتراضيًا.

مع تفعيل وضع الخصوصية، يرى بوتك فقط:

• الرسائل التي تبدأ بـ /
• الردود على رسائل البوت نفسه
• الرسائل الخدمية (الانضمام، المغادرة، التثبيت)
• الرسائل في القنوات التي يكون فيها البوت مشرفًا

مع تعطيل وضع الخصوصية، يرى البوت كل رسالة في المجموعة.

لتعطيله:

1. راسل @BotFather
2. أرسل /mybots
3. اختر بوتك
4. انتقل إلى Bot Settings ← Group Privacy ← Turn off

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

بديل: قم بترقية البوت إلى مشرف مجموعة. بوتات المشرفين تستقبل دائمًا جميع الرسائل، دون الحاجة لتبديل الخصوصية.

مراقبة دردشة المجموعة دون رد تلقائي

تريد أن يرى بوتك رسائل المجموعة لكن يرد فقط عند ذكره؟ قم بإعداده هكذا:

telegram:
  allowed_chats:
    - "-1001234567890"
  group_allowed_chats:
    - "-1001234567890"
  require_mention: true
  observe_unmentioned_group_messages: true

الرسائل غير المذكورة من المحادثات المسموح بها تُضاف إلى سجل الجلسة كسياق ملاحظ — لكنها لا تُفعّل الوكيل. فقط ذكر لاحق بـ @botname يقوم فعليًا بإرسال استجابة.

---

هذا كل شيء! بهذه الخطوات الثلاث، لديك بوت تيليجرام كامل الوظائف مدعوم بـ Hermes Agent. انطلق — أرسل له مذكرة صوتية، ضعه في مجموعة، وشاهده يقوم بسحره.