Telegram Mini App — مرحلہ وار رہنمائی

یہ کیا ہے؟#

Telegram Mini App آپ کے گاہکوں کو ٹیلیگرام کے اندر ہی ریستوران کا ڈیجیٹل مینو کھولنے کی اجازت دیتا ہے — بغیر کسی ایپ کی تنصیب کے اور بغیر براؤزر میں جانے کے۔ مینو ٹیلیگرام کا ایک مقامی حصہ نظر آتا ہے: صارف کی تھیم کے مطابق ڈھل جاتا ہے، "واپس" بٹن اور اشاروں کی حمایت کرتا ہے۔

فوائد#

• 📱 ٹیلیگرام کے اندر — گاہک کو براؤزر پر سوئچ کرنے کی ضرورت نہیں
• 🎨 مقامی نظر — رنگ، فونٹس اور تھیم ٹیلیگرام کے مطابق ڈھل جاتے ہیں
• 🔗 ڈیپ لنکس — مخصوص ریستوران کے مینو کا براہ راست لنک
• 🌍 خودکار زبان — زبان صارف کے ٹیلیگرام کی ترتیبات سے لی جاتی ہے
• 🍪 بغیر کوکیز — کوکی بینر ٹیلیگرام کے اندر نہیں دکھایا جاتا

فوری آغاز#

مرحلہ 1 — بوٹ بنائیں#

ٹیلیگرام میں @BotFather کھولیں اور بھیجیں:

/newbot

1. بوٹ کا نام درج کریں (مثال کے طور پر، Cenaly Menu Bot)
2. یوزر نیم درج کریں (مثال کے طور پر، MeniMenuBot) — Bot پر ختم ہونا چاہیے
3. موصولہ Bot Token محفوظ کریں (فارمیٹ: 123456789:ABCdefGHI...)

Bot Token کی ضرورت کیوں ہے؟#

Bot Token — بوٹ کو Telegram Bot API کے ذریعے پروگراماتی طور پر کنٹرول کرنے کے لیے ایک خفیہ کلید ہے۔ Mini App کی بنیادی ترتیب (مرحلے 2–4) کے لیے یہ ضروری نہیں — سب کچھ BotFather کے ذریعے کیا جاتا ہے۔ لیکن یہ ضروری ہوگا، اگر آپ چاہیں:

• گاہکوں کو پیغامات بھیجیں — آرڈر کی حیثیت کے بارے میں اطلاعات، پروموشنز، خوش آمدید پیغامات
• بوٹ پیغامات میں ان لائن بٹن شامل کریں (مثال کے طور پر، "📋 مینو کھولیں" بٹن — نیچے سیکشن دیکھیں)
• آرڈرز وصول کرنے کے لیے ٹیلیگرام بوٹ بنائیں — بوٹ آرڈرز وصول اور پروسیس کر سکتا ہے
• Webhook ترتیب دیں — ٹیلیگرام سے ایونٹس وصول کریں (بٹن کلکس، صارف کمانڈز)
• CRM یا POS سسٹم کے ساتھ انضمام کریں — بوٹ کے ذریعے آرڈرز کی خودکار پروسیسنگ

مرحلہ 2 — Mini App بنائیں#

BotFather کو کمانڈ بھیجیں:

/newapp

1. بوٹ منتخب کریں فہرست سے
2. Title — ایپلیکیشن کا نام (مثال کے طور پر، Cenaly)
3. Description — وضاحت (مثال کے طور پر، Digital restaurant menu)
4. Photo — 640×640 px کی تصویر اپ لوڈ کریں (ایپلیکیشن آئیکن)
5. GIF — اینیمیشن (اختیاری)۔ چھوڑنے کے لیے، /empty بھیجیں
6. Web App URL — اپنے کلائنٹ ایپلیکیشن کا پتہ درج کریں:

https://cenaly.com

7. Short Name — لنک کے لیے مختصر نام (مثال کے طور پر، menu)

اس کے بعد آپ کے پاس ایک فعال لنک ہوگا:

https://t.me/YourBot/menu

مرحلہ 3 — بوٹ چیٹ میں "مینو" بٹن شامل کریں#

BotFather کو بھیجیں:

/setmenubutton

1. بوٹ منتخب کریں
2. URL بھیجیں:

https://cenaly.com

3. بٹن کا متن درج کریں (مثال کے طور پر، Open Menu یا 📋 مینو)

اب جب آپ بوٹ کے ساتھ چیٹ کھولیں گے، تو اسکرین کے نیچے ایک بٹن ظاہر ہوگا جو آپ کی ایپلیکیشن کھولے گا۔

مرحلہ 4 — ڈومین کی اجازت دیں#

BotFather کو بھیجیں:

/setdomain

بوٹ منتخب کریں اور ڈومین درج کریں:

cenaly.com

یہ ٹیلیگرام ویب ایپ کو آپ کے ڈومین اور اس کے تمام سب ڈومینز پر کام کرنے کی اجازت دے گا (مثال کے طور پر، locationid.cenaly.com).

Deep Links — مخصوص ریستوران کے لنکس#

ٹیلیگرام startapp پیرامیٹر کی حمایت کرتا ہے، جو ایپلیکیشن کو کھولتے وقت منتقل کیا جاتا ہے۔ اسے مخصوص ریستوران کے لنکس کے لیے استعمال کریں:

مثالیں#

اگر آپ کے ریستوران کا 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"
  }]]
}

کیا خود بخود کام کرتا ہے#

ٹیلیگرام کے اندر کنکشن کے بعد خود بخود فعال ہو جاتے ہیں:

ریستورانوں کے لیے QR کوڈز#

پہلے سے موجود QR کوڈز https://lnc2w74z.cenaly.com کے URL کے ساتھ معمول کے مطابق کام کرتے رہیں گے — براؤزر کے ذریعے۔

ٹیلیگرام کے ساتھ اضافی انضمام کے لیے، آپ میزوں پر بوٹ کے لنک کے ساتھ دوسرا QR کوڈ رکھ سکتے ہیں:

https://t.me/YourBot/menu?startapp=lnc2w74z

کارکردگی کی جانچ#

1. فون پر لنک https://t.me/YourBot/menu کھولیں
2. Start دبائیں (اگر پہلی بار بوٹ کھول رہے ہیں)
3. چیٹ کی نچلی پینل میں 📋 مینو بٹن دبائیں
4. یقینی بنائیں کہ ایپلیکیشن کھل گئی ہے اور مینو لوڈ ہو گیا ہے
5. ڈیپ لنک کھولنے کی کوشش کریں: https://t.me/YourBot/menu?startapp=LOCATION_ID

عام مسائل#

مفید لنکس#

• ٹیلیگرام Mini Apps دستاویزات
• BotFather
• ٹیلیگرام Bot API — ویب ایپ بٹن