مینی‌اپ‌های تلگرام (TMA) تحولی بزرگ در تعامل کاربران ایجاد کرده‌اند. کاربران بدون نیاز به نصب هیچ اپلیکیشن مجزا، مستقیماً داخل تلگرام به محیط‌های وب‌اپلیکیشن تمام‌عیار دسترسی دارند.

۱. راه‌اندازی SDK تلگرام وب‌اپ

برای شروع کافیست اسکریپت رسمی تلگرام را در هدر سند HTML خود لود کنید:

<script src="https://telegram.org/js/telegram-web-app.js"></script>
<script>
  window.Telegram.WebApp.ready();
  window.Telegram.WebApp.expand();
</script>

۲. اعتبارسنجی امنیت با initData

برای اطمینان از اینکه داده‌های کاربر دستکاری نشده‌اند، رشته Telegram.WebApp.initData را به بک‌اند خود فرستاده و با هش HMAC-SHA256 توکن ربات خود تایید کنید.

هشدار امنیتی: هرگز به شناسه کاربر ارسال شده به تنهایی اعتماد نکنید. همواره رشته initData را با الگوریتم رمزنگاری رسمی تلگرام سمت سرور اعتبارسنجی نمایید.

۳. کنترل المان‌های نیتیو: دکمه MainButton و بازخورد لمسی (Haptic)

شما می‌توانید دکمه اصلی پایین صفحه تلگرام و لرزش‌های بازخورد لمسی را به شکل زیر کنترل کنید:

const tg = window.Telegram.WebApp;

tg.MainButton.setText('تایید و پرداخت');
tg.MainButton.show();
tg.MainButton.onClick(() => {
  tg.HapticFeedback.impactOccurred('medium');
  tg.sendData(JSON.stringify({ action: 'checkout_success' }));
});

نیاز به توسعه مینی‌اپ اختصاصی دارید؟

متخصصان زنتری اپلیکیشن تلگرامی شما را با بالاترین استانداردهای روز می‌سازند.