يمكن لبوت Telegram الإجابة عن الأسئلة وتنفيذ الأوامر وربط المحادثة بخدمات أخرى. تبدأ عملية إنشائه باستخدام BotFather، لكن إعداد الردود يتطلب سير عمل بلا برمجة أو برنامجًا يعالج الرسائل.
يشرح هذا الدليل كيفية إنشاء بوت على Telegram في 2026: تسجيل حساب، والحصول على رمز، وإعداد الردود من دون كتابة كود أو باستخدام Python، وحل أخطاء الإعداد الشائعة. سنبدأ بـ BotFather، ثم نشرح طريقتين لإنشاء بوت يعمل بالفعل.
باختصار
الحساب الرسمي @BotFather واحتفظ برمز الوصول الخاص به في مكان آمن.
يتيح لك سير العمل بلا برمجة إعداد ردود بسيطة، بينما تمنحك Python تحكمًا أكبر في المنطق المخصص.
ينشئ BotFather الحساب، لكن إرسال الردود يتطلب سير عمل أو برنامجًا قيد التشغيل.
اختبر /start و/help ورسالة نصية في محادثة خاصة قبل إطلاق البوت.
ما هو بوت Telegram؟
بوت Telegram هو تطبيق يتفاعل معه المستخدمون عبر حساب على Telegram مُخصّص للأتمتة. ويمكنه الإجابة عن الأسئلة وتنفيذ الأوامر أو ربط المحادثة بخدمة أخرى، كما يوضح الدليل التعريفي بالبوتات من Telegram.
ابدأ بمهمة واحدة. يمكن لبوت المساعدة عرض تعليمات /start و/help. أما بوت الصدى فيكرر الرسالة: أرسل Hello، وسيصلك Hello. هذا يكفي لاختبار الاتصال قبل إضافة مزيد من الوظائف.
البوت ليس روبوت محادثة يعمل بالذكاء الاصطناعي تلقائيًا. فالرد الثابت لا يحتاج إلا إلى قاعدة، أما الردود المدعومة بالذكاء الاصطناعي فتتطلب ربطًا منفصلًا بنموذج. وMini App هي واجهة ويب تُفتح داخل Telegram، ويتطلب إنشاؤها تنفيذًا مختلفًا عن بوت المحادثة النصية الذي نبنيه هنا.
وتُعدّ البوتات أيضًا جزءًا من منظومة الإعلانات في Telegram: مثلًا، منصة إعلانية على Telegram مثل AdsGram تدير حملات إعلانية في القنوات والبوتات وMini Apps.
كيفية إنشاء بوت على Telegram
أنشئ الحساب باستخدام BotFather، ثم اختر سير عمل بلا برمجة أو Python لإعداد وظائفه. BotFather هو خطوة التسجيل المطلوبة في كلتا الطريقتين، وليس طريقة ثالثة لبناء منطق المحادثة.
الطريقة | ما الذي تضبطه | أفضل نقطة للبدء | ما الذي تتولى صيانته |
|---|---|---|---|
BotFather | الحساب والملف الشخصي ورمز الوصول | التسجيل المطلوب | ملكية الحساب وإعداداته |
بلا برمجة | المحفزات والشروط والردود | محادثة قصيرة يمكن توقّع مسارها | سير العمل وبيانات الاعتماد وتوفّر الخدمة |
Python | معالجات الرسائل ومنطق التطبيق | قواعد مخصصة أو عمليات تكامل | الكود والاعتماديات وبيئة التشغيل |
قبل اختيار أداة لإنشاء بوت على Telegram، ارسم مخططًا لمحادثة واحدة: رسالة واردة ← شرط ← رد. تأكد من أن الأداة تدعم أنواع الرسائل المطلوبة والتفرّع وتخزين البيانات. وإذا كانت المحادثة تتضمن استثناءات كثيرة، فقارن الوقت والجهد اللازمين لتعديل القواعد في محرر مرئي وفي الكود.

سجّل البوت باستخدام BotFather
افتح الحساب الرسمي @BotFather، وأرسل /newbot واتبع التعليمات لاختيار اسم العرض واسم المستخدم. وتشرح Telegram خطوات التسجيل هذه في الدليل الأول لإنشاء بوت.
- افتح BotFather عبر الرابط المباشر أعلاه، ثم اضغط على Start.
- أرسل
/newbot. - أدخل اسم العرض، مثل
Workshop Help. - اختر اسم مستخدم متاحًا ينتهي بـ bot، مثل
workshop_help_demo_bot. - احفظ رمز الوصول في مدير كلمات مرور أو في مخزن للأسرار.
- افتح رابط البوت للتأكد من إمكانية الوصول إلى محادثته.
اسم المستخدم في المثال للتوضيح فقط، ولا نضمن توفره. استخدم أحرفًا لاتينية وأرقامًا وشرطات سفلية، والتزم بمتطلبات اسم المستخدم الموضحة في BotFather.
يُستخدم رمز الوصول لمصادقة البوت لدى Bot API. ويمكن لأي شخص يحصل عليه التحكم بالبوت، لذا لا تنشره في لقطات الشاشة أو المستودعات أو المستندات المشتركة. إذا كان لديك بوت بالفعل، فافتح خيارات إدارته في BotFather للحصول على الرمز أو استبداله. وإذا تسرّب، فألغِه وحدّث التطبيق المرتبط باستخدام الرمز الجديد.

أوامر BotFather المفيدة
هذه أوامر شائعة للإعداد، وليست قائمة شاملة. راجع دليل BotFather من Telegram وقائمة BotFather الحالية للاطلاع على الإعدادات المتاحة.
الأمر | الغرض |
|---|---|
| تسجيل بوت |
| إدارة البوتات |
| تعديل الاسم الظاهر |
| توضيح وظيفة البوت |
| تعديل النبذة المختصرة للملف الشخصي |
| تعيين صورة الملف الشخصي |
| إعداد قائمة الأوامر |
| إنشاء رمز مصادقة |
أضف فقط الأوامر التي يتعامل معها تطبيقك فعليًا. ظهور الأمر في القائمة لا يعني أن له استجابة جاهزة؛ فما زال /help بحاجة إلى قاعدة سير عمل أو معالج برمجي.
إنشاء بوت بلا برمجة
لإنشاء بوت على Telegram بلا برمجة، اربط رمزه بسير عمل مرئي وحدد كيفية تحويل الرسائل الواردة إلى ردود. إليك مثالًا بسيطًا باستخدام n8n؛ وهي أداة أتمتة تابعة لجهة خارجية وليست خدمة تابعة لـ Telegram.
ابدأ بنسخة n8n يمكنها استقبال أحداث Telegram. ويتطلب الاستضافة الذاتية أيضًا إعداد الخادم، لذا فإن «بلا برمجة» لا تعني «بلا إعداد». ولا تفترض أن الخطة المستضافة أو التشغيل المستمر مجانيان.
- أنشئ سير عمل جديدًا وأضف Telegram Trigger.
- أنشئ بيانات اعتماد Telegram وأدخل رمز BotFather في حقل Access Token، باتباع وثائق بيانات الاعتماد.
- اختر حدث Message في Telegram Trigger.
- اربط إجراء Telegram وحدد المورد Message والعملية Send Message.
- عيّن Chat ID إلى معرّف محادثة الرسالة الواردة، باستخدام التعبير
{{ $json.message.chat.id }}إذا كان الإجراء يتبع المشغّل مباشرةً. - عيّن Text إلى
Hello! Your bot is connected.وتشرح وثائق إجراء Telegramالعمليات المدعومة. - شغّل مستمعًا للاختبار، ثم أرسل رسالة خاصة جديدة إلى البوت.
- تحقق من الرد، ثم انشر سير العمل أو فعّله لمواصلة استخدامه.
يرد هذا الإعداد عمدًا بالجملة نفسها على كل رسالة. بعد ذلك، أضف شرطًا يوجّه /start إلى رسالة ترحيب و/help إلى التعليمات. وحدد الرد على الرسائل غير المعروفة بدلًا من ترك المستخدم ينتظر.
تحتاج Telegram، عند استخدام n8n المستضاف ذاتيًا، إلى عنوان webhook عام يعمل عبر HTTPS. وقد يؤدي الاختبار والإنتاج إلى استبدال تسجيل webhook الخاص بكل منهما، لذا استخدم بوت اختبار منفصلًا عند تعديل سير عمل قيد التشغيل. راجع دليل استكشاف أخطاء Telegram وإصلاحها من n8n.
إنشاء بوت Telegram باستخدام Python
استخدم Python عندما تحتاج إلى تحكم مباشر في الردود والتحقق من صحة البيانات والتكاملات. يطبّق المثال أدناه /start و/help والرد على النص نفسه، باستخدام نمط المعالجة غير المتزامنة من مثال python-telegram-bot.
إعداد المشروع
ثبّت إصدارًا مدعومًا من Python؛ ويُعدّ Python 3.12 خيارًا مناسبًا للبدء في هذا المثال. تتضمن وثائق المكتبة تفاصيل التوافق. أنشئ مجلدًا وبيئة افتراضية لتبقى حزم هذا المشروع منفصلة عن غيرها.
على macOS أو Linux:
mkdir telegram-bot-demo cd telegram-bot-demopython3 -m venv .venv source .venv/bin/activate python -m pip install "python-telegram-bot==22.8"
في Windows PowerShell، استخدم py -m venv .venv،
ثم .\.venv\Scripts\Activate.ps1، وبعدها نفّذ أمر التثبيت نفسه.
إذا كانت سياسة الجهاز تمنع التفعيل، شغّل .\.venv\Scripts\python.exe مباشرةً بدلًا من تغيير سياسة النظام من أجل هذا الدليل.
أضف كود البوت
احفظ الملف باسم bot.py. احصل على الرمز من متغير بيئة، ولا تكتبه في سلسلة نصية تُضاف إلى مستودع الكود.
import os
from telegram import Update
from telegram.ext (
Application, CommandHandler, ContextTypes,
MessageHandler, filters,
)
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
if update.message:
await update.message.reply_text("Hello! Send text or use /help.")
async def help_command(update: Update, context: ContextTypes.DEFAULT_TYPE):
if update.message:
await update.message.reply_text("I repeat text messages. Try sending Hello.")
async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE):
if update.message and update.message.text:
await update.message.reply_text(update.message.text)
def main():
token = os.environ.get("TELEGRAM_BOT_TOKEN")
if not token:
raise SystemExit("Set TELEGRAM_BOT_TOKEN before starting the bot.")
app = Application.builder().token(token).build()
app.add_handler(CommandHandler("start", start))
app.add_handler(CommandHandler("help", help_command))
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))
app.run_polling(allowed_updates=["message"])
if __name__ == "__main__":
main()
تشغيل البوت
عيّن السر في نافذة الطرفية نفسها، ثم شغّل python bot.py. على macOS أو Linux باستخدام bash أو zsh، تمنعك هذه الطريقة من كتابة الرمز مباشرةً في أمر يُحفظ في سجل الأوامر:
read -s "TELEGRAM_BOT_TOKEN?Paste bot token: "zsh export TELEGRAM_BOT_TOKEN python bot.py
في bash، استبدل السطر الأول بـ read -s -p "Paste bot token: " TELEGRAM_BOT_TOKEN.
في PowerShell 7، استخدم $env:TELEGRAM_BOT_TOKEN = Read-Host -MaskInput 'Paste bot token'، ثم python bot.py.
افتح المحادثة الخاصة واختبر /start, /help وأرسل رسالة نصية قصيرة. أوقف العملية بالضغط على Ctrl+C. هذا الكود نقطة انطلاق للتعلّم؛ فهو لا يتضمن قاعدة بيانات أو حالة محادثة دائمة أو مراقبة لبيئة الإنتاج.
إبقاء البوت قيد التشغيل
شغّل التطبيق على مضيف يعمل باستمرار، أو اترك سير العمل بلا كود نشطًا في بيئة الاستضافة. عند إغلاق عملية Python المحلية، يتوقف البوت عن الرد.
يعني long polling أن برنامجك يطلب من Telegram الأحداث الواردة. أما webhook، فتعني أن Telegram يرسل الأحداث إلى خادمك. يشرح مرجع Bot API آليتي تلقي التحديثات اللتين لا يمكن استخدامهما معًا. يستخدم مثال Python أسلوب polling، بينما يعتمد المشغّل في n8n على webhook.
قبل الانتقال من تجربة إلى خدمة مشتركة:
- احتفِظ بالرمز في إعدادات الأسرار لدى مزوّد الاستضافة، واستبعِد .venv والملفات السرية من Git.
- شغّل نسخة واحدة تستخدم polling لكل رمز بوت، وتجنّب تشغيل تطبيق آخر يستهلك أحداث البوت نفسه.
- فعّل إعادة التشغيل التلقائي، وتفقّد الأعطال من دون تسجيل الأسرار أو محتوى الرسائل غير الضروري.
- خزّن حالة المحادثة المطلوبة خارج ذاكرة العملية.
- اختبر إعادة التشغيل وتأكد من أن البوت يعود إلى العمل.
إذا احتاج المشروع لاحقًا إلى واجهة ويب، فخطط لها بشكل منفصل. ويقدم دليل AdsGram حول أخطاء تطوير Telegram Mini Appsمعلومات إضافية مفيدة لهذه المرحلة.
حلّ أخطاء الإعداد الشائعة
إذا لم يردّ البوت، فتحقّق من التطبيق الذي يشغّله ومن وصول التحديثات قبل تغيير ملفه الشخصي. اتبع هذا الترتيب لتعرف ما إذا كانت المشكلة في الحساب أم في سير العمل أو الشيفرة البرمجية.
- لا يوجد رد بعد التسجيل: اربط سير العمل أو البرنامج وشغّله؛ فـ BotFather لا يشغّله بنفسه.
- متغير بيئة مفقود: عيّن
TELEGRAM_BOT_TOKENفي الصدفة نفسها أو خدمة الاستضافة التي تشغّل Python. - خطأ في المصادقة: تحقّق من وجود مسافات زائدة، أو من استخدام رمز قديم أو بيانات اعتماد بوت آخر.
- تعارض في polling: أوقف العمليات المكررة. إذا كنت تنتقل من خدمة تستخدم webhook، فأزل webhook عمدًا باستخدام
deleteWebhookقبل بدء polling؛ راجع الأسئلة الشائعة حول تحديثات Telegram. - تعمل المحادثة الخاصة، لكن المجموعة لا تعمل: تحقّق من وضع الخصوصية، وجرّب أمرًا موجّهًا إلى البوت، مثل
/help@your_bot_username. - أمر القائمة لا يفعل شيئًا: أضف معالجًا لهذا الأمر؛ فإضافته في BotFather تجعله ظاهرًا فحسب.
الأسئلة الشائعة
يمكنك البدء على جهازك من دون حساب استضافة. توضح الإجابات أدناه ما تحتاج إليه للتسجيل وتشغيل البوت باستمرار.
هل يمكنني إنشاء بوت على Telegram مجانًا؟
منصة Telegram الأساسية للبوتات مجانية، ويمكنك تطوير بوت Python بسيط على جهازك. وقد تتحمل تكاليف منفصلة للاستضافة أو خدمة بلا برمجة أو واجهات API خارجية. ابدأ بتجربة بوت محلي يردّ على الرسائل النصية، وتحقق من رسوم الاستضافة أو الخدمة قبل تشغيله باستمرار.
هل BotFather آمن؟
استخدم الحساب الرسمي الذي تصل إليه عبر وثائق Telegram أو رابط @BotFather المباشر في هذا الدليل. BotFather أداة Telegram لإدارة البوتات. تكمن أبرز مخاطر الإعداد في الحسابات المنتحلة وتسريب رموز الوصول. احتفظ بالرمز سرًا، ولا تشاركه إلا مع التطبيق أو الخدمة التي تثق بها عن قصد لتشغيل البوت.
كيف أحصل على رمز بوت Telegram من BotFather؟
أرسل /newbot إلى BotFather الرسمي، واتبع التعليمات لاختيار الاسم واسم المستخدم. سيزوّدك BotFather بعد ذلك برمز البوت. أما إذا كان لديك حساب بالفعل، فاستخدم خيارات إدارته لإنشاء رمز. خزّن الرمز بأمان، وحدّث بيانات اعتماد التطبيق كلما ألغيت الرمز السابق أو استبدلته.
هل أحتاج إلى Python لإنشاء بوت على Telegram؟
لا. يمكنك إعداد رد أساسي باستخدام سير عمل مرئي من دون Python، كما يمكنك استخدام لغات برمجة أخرى للتعامل مع Bot API. اختر الطريقة بحسب الوظائف التي تحتاج إليها وما يمكنك صيانته. تناسب الأداة المرئية شجرة قرارات قصيرة، بينما قد تكون كتابة تطبيقك الخاص خيارًا أفضل للتحقق من صحة البيانات وعمليات التكامل الأكثر تعقيدًا.
لماذا يتوقف البوت عندما أغلق الطرفية؟
في هذا المثال، تشغّل الطرفية العملية التي تستقبل الرسائل وترسل الردود. وعند انتهاء العملية، يتوقف هذا المنطق عن العمل، مع أن حساب البوت يظل قائمًا. لاستخدامه باستمرار، انشر البرنامج في بيئة تعمل دائمًا وتدعم إعادة التشغيل، أو أبقِ سير عمل مستضافًا نشطًا وتفقّد سجلات التنفيذ عند تعذّر الرد.





