كيفية إنشاء بوت تيليجرام: خطوة بخطوة، بالبرمجة أو بدونها

باختصار. بوت تيليجرام حسابٌ ومعه برنامج يردّ نيابةً عنه. الحساب يستغرق دقيقة: افتح @BotFather، وأرسل ‎/newbot، واختر اسمًا واسم مستخدم ينتهي بـ bot، فتحصل على توكن. أما البرنامج فخطوة منفصلة: اربط البوت بخدمة جاهزة، أو شغّل شيفرتك الخاصة (أدناه مثال قصير بلغة Python)، أو اطلب من مساعد ذكاء اصطناعي أن يكتبها. وما لم يعمل البرنامج يبقى البوت صامتًا.

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

الخطوة 1. سجّل البوت في @BotFather

1. افتح @BotFather — بوت تيليجرام الرسمي لإنشاء البوتات — واضغط زر البدء Start. يعمل بالطريقة نفسها على الهاتف وعلى الكمبيوتر.
2. أرسل ‎/newbot.
3. أرسل الاسم. يظهر في المحادثات وجهات الاتصال، ويمكن تغييره في أي وقت.
4. أرسل اسم المستخدم: من 5 إلى 32 محرفًا من الحروف اللاتينية والأرقام والشرطات السفلية، ينتهي بـ bot (tetris_bot، TetrisBot). لا فرق بين الحروف الكبيرة والصغيرة، ولا يمكن تغيير اسم المستخدم لاحقًا. وإن كان محجوزًا طلب منك BotFather اسمًا آخر؛ ويمكنك أن تتحقق مسبقًا هل هو محجوز في أداة فحص اسم المستخدم.
5. يردّ BotFather بـ التوكن، وهو سلسلة مثل 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw.

التوكن مفتاح: من يعرفه يتحكم في البوت. لا تنشره، ولا تكتبه في شيفرة تضعها على الإنترنت. أما كيف تعثر على التوكن لاحقًا وتتحقق منه وتلغي التوكن المسرّب، فذلك مشروح في دليل توكن البوت.

ويفعل Mini App الخاص بـ BotFather كل ذلك أيضًا، بالأزرار بدل الأوامر.

الخطوة 2. اضبط الملف الشخصي للبوت

من يفتح البوت أول مرة يرى اسمه وصورته ووصفه قبل الرسالة الأولى. ويُضبط ذلك كله في @BotFather — بالأوامر أدناه أو عبر ‎/mybots ← بوتك — ويمكن تعديل بعضه مباشرةً في صفحة الملف الشخصي للبوت.

الأمر	ما يضبطه	أين يراه الناس
‎/setuserpic	صورة الملف الشخصي	في قائمة المحادثات وفي الملف الشخصي
‎/setdescription	وصفًا يصل إلى 512 محرفًا	في المحادثة الفارغة مع البوت، إلى أن يكتب له الشخص
‎/setabouttext	نصًا قصيرًا يصل إلى 120 محرفًا	في الملف الشخصي للبوت وبجوار الرابط حين يُشارَك البوت
‎/setcommands	قائمة الأوامر مع أوصافها	على شكل اقتراحات حين يكتب الشخص ‎/
‎/setname	الاسم	في كل مكان يظهر فيه البوت

ويمكن ضبط الوصف والنص القصير بعدة لغات — بطريقتَي Bot API ‏setMyDescription وsetMyShortDescription مع language_code — فيرى كل شخص النسخة المكتوبة بلغة تيليجرام لديه.

الخطوة 3. علّم البوت أن يردّ

هنا تتوقف معظم الأدلة. فتيليجرام لا يفعل سوى إيصال الرسائل إلى البوت؛ أما الذي يردّ عليها فهو البرنامج الذي أعطيته التوكن. وهناك ثلاث طرق للحصول على هذا البرنامج:

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

خدمة جاهزة

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

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

شيفرتك الخاصة: بوت بلغة Python

يستخدم المثال aiogram 3، وهي إحدى مكتبات Bot API المدرجة في صفحة أمثلة الشيفرة لدى تيليجرام. يرحّب البوت بك عند ‎/start ويعيد إليك رسائلك كما هي.

1. ثبّت Python من الإصدار 3.10 إلى 3.14 (فمكتبة aiogram لا تدعم 3.15 بعد). وفي الطرفية، أنشئ بيئة افتراضية وثبّت المكتبة:

python3 -m venv .venv
source .venv/bin/activate
pip install aiogram

وعلى Windows: ‏python -m venv .venv، ثم ‎.venv\Scripts\activate، ثم ‏pip install aiogram.

2. احفظ الشيفرة باسم bot.py:

import asyncio
import os

from aiogram import Bot, Dispatcher
from aiogram.filters import CommandStart
from aiogram.types import Message

dp = Dispatcher()


@dp.message(CommandStart())
async def start(message: Message) -> None:
    await message.answer(f"مرحبًا، {message.from_user.first_name}! أرسل إليّ أي رسالة وسأكررها.")


@dp.message()
async def echo(message: Message) -> None:
    await message.copy_to(message.chat.id)


async def main() -> None:
    bot = Bot(token=os.environ["BOT_TOKEN"])
    await dp.start_polling(bot)


if __name__ == "__main__":
    asyncio.run(main())

3. في نافذة الطرفية نفسها، مرّر التوكن عبر متغير بيئة بدل كتابته في الشيفرة (والدليل التعليمي لتيليجرام ينصح بالشيء نفسه)، ثم شغّل البرنامج:

export BOT_TOKEN="التوكن من BotFather"
python bot.py

وعلى Windows، بدل export: ‏set BOT_TOKEN=التوكن في موجّه الأوامر (Command Prompt)، أو ‎$env:BOT_TOKEN="التوكن" في PowerShell.

افتح البوت في تيليجرام واضغط زر البدء Start: فيردّ. أوقف البرنامج (Ctrl+C) فيصمت البوت. جرّب الشيفرة على بوت منفصل: فالبوت المتصل أصلًا بخدمة يكون له webhook مضبوط، ولن يعمل معه الاستطلاع (polling). ومن المكتبات الشائعة الأخرى في القائمة نفسها python-telegram-bot للغة Python، وgrammY وTelegraf للغة JavaScript.

شيفرة بمساعدة الذكاء الاصطناعي

يقول تيليجرام صراحةً إن توثيق البوتات لديه مكتوب مع مراعاة الذكاء الاصطناعي أيضًا: فإن كانت خبرتك في البرمجة قليلة، يمكنك أن تطلب من مساعد ذكاء اصطناعي أن يقرأه ويساعدك على البدء. صِف ما ينبغي أن يفعله البوت، واطلب شيفرة بمكتبة محددة، وشغّلها بالطريقة نفسها التي شغّلت بها المثال أعلاه. ويبقى أمران عليك أنت: لا تلصق التوكن في المحادثة مع المساعد — دع الشيفرة تقرؤه من متغير بيئة — واختبر البوت بنفسك قبل أن تدعو الناس إليه.

الخطوة 4. قرّر أين سيعمل البوت

ما دام البرنامج يعمل على كمبيوترك، فلن يردّ البوت إلا والكمبيوتر يعمل. يقول الدليل التعليمي لتيليجرام ذلك صراحةً، ويقترح خادمًا (VPS) أو خدمة مشابهة للتشغيل الدائم. وإن اخترت خدمة جاهزة، فهي تتولى هذا الأمر عنك.

يمكن للبرنامج أن يستقبل الرسائل بطريقتين، ولا تعملان في الوقت نفسه:

• getUpdates (الاستطلاع الطويل، long polling). يطلب البرنامج الرسائل الجديدة من تيليجرام بنفسه. وهكذا يعمل المثال أعلاه: يكفي أي كمبيوتر، ولا حاجة إلى عنوان على الإنترنت.
• webhook. يرسل تيليجرام كل رسالة إلى عنوان HTTPS الخاص بك، على المنفذ 443 أو 80 أو 88 أو 8443. وتحتاج إليه حين تعمل الشيفرة في سحابة لا تبدأ التشغيل إلا عند الطلب.

ما دام webhook مضبوطًا، لا تعمل getUpdates. أما الرسائل التي لم يستلمها البوت بعد، فيحتفظ بها تيليجرام مدة تصل إلى 24 ساعة.

الخطوة 5. ادعُ أوائل المستخدمين

لا يستطيع البوت أن يبدأ بالكتابة إلى شخص: يجب أن يفتح الشخص البوت ويضغط زر البدء Start، أو أن يضيفه إلى مجموعة. لذا شارك الرابط t.me/your_bot_username؛ ويمكن للناس أيضًا أن يجدوا البوت باسم المستخدم الخاص به في بحث تيليجرام.

حدود الإرسال التي يحسن أن تعرفها مسبقًا (من صفحة Bots FAQ لدى تيليجرام):

• في محادثة واحدة — لا أكثر من نحو رسالة واحدة في الثانية؛
• في مجموعة — لا أكثر من 20 رسالة في الدقيقة؛
• في البث الجماعي — نحو 30 رسالة في الثانية. والأسرع من ذلك ممكن فقط بالبث المدفوع: حتى 1,000 رسالة في الثانية، مقابل 0.1 نجمة عن كل رسالة فوق الـ30 المجانية في الثانية. ويمكن تفعيله متى صار في رصيد البوت 100,000 نجمة على الأقل وصار لديه 100,000 مستخدم نشط شهريًا على الأقل.

البوت في مجموعة أو قناة

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

ولكي يكتب البوت إلى المحادثة الصحيحة، يحتاج إلى معرّف المحادثة (chat ID). وكل أنواع المحادثات مشروحة في دليل معرّف المحادثة.

لماذا لا يردّ البوت

• البرنامج لا يعمل، أو توقف بسبب عطل. فتيليجرام نفسه لا يردّ نيابةً عن البوت.
• للبوت webhook مضبوط بينما تقرأ الشيفرة بـ getUpdates — أو العكس.
• تعمل نسختان من البرنامج بالتوكن نفسه، فتتعارضان عند استلام التحديثات.
• في المجموعة لا يرى البوت الرسائل — هذا وضع الخصوصية، انظر أعلاه.
• لا يستطيع البوت الكتابة إلى شخص — لأنه لم يضغط Start بعد، أو لأنه حظر البوت.
• استُبدل التوكن في BotFather: توقف القديم عن العمل وصار البرنامج يتلقى Unauthorized. ضع التوكن الجديد.

كم يكلّف ذلك

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

---

المصادر، روجعت في أكتوبر 2026: Telegram Bots — كيف تعمل البوتات، والبوت لا يبدأ المحادثة أولًا؛ Bot features — BotFather (الأمر ‎/newbot، وقواعد اسم المستخدم، والملف الشخصي، وتعديل الأوامر، وMini App الخاص بـ BotFather)، ووضع الخصوصية (Privacy Mode)، والبوتات المُدارة (Managed Bots)، والتوثيق الموجّه للذكاء الاصطناعي؛ Bots FAQ — ما يراه البوت، والاستطلاع الطويل (long polling) وwebhook، والحدود والبث المدفوع؛ Telegram Bot API — الطريقتان getUpdates وsetWebhook (المنافذ، والاحتفاظ بالتحديثات 24 ساعة)، وsetMyDescription وsetMyShortDescription؛ Bot tutorial — إبقاء التوكن خارج الشيفرة، والاستضافة؛ Bot API Library Examples — مكتبات Bot API.