telegram-mini-app
بناء تطبيقات مصغرة لتيليجرام مع تكامل TON
إنشاء تطبيقات ويب تبدو أصلية تعمل داخل تيليجرام لأكثر من 800 مليون مستخدم. دمج سلسلة كتل TON والمدفوعات والميكانيكيات الفيروسية دون مغادرة نظام تيليجرام البيئي.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "telegram-mini-app". إعداد تطبيق مصغر تيليجرام الأساسي مع تحية المستخدم
النتيجة المتوقعة:
صفحة HTML مع تحميل SDK تيليجرام وعرض اسم المستخدم الأول باستخدام initDataUnsafe.user وتكوين الزر الرئيسي بألوان سمة تيليجرام
استخدام "telegram-mini-app". إضافة اتصال محفظة TON إلى تطبيق مصغر موجود
النتيجة المتوقعة:
TonConnectUIProvider يلف التطبيق وTonConnectButton في الترويسة وملف manifest.json مع بيانات تعريف التطبيق وعنوان المحفظة متاح بعد الاتصال
التدقيق الأمني
آمنStatic analyzer flagged 41 patterns that are all false positives. The skill file (SKILL.md) is documentation-only markdown containing code examples. Backticks are markdown code fences, not shell execution. URLs are official Telegram SDK links or documentation placeholders. No executable code or security risks present.
درجة الجودة
ماذا يمكنك بناءه
تطبيق مصغري للألعاب Web3
بناء لعبة كسب مقابل اللعب مع تكامل محفظة TON ومكافآت NFT وميكانيكيات إحالة病毒ية تنتشر عبر مشاركات تيليجرام.
واجهة متجر تجارة إلكترونية
إنشاء تطبيق مصغر قابل للتسوق مع مدفوعات نجوم تيليجرام وتتبع الطلبات والدفع السلس داخل واجهة تيليجرام.
أداة مشاركة المجتمع
تطوير تطبيق ولاء ملامح مع مكافآت يومية وأيام متتالية ولوحات المتصدرين وشارات الإنجازات لتعزيز تفاعل القناة.
جرّب هذه الموجهات
إنشاء قالب HTML للتطبيق المصغر تيليجرام مع إعدادات viewport المناسبة وتهيئة SDK تطبيق ويب تيليجرام واستخراج بيانات المستخدم من initDataUnsafe.
بناء hook React لتكامل تطبيق ويب تيليجرام يعرض بيانات المستخدم ومعرف الاستعلام والطرق الأساسية مثل expand وclose وready مع أنواع TypeScript المناسبة.
تنفيذ تكامل محفظة TON Connect لتطبيق React المصغر بما في ذلك wrapper مزود واجهة المستخدم ومكون زر الاتصال وتكوين ملف البيان.
إنشاء مكون زر دفع يرسل معاملات TON باستخدام tonConnectUI ويتعامل مع تحويل النانوتون وينتهي صلاحية windows المعاملة.
أفضل الممارسات
- قم دائمًا بالتحقق من initData باستخدام التحقق من HMAC الخاص بتيليجرام على الخادم الخاص بك قبل الوثوق بهوية المستخدم
- طابق سمة تيليجرام باستخدام متغيرات CSS themeParams للحصول على مظهر أصلي سلس
- صمم للجوال أولاً بأهداف لمسية بحد أدنى 44 اختب على الأجهزة الفعلية
تجنب
- تجاهل معلمات سمة تيليجرام مما يؤدي إلى انتقالات بصرية مفاجئة
- التصميم لسطح المكتب بينما 95 بالمائة من استخدام تيليجرام للجوال
- تخطي حالات التحميل مما يجعل المستخدمين يعتقدون أن التطبيق معطل