البدء
وثائق Pabal للمطوّرين
كل ما تحتاج إليه لاستخدام Pabal، وبناء البوتات والتطبيقات فوقه، وتشغيل خادم Pabal بنفسك.
البدء
نبذة عن Pabalما هو Pabal، وكيف بُني، وما الذي يعمل الآن وما الذي لا يعمل بعد.البدء
استخدام التطبيقالتسجيل والمحادثات والمجموعات والصور والبوتات والروابط — دليل لمن يستخدم التطبيق لأول مرة.تطوير البوتات
إنشاء بوت — درس تطبيقيأنشئ بوتاً عبر @BotFather، وتعامل مع الرسائل والأزرار والأوامر والصور وحتى المجموعات.تطوير البوتات
الاستلام عبر webhookكيف تستلم التحديثات الجديدة مباشرة على عنوان HTTPS الخاص ببوتك. التحقق وإعادة المحاولة والرد من خلال الاستجابة.تطوير البوتات
مرجع Bot APIكل الطرق والكائنات والأخطاء دون استثناء. استخدم مكتبات Telegram Bot API بتغيير العنوان فقط.واجهة Pabal البرمجية
Pabal API — MTProtoعندما تبني عميلاً يتصل بالطريقة نفسها التي يتصل بها التطبيق: بيانات الاتصال والمفتاح العام والمصادقة والتحديثات.تشغيل الخادم
تثبيت الخادمالخادم وPostgreSQL وHTTPS دفعة واحدة باستخدام Docker Compose، وحتى النسخ الاحتياطي والتحديث.تشغيل الخادم
الإدارة والإعداداتصفحة الإدارة، وإيصال رموز التسجيل (SMS والبريد الإلكتروني)، والقائمة الكاملة لقيم الإعدادات.بوت في ثلاث دقائق
في تطبيق Pabal، أرسل /newbot إلى @BotFather لإنشاء بوت، فتحصل على رمز مميّز (token). ويمكنك أن تبدأ بإرسال الطلبات بهذا الرمز فوراً.
# ضع هنا الرمز المميّز الذي حصلت عليه
TOKEN='100003:AbCdEf…'
# معلومات البوت
curl -s "https://pabal.me/bot$TOKEN/getMe"
# بعد أن ترسل أي شيء إلى البوت من التطبيق: اجلب التحديثات الجديدة (ينتظر حتى 30 ثانية)
curl -s "https://pabal.me/bot$TOKEN/getUpdates?timeout=30"من هنا يتابع درس إنشاء البوت. وإذا كان لديك بوت مبني لـ Telegram، فيكفي أن تغيّر العنوان من https://api.telegram.org إلى https://pabal.me.
أي مستند أقرأ؟
| ما تريد فعله | المستند |
|---|---|
| سمعت عن Pabal للتو | نبذة عن Pabal |
| أريد أن أتحادث عبر التطبيق | استخدام التطبيق |
| أريد إنشاء بوت إشعارات أو بوت مساعد | إنشاء بوت ← Webhooks |
| أريد تشغيل بوت Telegram الذي أستخدمه حالياً على Pabal أيضاً | ربط المكتبات، الاختلافات عن Telegram |
| أريد معرفة معاملات طريقة (method) بعينها | مرجع Bot API |
| أريد بناء برنامج (عميل) يتصل بحساب شخص | Pabal API — MTProto |
| أريد أن أشغّل بنفسي خادم Pabal خاصاً بمؤسستي | تثبيت الخادم ← الإدارة والإعدادات |
العناوين في لمحة
| ماذا | العنوان | أين يُستخدم |
|---|---|---|
| الموقع والروابط | https://pabal.me/ | المتصفح، وروابط pabal.me/اسم_المستخدم |
| Bot API | https://pabal.me/bot<token>/<method> | برامج البوتات (HTTPS) |
| ملفات Bot API | https://pabal.me/file/bot<token>/<file_path> | تنزيل الصور التي استلمها البوت |
| MTProto | 122.34.175.215:8443 | تطبيق Pabal، وعملاء MTProto، وبوتات MTProto |
| المفتاح العام للخادم | https://pabal.me/docs/server-key.pem | المفتاح الذي يُضمَّن داخل عملاء MTProto |
كل الأمثلة في هذه الوثائق جُرّبت فعلاً
شُغّلت الأوامر والشيفرات وتُحقّق منها على خادم Pabal بتاريخ 2026-09-19 باستخدام python-telegram-bot 22.8 وaiogram 3.31 وTelethon 1.42 وcurl. أما الميزات التي لا يدعمها Pabal بعد، فقد أشرنا إليها على حدة في كل مستند.