كيف يمكنني الحصول على توكن API من BotFather لربطه بروبوت تيليغرام؟

مقدمة: لماذا تحتاج توكن API من BotFather؟

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

ما هو BotFather؟

BotFather هو البوت الرسمي من تيليغرام والمخصّص لإدارة جميع البوتات على المنصة. أنشأه فريق تيليغرام نفسه، وهو الأداة الوحيدة التي تتيح لك إنشاء بوت جديد والحصول على التوكن الخاص به. يعمل BotFather على جميع منصات تيليغرام: الهواتف الذكية (Android و iOS) وسطح المكتب (Windows و macOS و Linux) والإصدارات الويب. لا توجد اختلافات جوهرية في الأوامر بين المنصات، لكن طريقة الوصول إلى BotFather قد تختلف قليلاً حسب التطبيق الذي تستخدمه.

للوصول إلى BotFather، افتح تطبيق تيليغرام وانقر على أيقونة البحث (أو استخدم مربع البحث في أعلى الشاشة). اكتب BotFather وستظهر النتيجة الأولى بحساب موثّق (علامة زرقاء). انقر عليه لفتح المحادثة، وإذا كانت هذه أول مرة تتواصل فيها معه، اضغط على زر Start أو أرسل الأمر /start.

نصيحة: تأكد من أن الحساب الذي تتواصل معه هو الحساب الرسمي: @BotFather مع شارة التحقق الزرقاء. فهناك حسابات وهمية تحاول خداع المستخدمين.

إنشاء بوت جديد واستلام التوكن

الخطوة الأولى: أمر /newbot

بعد فتح المحادثة مع BotFather، أرسل الأمر /newbot. سوف يرد عليك BotFather بطلب تحديد اسم للبوت. الاسم هو ما سيظهر للمستخدمين في قائمة الدردشات، ويمكن أن يكون أي اسم من اختيارك (مثل "بوت الطقس" أو "My Helper Bot").

بعد إرسال الاسم، سيطلب منك BotFather اختيار معرف المستخدم (username) للبوت. يجب أن ينتهي هذا المعرف بكلمة bot (على سبيل المثال: WeatherAlertBot أو example_bot. المعرف فريد عالميًا، لذا قد تضطر إلى تجربة عدة خيارات إذا كان المعرف الذي تريده محجوزًا. تأكد من أن المعرف يتبع قواعد تيليغرام: الأحرف اللاتينية، الأرقام، والشرطة السفلية، وأن يكون بطول مناسب (عادةً بين 5 و32 حرفًا مع لاحقة "bot").

بعد اختيار معرف صالح، سيقوم BotFather بإنشاء البوت فورًا ويعرض لك رسالة تأكيد تحتوي على:

رابط البوت (t.me/your_bot_username)
توكن API (سلسلة نصية طويلة مثل 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)
رابط لإضافة البوت إلى القنوات والمجموعات

تحذير: احفظ التوكن فورًا في مكان آمن. لن يتمكن BotFather من إظهار التوكن مرة أخرى بنفس الرسالة بعد حذف المحادثة؛ ولكن يمكنك استخدام أمر /token لاسترجاعه، كما سنشرح لاحقًا.

الخطوة الثانية: حفظ التوكن بأمان

التوكن هو المفتاح الوحيد للتحكم في البوت؛ أي شخص يمتلكه يمكنه إرسال رسائل عبر البوت، أو تغيير إعداداته، أو حتى حذفه في أسوأ الحالات. لذلك، يجب التعامل معه مثل كلمة مرور شديدة الحساسية. لا تشاركه في محادثات عامة، ولا ترفعه إلى مستودعات الكود المصدري العامة. أفضل الممارسات هي تخزينه في متغير بيئة (Environment Variable) على الخادم، أو في ملف إعدادات محمي (مثل .env) خارج مسار التحكم بالإصدارات (Git).

على سبيل المثال، إذا كنت تطور بوتًا باستخدام لغة Python، يمكنك استخدام مكتبة python-dotenv لقراءة التوكن من ملف .env. أما في Node.js، فيمكنك استخدام dotenv. احرص دائمًا على إضافة ملفات .env إلى ملف .gitignore لمنع تسربها عن طريق الخطأ.

إدارة البوت بعد الحصول على التوكن

تغيير اسم البوت أو اسم المستخدم

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

/setname: يغير الاسم المعروض للبوت. سيسألك BotFather عن البوت المطلوب (إذا كان لديك عدة بوتات) ثم يطلب الاسم الجديد.
/setusername: يغير معرف المستخدم (الاسم المميز). يجب أن ينتهي بـ "bot" وأن يكون فريدًا.

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

إضافة وصف وصورة للبوت

لجعل البوت أكثر جاذبية واحترافية، يمكنك إضافة وصف قصير (About) ووصف أطول (Description) وصورة شخصية. استخدم الأوامر التالية:

/setdescription: تعيين وصف يظهر في مقدمة الدردشة عند بدء استخدام البوت. يُستخدم لشرح وظائف البوت بإيجاز.
/setabouttext: تعيين نص "حول" يظهر في صفحة معلومات البوت. يمكن أن يكون أكثر تفصيلاً ويتضمن استخدامات البوت.
/setuserpic: تعيين صورة شخصية للبوت. يُفضّل أن تكون الصورة مربعة وبحجم 512x512 بكسل للحصول على أفضل جودة. بعد إرسال الأمر، سيرسل BotFather تعليمات لتحميل الصورة مباشرة في الدردشة.

على سبيل المثال، إذا كنت تنشئ بوتًا للطقس، يمكن أن يكون الوصف: "بوت يقدم توقعات الطقس اليومية والأسبوعية لأي مدينة. أرسل اسم المدينة أو استخدم الموقع."

تحديد الأوامر الخاصة بالبوت

يمكنك تعريف قائمة من الأوامر التي سيراها المستخدمون عند كتابة شرطة مائلة (/) في نافذة الدردشة مع البوت. هذه الميزة تحسن تجربة الاستخدام بشكل ملحوظ. استخدم الأمر /setcommands في محادثة BotFather. بعد اختيار البوت، سيطالبك BotFather بإرسال قائمة الأوامر بالتنسيق التالي:

command1 - وصف الأمر الأول
command2 - وصف الأمر الثاني
command3 - وصف الأمر الثالث

يمكنك إرسال ما يصل إلى 100 أمر، بحد أقصى 32 حرفًا لكل أمر (بدون الخط المائل)، و256 حرفًا للوصف. يجب أن تتكون الأوامر من أحرف لاتينية صغيرة وأرقام وشرطة سفلية.

استرجاع التوكن أو إبطاله

الحصول على التوكن مرة أخرى (إذا فقدته)

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

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

إبطال التوكن الحالي وتوليد توكن جديد

إذا شككت في أن توكنك قد تسرب (على سبيل المثال، عن طريق الخطأ في مستودع عام)، يجب إبطاله فورًا وإنشاء توكن جديد. استخدم الأمر /revoke مع البوت المعني. بعد التأكيد، سيقوم BotFather بتعطيل التوكن القديم وتوليد توكن جديد وفريد. ستحتاج بعد ذلك إلى تحديث التوكن في جميع التطبيقات التي تستخدم البوت.

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

حذف البوت (Permanently Delete Bot)

إذا لم تعد بحاجة إلى البوت، يمكنك حذفه نهائيًا باستخدام الأمر /deletebot من محادثة BotFather. سيطلب منك تأكيد الحذف، وبعدها لا يمكن استعادة البوت أو معرفه أو توكنه. يُستخدم هذا الأمر بحذر شديد، خاصة إذا كان البوت لديه مستخدمين نشطين أو مرتبطًا بقنوات أو مجموعات. بدلاً من الحذف الكامل، يمكنك فقط إيقاف تشغيل الخادم الذي يشغل البوت مؤقتًا كبديل أقل خطورة.

جدول مرجعي لأوامر BotFather الأساسية

الأمر	الوظيفة
/newbot	إنشاء بوت جديد والحصول على توكن
/mybots	عرض قائمة البوتات الخاصة بك وإدارتها
/setname	تغيير الاسم المعروض للبوت
/setusername	تغيير معرف المستخدم (username)
/setdescription	تعيين وصف البوت (يظهر في بداية الدردشة)
/setabouttext	تعيين نص "حول" للبوت
/setuserpic	تعيين صورة شخصية للبوت
/setcommands	تعيين قائمة الأوامر المقترحة
/token	عرض توكن API الحالي لبوت معين
/revoke	إبطال التوكن الحالي وتوليد توكن جديد
/deletebot	حذف البوت بشكل نهائي

استكشاف الأخطاء والمشكلات الشائعة

المشكلة: BotFather لا يستجيب

إذا توقفت المحادثة مع BotFather عن العمل، تحقق من اتصالك بالإنترنت أولاً. قد يكون BotFather مشغولاً مؤقتاً؛ جرب إعادة إرسال الأمر بعد بضع ثوانٍ. هناك أيضاً احتمال أن تكون قد حظرت BotFather عن طريق الخطأ؛ تحقق من إعدادات الخصوصية أو ابدأ محادثة جديدة.

المشكلة: التوكن لا يعمل عند برمجة البوت

تأكد من أنك تنسخ التوكن بدقة بدون مسافات إضافية. جرب إرسال طلب بسيط للتحقق: استخدم متصفحك لزيارة الرابط https://api.telegram.org/botYOUR_TOKEN/getMe (استبدل YOUR_TOKEN بالتوكن الحقيقي). إذا استجاب الخادم بمعلومات البوت، فالتوكن صحيح. إذا حصلت على خطأ مثل Unauthorized، فالتوكن قد يكون منتهياً أو تم إبطاله. في هذه الحالة، استخدم أمر /revoke للحصول على توكن جديد.

المشكلة: لا يمكن اختيار معرف مستخدم للبوت

تأكد من أن المعرف ينتهي بـ bot (مثل MyFirstBot أو my_bot). تجنب استخدام الأحرف الكبيرة غير القياسية أو الأحرف الخاصة. إذا كان المعرف محجوزاً، جرب إضافة أرقام أو شرطة سفلية.

نصائح أمنية متقدمة

بالإضافة إلى حفظ التوكن في متغير بيئة، اتبع هذه الممارسات لتعزيز الأمان بشكل أكبر:

لا تستخدم التوكن مباشرة في كود العميل (Client-side)؛ يجب أن يكون على الخادم فقط.
قم بتدوير التوكن بشكل دوري (مثلاً كل 6 أشهر) باستخدام أمر /revoke، خاصة إذا كان البوت يتعامل مع بيانات حساسة.
إذا كنت تستخدم خدمات سحابية (مثل AWS Secrets Manager أو GitHub Secrets) لتخزين التوكن، امنح صلاحيات الوصول الضرورية فقط.
راجع سجلات الخادم بانتظام للكشف عن أي استخدام غير مصرح به للتوكن (مثل طلبات API غير متوقعة).

الأسئلة الشائعة

هل يمكنني الحصول على توكن API من BotFather لأكثر من بوت؟

نعم، يمكنك إنشاء عدد غير محدود من البوتات باستخدام نفس حساب تيليغرام. كل بوت سيحصل على توكن فريد خاص به. فقط استخدم أمر /newbot لكل بوت جديد.

ماذا لو فقدت التوكن ولم أستطع الوصول إلى محادثة BotFather؟

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

هل يؤثر إبطال التوكن على البوتات التي تعمل بالفعل؟

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

هل يمكن لشخص آخر سرقة بوتي إذا عرف التوكن؟

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

الخلاصة والخطوات التالية

في هذا الدليل، تعلمت كيفية الحصول على توكن API من BotFather لربطه بروبوت تيليغرام، بدءاً من إنشاء البوت وحتى إدارة إعداداته المتقدمة. تذكر دائماً أن التوكن هو مفتاح التحكم في البوت، ويجب حمايته تماماً مثل كلمة المرور. بعد حصولك على التوكن، يمكنك البدء في برمجة البوت باستخدام أي لغة برمجة تدعم HTTP APIs، مثل Python (مكتبة python-telegram-bot)، أو Node.js (node-telegram-bot-api)، أو PHP.

الخطوة التالية الموصى بها هي تجربة الأمر /getMe عبر API للتحقق من أن البوت يعمل بشكل صحيح، ثم كتابة أول أمر بسيط مثل الرد على /start. يمكنك أيضاً الاطلاع على الوثائق الرسمية لواجهة برمجة تطبيقات البوتات لفهم الإمكانيات الكاملة. حظاً موفقاً في بناء بوتك الأول!