تطبيق مصغر على Telegram — دليل خطوة بخطوة
ما هو؟#
التطبيق المصغر على Telegram يسمح لعملائك بفتح قائمة المطعم الرقمية مباشرة داخل Telegram — بدون تثبيت تطبيقات وبدون الانتقال إلى المتصفح. تبدو القائمة كجزء أصلي من Telegram: تتكيف مع موضوع المستخدم، وتدعم زر "الرجوع" والإيماءات.
المزايا#
- 📱 داخل Telegram — لا يحتاج العميل للتبديل إلى المتصفح
- 🎨 مظهر أصلي — الألوان والخطوط والموضوع تتكيف مع Telegram
- 🔗 روابط عميقة — رابط مباشر لقائمة مطعم محدد
- 🌍 لغة تلقائية — تُؤخذ اللغة من إعدادات Telegram للمستخدم
- 🍪 بدون ملفات تعريف الارتباط — لا يظهر لافتة ملفات تعريف الارتباط داخل Telegram
البداية السريعة#
الخطوة 1 — إنشاء بوت#
افتح @BotFather في Telegram وأرسل:
/newbot
- أدخل اسم البوت (مثلاً،
Cenaly Menu Bot) - أدخل اسم المستخدم (مثلاً،
MeniMenuBot) — يجب أن ينتهي بـBot - احفظ رمز البوت الذي تحصل عليه (الصيغة:
123456789:ABCdefGHI...)
لماذا تحتاج رمز البوت؟#
رمز البوت هو مفتاح سري للتحكم البرمجي في البوت عبر Telegram Bot API. للإعداد الأساسي للتطبيق المصغر (الخطوات 2–4) لا يتطلب — كل شيء يتم عبر BotFather. لكنه سيكون مطلوبًا إذا كنت ترغب في:
- إرسال رسائل للعملاء — إشعارات بحالة الطلب، عروض، رسائل ترحيبية
- إضافة أزرار مضمنة في رسائل البوت (مثلاً، زر "📋 فتح القائمة" — انظر القسم أدناه)
- إنشاء بوت Telegram لاستقبال الطلبات — يمكن للبوت استقبال ومعالجة الطلبات
- إعداد Webhook — استقبال الأحداث من Telegram (نقرات الأزرار، أوامر المستخدمين)
- التكامل مع نظام CRM أو POS — معالجة الطلبات تلقائيًا عبر البوت
الخطوة 2 — إنشاء تطبيق مصغر#
أرسل إلى BotFather الأمر:
/newapp
- اختر البوت من القائمة
- العنوان — اسم التطبيق (مثلاً،
Cenaly) - الوصف — وصف (مثلاً،
قائمة المطعم الرقمية) - الصورة — قم بتحميل صورة 640×640 بكسل (أيقونة التطبيق)
- GIF — الرسوم المتحركة (اختياري). لتخطي، أرسل
/empty - رابط تطبيق الويب — حدد عنوان تطبيق العميل الخاص بك:
https://cenaly.com
- الاسم المختصر — اسم مختصر للرابط (مثلاً،
menu)
بعد ذلك، ستحصل على رابط يعمل بالشكل التالي:
https://t.me/YourBot/menu
الخطوة 3 — أضف زر "القائمة" في دردشة البوت#
أرسل إلى BotFather:
/setmenubutton
- اختر البوت
- أرسل الرابط:
https://cenaly.com
- أدخل نص الزر (مثلاً،
Open Menuأو📋 القائمة)
الآن عند فتح الدردشة مع البوت، سيظهر زر في أسفل الشاشة يفتح تطبيقك.
الخطوة 4 — السماح بالنطاق#
أرسل إلى BotFather:
/setdomain
اختر البوت وحدد النطاق:
cenaly.com
هذا سيسمح لتطبيق Telegram Web App بالعمل على نطاقك وجميع النطاقات الفرعية له (مثلاً، locationid.cenaly.com).
الروابط العميقة — روابط لمطعم محدد#
يدعم Telegram المعامل startapp الذي يتم تمريره إلى التطبيق عند الفتح. استخدمه للروابط إلى مطعم محدد:
| الرابط | ما سيتم فتحه |
|---|---|
t.me/YourBot/menu |
الصفحة الرئيسية |
t.me/YourBot/menu?startapp=LOCATION_ID |
قائمة مطعم محدد |
t.me/YourBot/menu?startapp=LOCATION_ID__ru |
القائمة باللغة الروسية |
t.me/YourBot/menu?startapp=LOCATION_ID__en |
القائمة باللغة الإنجليزية |
أمثلة#
إذا كان LOCATION_ID لمطعمك هو lnc2w74z:
https://t.me/YourBot/menu?startapp=lnc2w74z
https://t.me/YourBot/menu?startapp=lnc2w74z__ru
https://t.me/YourBot/menu?startapp=lnc2w74z__en
الأزرار المضمنة من البوت#
إذا كان بوتك يرسل رسائل للعملاء، يمكنك إضافة زر مضمن يفتح القائمة:
الخيار 1 — زر تطبيق الويب (يفتح مباشرة)#
{
"inline_keyboard": [[{
"text": "📋 فتح القائمة",
"web_app": {
"url": "https://LOCATION_ID.cenaly.com/ru"
}
}]]
}
الخيار 2 — زر الرابط العميق#
{
"inline_keyboard": [[{
"text": "📋 فتح القائمة",
"url": "https://t.me/YourBot/menu?startapp=LOCATION_ID__ru"
}]]
}
ما يعمل تلقائيًا#
بعد الاتصال داخل Telegram، يتم تفعيل الميزات التالية تلقائيًا:
| الوظيفة | الوصف |
|---|---|
| 🎨 الموضوع | تتكيف ألوان التطبيق مع موضوع Telegram (فاتح/داكن) |
| ◀️ زر "الرجوع" | يظهر زر Telegram الأصلي عند فتح بطاقة المنتج |
| 📏 Viewport | يتمدد التطبيق ليملأ الشاشة بالكامل |
| 🔒 حماية من الإغلاق | السحب العمودي لا يغلق التطبيق عن طريق الخطأ |
| 🌍 اللغة التلقائية | يتم تحديد اللغة من ملف تعريف Telegram إذا لم يتم تحديدها بوضوح |
| 🍪 ملفات تعريف الارتباط | لا يظهر لافتة ملفات تعريف الارتباط داخل Telegram |
رموز QR للمطاعم#
رموز QR الموجودة بالفعل برابط بالشكل https://lnc2w74z.cenaly.com ستستمر في العمل كالمعتاد — عبر المتصفح.
للتكامل الإضافي مع Telegram، يمكنك وضع رمز QR ثاني على الطاولات برابط البوت:
https://t.me/YourBot/menu?startapp=lnc2w74z
التحقق من التشغيل#
- افتح الرابط
https://t.me/YourBot/menuعلى الهاتف - اضغط Start (إذا كنت تفتح البوت لأول مرة)
- اضغط على زر 📋 القائمة في شريط الدردشة السفلي
- تأكد من أن التطبيق قد فتح وحمل القائمة
- حاول فتح الرابط العميق:
https://t.me/YourBot/menu?startapp=LOCATION_ID
المشاكل الشائعة#
| المشكلة | الحل |
|---|---|
| التطبيق لا يفتح | تحقق من أن النطاق cenaly.com مسموح به عبر /setdomain |
| شاشة بيضاء | تأكد من أن رابط تطبيق الويب محدد كـ https://cenaly.com (HTTPS ضروري) |
startapp لا يعمل |
تحقق من الصيغة: LOCATION_ID (بدون مسافات، أو رموز خاصة). الفاصل للغة هو خطين سفليين __ |
| الموضوع لا يطبق | يجب أن يكون SDK لتطبيق Telegram Mini App متصلًا (قم بتحديث تطبيق العميل) |