البدء
وثائق Pabal للمطوّرين
كل ما تحتاج إليه لاستخدام Pabal، وبناء البوتات والتطبيقات فوقه، وتشغيل خادم Pabal بنفسك.
البدء
نبذة عن Pabalما هو Pabal، وكيف بُني، وما الذي يعمل الآن وما الذي لا يعمل بعد.البدء
وكلاء الذكاء الاصطناعيبوت يرد على الرسائل ويستقبل المكالمات أيضاً — البوت نفسه على الكمبيوتر والهاتف وApple Watch، ومعه إلى أين تذهب البيانات (قيد الإعداد).البدء
استخدام التطبيقالتسجيل والمحادثات والإشعارات والمجموعات والصور والبوتات والروابط — دليل لمن يستخدم التطبيق لأول مرة.تطوير البوتات
إنشاء بوت — درس تطبيقيأنشئ بوتاً عبر @BotFather، ثم تعامل مع الرسائل والأزرار والأوامر والصور، وصولاً إلى المجموعات.تطوير البوتات
الاستلام عبر webhookكيف تستلم التحديثات الجديدة مباشرة على عنوان HTTPS الخاص ببوتك: التحقق، وإعادة المحاولة، والرد ضمن الاستجابة.تطوير البوتات
البوتات الصوتية — بوتات تستقبل المكالماتاتصل ببوت فيرد عليك نموذج صوتي بالذكاء الاصطناعي. التعليمات والصوت والأدوات وMCP ووضع الصوت الخام (قيد الإعداد).تطوير البوتات
مرجع Bot APIكل الطرق (methods) والكائنات والأخطاء دون استثناء. استخدم مكتبات Telegram Bot API كما هي بتغيير العنوان فقط.واجهة Pabal البرمجية
واجهة Pabal البرمجية — MTProtoعندما تبني عميلاً يتصل بالطريقة نفسها التي يتصل بها التطبيق: بيانات الاتصال والمفتاح العام والمصادقة والتحديثات.تشغيل الخادم
تثبيت الخادمالخادم وPostgreSQL وHTTPS دفعة واحدة باستخدام Docker Compose، ثم الإشعارات الفورية على Android، وصولاً إلى النسخ الاحتياطي والتحديث.تشغيل الخادم
الإدارة والإعداداتصفحة الإدارة، وإيصال رموز التسجيل (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 |
| أريد أن أراسل الآخرين عبر التطبيق | استخدام التطبيق |
| لا تصل الإشعارات إلى هاتفي | استخدام التطبيق — الإشعارات |
| ماذا يمكنني أن أفعل مع وكلاء الذكاء الاصطناعي | وكلاء الذكاء الاصطناعي |
| أريد إنشاء بوت إشعارات أو بوت مساعد | إنشاء بوت ← Webhook |
| أريد أن أشغّل على Pabal أيضاً بوت Telegram الذي أستخدمه حالياً | ربط المكتبات، الاختلافات عن Telegram |
| أريد أن أنشئ بوتاً يستقبل المكالمات | البوتات الصوتية |
| إلى أين يذهب صوت المكالمة مع البوت | وكلاء الذكاء الاصطناعي — إلى أين تذهب البيانات |
| أريد معرفة معاملات طريقة (method) بعينها | مرجع Bot API |
| أريد بناء برنامج (عميل) يتصل بالخادم بحساب مستخدم عادي | واجهة Pabal البرمجية — 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. وتُحقّق من أمثلة البوتات الصوتية بالطريقة نفسها بتاريخ 2026-09-27 على خادم اختبار وبوابة اختبار. أما الميزات التي لا يدعمها Pabal بعد، فقد أشرنا إليها في كل مستند على حدة.