أين أجد رمز Telegram bot؟

الرمز هو مفتاح سري يتيح لـ Mini Apps Builder ربط البوت الخاص بك بالمشروع. هذا ليس كلمة مرور Telegram ولا رابطًا إلى البوت. وللحصول عليه لا تحتاج إلى البرمجة.

كيف تحصل على الرمز إذا لم يكن البوت موجودًا بعد

افتح BotFather الرسمي. هذه أداة من Telegram لإنشاء البوتات وإدارتها. تأكد من اسم المستخدم — وهو @BotFather بالضبط، من دون أي أحرف أو أرقام إضافية. الواجهة نفسها على جميع المنصات: Android وiOS وmacOS وWindows وLinux وWeb.

تُنفَّذ الخطوات التالية في محادثة BotFather: اضغط Start Bot,

سترى رسالة مثل هذه. بعد ذلك يمكنك إنشاء البوت بطريقتين: عبر الدردشة وMini App.

إنشاء بوت جديد عبر الدردشة

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

سيسألك BotFather عن اسم التطبيق. هذا هو "اسم" البوت/التطبيق الذي سيراه أي مستخدم في Telegram. لكن يمكنك أيضًا تغييره لاحقًا في أي وقت.

بعد إدخال "الاسم" سيطلب BotFather ابتكار username_bot - وهو معرّف فريد لا يمكن تغييره بعد الإنشاء. بالإضافة إلى ذلك، سيخبرك Telegram نفسه إذا كان الخيار الذي أدخلته محجوزًا بالفعل.

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

يجب لصق الرمز المنسوخ في حقل "Token" عند إنشاء المشروع في Mini Apps Builder. بعد ذلك سيتم إنشاء المشروع.

إنشاء بوت جديد عبر Mini App

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

اضغط زر "Open" في أسفل اليسار بجانب حقل إدخال النص في الدردشة.

سيُفتح أمامك هذا الشاشة. إذا لم تكن قد أنشأت بوتات من قبل، فسيكون هناك "فراغ" تحت النص "My bots". في كل الأحوال نحن الآن نشرح سيناريو إنشاء بوت جديد، لذلك اضغط زر "Create a New Bot".

الحقول المظللة إلزامية. يمكن إضافة الشعار و"About" لاحقًا في أي وقت.

Bot Name - اسم البوت/التطبيق الذي سيراه أي مستخدم في Telegram. لكن يمكنك أيضًا تغييره لاحقًا في أي وقت.

username_bot - هذا هو المعرّف الفريد، ولا يمكن تغييره بعد الإنشاء. بالإضافة إلى ذلك، سيخبرك Telegram نفسه إذا كان الخيار الذي أدخلته محجوزًا بالفعل.

بعد إدخال Bot Name وusername_bot اضغط زر "Create Bot" في أسفل الشاشة.

سترى هذه الشاشة، اضغط زر "Copy"، وسيؤدي ذلك إلى نسخ Bot Token الخاص بهذا البوت.

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

يجب لصق الرمز المنسوخ في حقل "Token" عند إنشاء المشروع في Mini Apps Builder. بعد ذلك سيتم إنشاء المشروع.

ماذا تفعل إذا لم ينجح الأمر

إذا استمر الخطأ، فأرسل إلى دعم Mini Apps Builder نص الخطأ واذكر آخر خطوة قمت بها. لا تُرفق الرمز نفسه. وفي لقطة الشاشة اخفه بالكامل.

كيفية حفظ الرمز بأمان

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