توكن بوت تيليجرام: كيف تحصل عليه وتجده وتحميه

باختصار. توكن بوت تيليجرام يأتي من @BotFather: أرسل ‎/newbot، واختر اسمًا واسم مستخدم ينتهي بـ bot، فيصلك التوكن — 110201543:AAHdq…. أضعته؟ ‎/mybots ← بوتك ← API Token. تسرّب؟ ألغِه من هناك فيتوقف القديم عن العمل. وافحص أي توكن بالطريقة getMe — أو في أداة فحص التوكن المجانية، التي تعرض أيضًا معرّفات المحادثات (chat ID) الخاصة ببوتك. وهو كل ما تحتاج إليه مع Bot API: أما api_id / api_hash من my.telegram.org فلتطبيقات تتواصل مع تيليجرام عبر MTProto.

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

خطوة بخطوة: الحصول على التوكن من BotFather

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

يبدو التوكن هكذا: 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw — أرقام، ثم نقطتان، ثم سلسلة طويلة من الحروف والأرقام والشرطات والشرطات السفلية. وكل طلب إلى Bot API يحمله في العنوان، بعد كلمة bot: https://api.telegram.org/bot<token>/getMe.

ولدى BotFather أيضًا Mini App يفعل كل ذلك بالأزرار بدل الأوامر — النتيجة نفسها، والتوكن نفسه.

العثور على توكن بوت تملكه من قبل

أرسل ‎/mybots إلى @BotFather، واختر البوت، وافتح API Token. هذا هو المكان الوحيد الذي يعرضه فيه تيليجرام: لا الملف الشخصي للبوت، ولا محادثته، ولا إعدادات تيليجرام. وإن كنت أنشأت البوت منذ زمن ولا تتذكر أي حساب يملكه، فهو الحساب الذي يظهر البوت في محادثته مع BotFather ضمن ‎/mybots.

التحقق من أن التوكن يعمل

في Bot API طريقة صُمّمت لهذا بالضبط: getMe، «طريقة بسيطة لاختبار توكن المصادقة الخاص ببوتك». وحين يكون التوكن صحيحًا تردّ باسم البوت واسم المستخدم والمعرّف. ويمكن استدعاؤها بإحدى وسيلتين:

• افتح https://api.telegram.org/bot<token>/getMe في المتصفح، بعد وضع توكنك مكان <token>؛
• أو الصق التوكن في أداة فحص توكن البوت، التي ترسل الطلب نفسه من متصفحك مباشرة إلى api.telegram.org، ثم تقرأ تحديثات البوت الأخيرة لتعرض كل محادثة مع معرّفها (chat ID).

ما تعنيه الردود:

ردّ تيليجرام	معناه
اسم البوت واسم المستخدم والمعرّف	التوكن يعمل
Unauthorized (401، أي «غير مصرّح»)	في التوكن خطأ كتابي، أو أُلغي واستُبدل في BotFather
Not Found (404، أي «غير موجود»)	لا يحمل العنوان أي توكن أصلًا — تنقصه النقطتان أو كلمة bot قبله

توكن مسرّب: ألغِه الآن

من يملك التوكن يتحكم في البوت: يقرأ ما يُرسل إليه، ويكتب باسمه، ويغيّر إعداداته. ويقول الدليل التعليمي لتيليجرام إن التوكن يجب أن يُعامل معاملة كلمة المرور، وإنه يمكن إلغاؤه في أي وقت عبر @BotFather.

فإن لُصق توكن في مستودع عام، أو لقطة شاشة، أو مستند مشترك، أو محادثة لا تثق بها، فألغِه من @BotFather ← /mybots ← بوتك ← API Token. يحصل البوت على توكن جديد ويتوقف القديم عن العمل، فينقطع كل ما كان يعمل بالتوكن القديم، بما في ذلك شيفرتك أنت؛ لذا ضع التوكن الجديد حيث يعمل بوتك فور ذلك.

وأين تحفظه من البداية؟ يقترح الدليل التعليمي لتيليجرام ملف إعدادات أو متغيرات بيئة بدل الشيفرة نفسها. فالشيفرة تُشارَك، وتُنسخ منها تفرّعات، وتُلصق في الأسئلة؛ أما متغير البيئة على الخادم فلا.

التوكن ليس API ID ولا hash

خلطٌ شائع: يصدر my.telegram.org قيمتي api_id وapi_hash ضمن «API development tools». وهاتان تعرّفان تطبيقًا يتواصل مع تيليجرام عبر MTProto API: في الغالب تطبيقات عملاء مخصّصة تسجّل الدخول بحساب مستخدم، وكذلك مكتبات MTProto للبوتات وخادم Bot API المستضاف ذاتيًا، وهذه تحتاج إليهما إضافةً إلى التوكن. أما Bot API العادية على api.telegram.org، وهي ما تستخدمه معظم خدمات البوتات وأدوات الأتمتة، فتأخذ التوكن من BotFather ولا شيء غيره.

هل تحتاج إلى نسخ التوكن أصلًا؟

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

ماذا تفعل بالتوكن بعد ذلك

تطلب معظم التكاملات قيمتين: التوكن ومعرّف المحادثة (chat ID)، أي المكان الذي ينشر فيه البوت. يتناول دليل معرّف المحادثة أنواع المحادثات كلها، وتعثر أداة فحص التوكن على معرّفات المحادثات التي يتواصل معها بوتك بالفعل.

---

المصادر، رُوجعت في أكتوبر 2026: مرجع Bot API من تيليجرام: قسم تفويض البوت (صيغة التوكن وعنوان الطلب)، والطريقة getMe؛ ميزات البوتات: BotFather (الأمر ‎/newbot، وقواعد اسم المستخدم، وتوليد توكن جديد، وMini App الخاص بـ BotFather)، والبوتات المُدارة؛ الدليل التعليمي للبوتات: إلغاء التوكن، ومعاملته معاملة كلمة المرور، وإبقاؤه خارج الشيفرة؛ الحصول على api_id: الغرض من api_id وapi_hash.