تطبيقات Telegram المصغرة

Telegram Mini Apps (TMA) — منصة مفتوحة لتشغيل تطبيقات ويب وألعاب داخل Telegram. تُبنى التطبيقات على مجموعة تقنيات HTML/CSS/JavaScript القياسية، تُفتح عبر رابط من الدردشة أو زر البوت وتستفيد من إمكانات المراسِل المدمجة: التفويض، المدفوعات، تبادل الوسائط، إرسال النجوم والهدايا.

أصبحت المنصة نقطة دخول رئيسية إلى نظام TON — أغلب مستخدمي تطبيقات TON يرون dApp لأول مرة كـ Mini App، وليس كموقع ويب أو تطبيق موبايل.

الخصائص#

عميل واحد. يعمل Mini App داخل تطبيق Telegram نفسه حيث يكون المستخدم مُفوضًا بالفعل — على Android و iOS و Windows و macOS و Linux.
حاجز منخفض. مجموعة تقنيات ويب مألوفة، لا حاجة للنشر في متاجر التطبيقات، تحديث فوري: يكفي نشر نسخة جديدة.
تفويض بدون seed‑phrase. عبر TON Connect يتصل التطبيق بمحفظة المستخدم ويطلب توقيعًا دون نقل المفاتيح الخاصة.
مدفوعات. تدعم المدفوعات المشفرة بـ TON و Jettons، بالإضافة إلى العملة الداخلية لـ Telegram — Stars.
البوت كخادم. عادةً ما يعمل Mini App مع بوت Telegram: يحتفظ البوت بالحالة، يرسل الإشعارات، ويُطلق الحوار.

كيفية إنشاء Mini App#

المسار الكامل لإطلاق التطبيق:

إنشاء بوت Telegram عبر BotFather بالأمر /newbot.
تسجيل Mini App: الأمر /newapp في BotFather، اختيار البوت المُنشأ مسبقًا وربط التطبيق به. بعد التسجيل يصبح Mini App متاحًا عبر الرابط https://t.me/{bot}/{app}.
نشر تطبيق الويب عبر HTTPS بشهادة SSL صالحة. في بيئة الاختبار يمكن استخدام IP، لكن في الإنتاج سيُرفض أي مخطط آخر من قبل Telegram.
ربط زر التشغيل: الأمر /setmenubutton يضيف Mini App إلى زر قائمة البوت. البديل — رابط مباشر عبر /myapps → Edit link.

بعد ذلك يصبح التطبيق متاحًا من زر القائمة، أو عبر الرابط المباشر، أو من أي دردشة تم فيها مشاركة الدعوة.

المدفوعات والتسويق#

يمكن لـ Mini App تحقيق إيرادات بطرق متعددة:

مشتريات داخل اللعبة واشتراكات — بـ Stars أو بـ TON عبر معاملات موقعة؛
مدفوعات عملات مشفرة — يوافق المستخدم على المعاملة في المحفظة المتصلة (Tonkeeper، Wallet، MyTonWallet وغيرها) عبر TON Connect؛
إعلانات وشراكات — تتبع خاص عبر start_param، رموز إحالة، دفعات عبر TON.

لترويج مشاريع TON تتوفر شبكة إعلانات Telegram Ads. الإعلانات لا تستخدم بيانات شخصية للمستخدم — الاستهداف يتم حسب محتوى القناة. يمكن دفع الميزانية مباشرةً بـ TON.

الكاتالوج والترويج#

Telegram Apps Center — كاتالوج لتطبيقات وبوتات الطرف الثالث؛ موجود على tapps.center.
Trending Apps (t.me/trendingapps) — قناة تنشر تطبيقات TMA الجديدة والتحديثات الكبيرة؛ تُدار من قبل المجتمع.
The Open League (Open_league_bot) — تطبيق يجمع المشاريع المشاركة في برنامج المنح والحوافز المماثل؛ يوفر روابط مباشرة إلى تجمّعات STON.fi و DeDust.

تطبيقات معروفة#

Notcoin و Hamster Kombat — ألعاب tap‑to‑earn، سجّلت أعلى وصول في فئة TMA؛
Wallet — محفظة مدمجة في Telegram تدعم العملات المشفرة، سوق P2P، وتعدد الشيكات؛
STON.fi — DEX على TON بواجهة تعمل داخل Telegram؛
DeDust — ثاني أكبر DEX في نظام TON مع واجهة Mini App؛
Getgems — سوق NFT مع نسخة Mini App.

Telegram Mini Apps 2.0#

في نوفمبر 2024 أصدرت Telegram تحديثًا كبيرًا للمنصة، موسِّعًا إمكاناتها إلى مستوى التطبيقات الأصلية:

وضع ملء الشاشة في الوضعين العمودي والأفقي؛
الوصول إلى المستشعرات — مقياس التسارع والجيروسكوب للتحكم في الألعاب؛
اختصار على الشاشة الرئيسية — يمكن وضع Mini App بجوار التطبيقات العادية؛
الموقع الجغرافي — خرائط، ألعاب جغرافية، بحث محلي؛
ملصقات وTON Gifts — إرسال هدايا وإنجازات بـ Stars مباشرة من الدردشة؛
حالات إيموجي لـ Premium — تعيينها عبر التطبيق؛
ملفات ووسائط — إنشاء ملفات، بطاقات إحالة، ميمات؛
اشتراكات — تحقيق دخل متكرر بـ Stars؛
تخصيص شاشة التحميل؛
معلومات موسعة عن الجهاز — لتكييف الرسوميات والأداء.

ينقل هذا التحديث بعض أنماط UX من أنظمة تشغيل الهواتف إلى Telegram، مما يجعل Mini App واجهة تنافسية للمحافظ المشفرة، الألعاب، والتجارة الاجتماعية.

سياسة البلوك تشين في Telegram#

نشرت Telegram إرشادات حول العمل مع البلوك تشين في البوتات وMini Apps. القواعد الأساسية:

استخدام TON فقط لإصدار وتوزيع الرموز أو الأصول البلوك تشين؛
ربط المحافظ فقط عبر TON Connect؛
عدم الترويج لمحافظ غير مبنية على TON ولا تستخدم TON Connect.

انتهاك هذه القواعد قد يؤدي إلى حظر Mini App في كاتالوجات الخاصة بـ Telegram.

أدوات المطور#

@twa-dev/sdk و @telegram-apps/sdk — SDK رسمية/مجتمعية للعمل مع Telegram WebApp API؛
@tonconnect/ui-react — طبقة UI جاهزة لربط المحفظة داخل TMA؛
الوثائق:
- core.telegram.org/bots/webapps — مواصفات WebApp API،
- docs.telegram-mini-apps.com — وثائق مجتمع موسَّعة،
- docs.ton.org/develop/dapps/telegram-apps/ — دليل التكامل من TON Foundation.