نصب روی گوشی (PWA)
نصب وب‌اپ روی صفحهٔ اصلی گوشی از داخل تلگرام، Chrome اندروید و Safari آیفون، و تغییر نام و آیکن اپ توسط ادمین.
وب‌اپ PasarguardBot یک PWA (Progressive Web App) است: می‌شود آن را روی صفحهٔ اصلی گوشی نصب کرد تا با یک آیکن جدا و بدون نوار مرورگر، مثل یک اپ معمولی باز شود. نام و آیکن این اپ را ادمین تعیین می‌کند.
پیش‌نیاز
نصب فقط وقتی کار می‌کند که وب‌اپ روی https:// در دسترس باشد. یعنی همان WEBAPP_URL با HTTPS که در دامنه و SSL تنظیم کرده‌اید.
دکمهٔ «نصب اپ روی صفحه اصلی»
در صفحهٔ پروفایل وب‌اپ، دکمهٔ نصب اپ روی صفحه اصلی هست. این دکمه فقط وقتی دیده می‌شود که دستگاه نصب خودکار را پشتیبانی کند:
| کجا باز کرده‌اید | دکمه چه می‌کند |
|---|---|
| داخل تلگرام (Mini App) | پنجرهٔ «افزودن به صفحهٔ اصلی» خود تلگرام را باز می‌کند. به نسخهٔ جدید تلگرام (Bot API 8 به بالا) نیاز دارد. اگر قبلاً اضافه کرده باشید یا تلگرام پشتیبانی نکند، دکمه نمایش داده نمی‌شود. |
| مرورگری که نصب PWA را پشتیبانی می‌کند (مثل Chrome اندروید یا Chrome/Edge دسکتاپ) | پنجرهٔ نصب مرورگر را باز می‌کند. اگر اپ از قبل نصب شده و از داخل خودش باز شده باشد، دکمه نیست. |
| Safari آیفون و مرورگرهای دیگر بدون نصب خودکار | دکمه نمایش داده نمی‌شود. از روش دستی پایین استفاده کنید. |
نصب دستی
اگر دکمه را نمی‌بینید، از منوی خود مرورگر یا تلگرام نصب کنید. مسیرها بسته به نسخهٔ گوشی و مرورگر ممکن است کمی فرق کند:
- وب‌اپ را از دکمهٔ ربات باز کنید.
- منوی سه‌نقطهٔ بالای پنجرهٔ مینی‌اپ را باز کنید.
- گزینهٔ Add to Home Screen (افزودن به صفحهٔ اصلی) را بزنید.
با این روش، آیکن مینی‌اپ را تلگرام می‌سازد و با زدن آن، اپ داخل تلگرام باز می‌شود و ورود خودکار است.
- آدرس وب‌اپ (
WEBAPP_URL) را در Chrome باز کنید و وارد شوید. - اگر پیام نصب پایین صفحه آمد، Install را بزنید. وگرنه منوی سه‌نقطهٔ بالای Chrome را باز کنید.
- Install app (نصب برنامه) یا Add to Home screen را بزنید و تأیید کنید.
- آدرس وب‌اپ را حتماً در Safari باز کنید.
- دکمهٔ Share (مربع با فلش رو به بالا) را بزنید.
- پایینتر بروید و Add to Home Screen را بزنید، بعد Add.
ورود در اپ نصب‌شده
اپی که از مرورگر نصب می‌شود (اندروید یا آیفون) مثل یک مرورگر جداست و ورود خودکار تلگرام ندارد. بار اول با شماره تلفن و کد یا کلید API وارد شوید (روش‌های ورود). بعد از آن نشست تا ۱۴ روز بی‌استفاده‌ماندن باقی می‌ماند.
تغییر نام و آیکن اپ (ادمین)
ادمین در پنل وب از مسیر تنظیمات ربات → PWA («نصب وب‌اپ (PWA)») ظاهر اپ نصبی را تعیین می‌کند:
| فیلد | کجا دیده می‌شود | پیش‌فرض |
|---|---|---|
| نام کامل اپ / تایتل سایت | تایتل تب مرورگر و نام کامل اپ هنگام نصب | PasarguardBot WebApp |
| نام کوتاه (زیر آیکن) | متن زیر آیکن روی صفحهٔ اصلی گوشی | PasarguardBot |
| توضیحات | توضیح اپ در پنجرهٔ نصب | خالی |
| آپلود آیکن | آیکن اپ روی صفحهٔ اصلی و آیکن تب مرورگر | آیکن پیش‌فرض ربات |
- برای آیکن هر عکس PNG، JPG یا WebP (حداکثر ۵ مگابایت) را آپلود کنید. ربات خودش آن را به همهٔ اندازه‌های لازم برای اندروید و iOS تبدیل می‌کند. بهتر است عکس مربعی و ساده باشد.
- بعد از ذخیره، تایتل و آیکن بلافاصله به‌روز می‌شوند. اگر تغییر را ندیدید، صفحه را یک بار رفرش کنید.
- آیکن‌های آپلودی در بکاپ دیتابیس نیستند (جزئیات). بعد از انتقال سرور، در صورت نیاز دوباره آپلود کنید.
به‌روزرسانی اپ
نصب‌کردن اپ لازم نیست دستی به‌روز شود. هر بار که ربات را آپدیت کنید، نسخهٔ جدید وب‌اپ خودکار در گوشی کاربران جایگزین می‌شود (معمولاً از باز کردن بعدی). نام و آیکنی که ادمین تغییر می‌دهد هم بدون نصب دوباره اعمال می‌شود، ولی بعضی گوشی‌ها آیکن روی صفحهٔ اصلی را با تأخیر عوض می‌کنند و گاهی لازم است اپ یک بار حذف و دوباره نصب شود.