شغّل بوتك أول مرة

تنجز كل شيء من صفحة «شغّل بوتك»، حتى يطبع بوتك أول سطر في الكونسول.

قبل أن تبدأ

• حساب في منصة سيرفرك، فنحن نطلب تسجيل الدخول قبل أن نقرأ الكود.
• كود بوتك: ريبو على GitHub، أو مجلد بوتك، أو ملف zip.
• توكن بوتك، وكل متغير آخر يقرأه كودك.

لا يوجد لديك بوت بعد؟ لدينا قوالب جاهزة فيها أمر /ping أو /start جاهز من أول تشغيل: قالب ديسكورد و قالب تيليقرام.

1. اختر مكان الكود

افتح «شغّل بوتك»، ومن أين الكود؟ اختر ريبو من GitHub، أو ارفع مجلد بوتك أو ملف zip، أو ابدأ من قالب جاهز. وإذا اخترت قالبًا، ننشئه لك ريبو في حسابك على GitHub، أو ننسخه داخل بوتك مباشرة.

بعد اختيارك نقرأ الكود، ويظهر ما وجدناه تحت الخيارات.

2. راجع ما وجدناه في الكود

تحت ما وجدناه في الكود نتعرف على أن الكود نود، وعلى المكتبة (discord.js أو grammY وغيرها)، والمنصة. وتحت الأوامر نضع أمر التثبيت وأمر التشغيل. عدّل ما تريد قبل المتابعة.

بعد تحديد بيئة التشغيل، تظهر الباقات تحت اختر الباقة.

3. أضف التوكن والمتغيرات

تحت المتغيرات أضف التوكن وكل متغير يقرأه كودك. نقترح عليك الأسماء التي وجدناها في الكود وفي .env.example، فاضغط الاسم ثم اكتب قيمته.

تُحفظ القيمة الحساسة مشفّرة، ولا تُعرض بعد الحفظ.

4. اختر الباقة وادفع

تحت اختر الباقة اختر باقتك، ثم اضغط ادفع وانشر. وبعد الدفع تُفتح صفحة بوتك ويبدأ أول نشر.

5. تابع أول نشر

تعرض صفحة بوتك النشر سطرًا بسطر:

• نسحب الكود من الريبو، أو نفك الملف الذي رفعته.
• نثبّت المكتبات من package.json بـ npm ci، أو بـ pnpm أو Yarn أو Bun إذا أرفقت ملف القفل الخاص بها. ولا نعيد التثبيت إلا عند تغيّر المكتبات.
• إذا كان في package.json سكربت build، نشغّله بعد التثبيت في كل نشر.
• إذا كان لبوتك أمر ما قبل النشر، مثل prisma migrate deploy، نشغّله بعد البناء وقبل تشغيل بوتك في كل نشر.
• نشغّل بوتك بأول ما نجده بهذا الترتيب: أمر التشغيل في إعدادات بوتك، ثم start في serverk.json، ثم سطر worker: أو bot: في Procfile، ثم سكربت start في package.json، ثم الملف المذكور في main، ثم index.js و src/index.js و bot.js و src/bot.js و index.ts.

عند ظهور هذين السطرين في الكونسول، يكون بوتك قد بدأ:

serverk: deployment dep_a1b2c3d4 ready at 3f2a9c1b7d10
serverk: bot process starting

6. تأكد أن بوتك سجّل الدخول

بعد أن يسجّل بوتك الدخول ويطبع سطرًا مثل Logged in as MyBot، يظهر اسمه في بطاقة البوت مع رابط له: أضفه إلى سيرفر ديسكورد لبوت ديسكورد، و افتحه في تيليقرام لبوت تيليقرام.

التوكن غير صحيح

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

انسخ التوكن من جديد من Developer Portal أو BotFather، وحدّثه في المتغيرات، ثم انشر من جديد. والسطر الذي تطبعه كل مكتبة في شرح «أخطاء بوتك وحلولها».

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

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