Telegram Mini App — चरण-दर-चरण मार्गदर्शिका
यह क्या है?#
Telegram Mini App आपके ग्राहकों को रेस्तरां का डिजिटल मेनू सीधे Telegram के अंदर खोलने की अनुमति देता है — बिना ऐप इंस्टॉल किए और बिना ब्राउज़र में जाए। मेनू Telegram का एक मूल भाग जैसा दिखता है: यह उपयोगकर्ता की थीम के अनुसार समायोजित होता है, बैक बटन और जेस्चर का समर्थन करता है।
लाभ#
- 📱 Telegram के अंदर — ग्राहक को ब्राउज़र पर स्विच करने की आवश्यकता नहीं है
- 🎨 मूल दृश्य — रंग, फ़ॉन्ट और थीम Telegram के अनुसार समायोजित होते हैं
- 🔗 डीप लिंक — विशिष्ट रेस्तरां के मेनू का सीधा लिंक
- 🌍 स्वतः भाषा — भाषा उपयोगकर्ता के Telegram सेटिंग्स से ली जाती है
- 🍪 बिना कुकीज — कुकी बैनर Telegram के अंदर नहीं दिखाया जाता
त्वरित प्रारंभ#
चरण 1 — बॉट बनाएं#
Telegram में @BotFather खोलें और भेजें:
/newbot
- बॉट का नाम दर्ज करें (उदाहरण के लिए,
Cenaly Menu Bot) - उपयोगकर्ता नाम दर्ज करें (उदाहरण के लिए,
MeniMenuBot) — इसेBotपर समाप्त होना चाहिए - प्राप्त Bot Token सहेजें (प्रारूप:
123456789:ABCdefGHI...)
Bot Token की आवश्यकता क्यों है?#
Bot Token बॉट को Telegram Bot API के माध्यम से प्रोग्रामेटिक रूप से प्रबंधित करने के लिए एक गुप्त कुंजी है। Mini App की बुनियादी सेटिंग (चरण 2–4) के लिए यह आवश्यक नहीं है — सब कुछ BotFather के माध्यम से किया जाता है। लेकिन यह आवश्यक होगा यदि आप चाहते हैं:
- ग्राहकों को संदेश भेजें — ऑर्डर की स्थिति, प्रचार, स्वागत संदेश
- इनलाइन बटन जोड़ें बॉट संदेशों में (उदाहरण के लिए, बटन "📋 मेनू खोलें" — नीचे देखें)
- ऑर्डर प्राप्त करने के लिए Telegram बॉट बनाएं — बॉट ऑर्डर प्राप्त और संसाधित कर सकता है
- Webhook सेट करें — Telegram से घटनाएं प्राप्त करें (बटन क्लिक, उपयोगकर्ता कमांड)
- CRM या POS सिस्टम के साथ एकीकृत करें — बॉट के माध्यम से ऑर्डर की स्वचालित प्रक्रिया
चरण 2 — Mini App बनाएं#
BotFather को कमांड भेजें:
/newapp
- सूची से बॉट चुनें
- Title — ऐप का नाम (उदाहरण के लिए,
Cenaly) - Description — विवरण (उदाहरण के लिए,
डिजिटल रेस्तरां मेनू) - Photo — 640×640 px की छवि अपलोड करें (ऐप आइकन)
- GIF — एनीमेशन (वैकल्पिक)। छोड़ने के लिए,
/emptyभेजें - Web App URL — अपने क्लाइंट ऐप का पता दर्ज करें:
https://cenaly.com
- Short Name — लिंक के लिए छोटा नाम (उदाहरण के लिए,
menu)
इसके बाद, आपके पास निम्नलिखित प्रकार की कार्यशील लिंक होगी:
https://t.me/YourBot/menu
चरण 3 — बॉट चैट में "मेनू" बटन जोड़ें#
BotFather को भेजें:
/setmenubutton
- बॉट चुनें
- URL भेजें:
https://cenaly.com
- बटन का पाठ दर्ज करें (उदाहरण के लिए,
Open Menuया📋 मेनू)
अब जब आप बॉट के साथ चैट खोलते हैं, तो स्क्रीन के नीचे एक बटन दिखाई देगा जो आपके ऐप को खोलता है।
चरण 4 — डोमेन की अनुमति दें#
BotFather को भेजें:
/setdomain
बॉट चुनें और डोमेन दर्ज करें:
cenaly.com
यह आपके डोमेन और उसके सभी उपडोमेन (उदाहरण के लिए, locationid.cenaly.com) पर Telegram Web App को काम करने की अनुमति देगा।
डीप लिंक — विशिष्ट रेस्तरां के लिए लिंक#
Telegram startapp पैरामीटर का समर्थन करता है, जो ऐप खोलते समय पास किया जाता है। विशिष्ट रेस्तरां के लिए लिंक के लिए इसका उपयोग करें:
| लिंक | क्या खुलेगा |
|---|---|
t.me/YourBot/menu |
मुख्य पृष्ठ |
t.me/YourBot/menu?startapp=LOCATION_ID |
विशिष्ट रेस्तरां का मेनू |
t.me/YourBot/menu?startapp=LOCATION_ID__ru |
रूसी भाषा में मेनू |
t.me/YourBot/menu?startapp=LOCATION_ID__en |
अंग्रेजी भाषा में मेनू |
उदाहरण#
यदि आपके रेस्तरां का 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 — Web App बटन (सीधे खुलता है)#
{
"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"
}]]
}
क्या स्वचालित रूप से काम करता है#
Telegram के अंदर कनेक्ट करने के बाद स्वचालित रूप से सक्षम होते हैं:
| फ़ंक्शन | विवरण |
|---|---|
| 🎨 थीम | ऐप के रंग Telegram की थीम के अनुसार समायोजित होते हैं (हल्का/गहरा) |
| ◀️ बैक बटन | उत्पाद कार्ड खोलते समय Telegram का मूल बैक बटन दिखाई देता है |
| 📏 Viewport | ऐप पूरे स्क्रीन पर फैलता है |
| 🔒 बंद होने से सुरक्षा | वर्टिकल स्वाइप से ऐप गलती से बंद नहीं होगा |
| 🌍 स्वतः भाषा | यदि स्पष्ट रूप से निर्दिष्ट नहीं है, तो भाषा Telegram प्रोफाइल से निर्धारित होती है |
| 🍪 कुकीज | Telegram के अंदर कुकी बैनर नहीं दिखाया जाता |
रेस्तरां के लिए QR कोड#
https://lnc2w74z.cenaly.com प्रकार के URL के साथ पहले से मौजूद QR कोड ब्राउज़र के माध्यम से सामान्य रूप से काम करते रहेंगे।
Telegram के साथ अतिरिक्त एकीकरण के लिए, आप तालिकाओं पर बॉट के लिंक के साथ दूसरा QR कोड रख सकते हैं:
https://t.me/YourBot/menu?startapp=lnc2w74z
कार्यक्षमता की जाँच#
- फ़ोन पर लिंक
https://t.me/YourBot/menuखोलें - Start पर क्लिक करें (यदि पहली बार बॉट खोल रहे हैं)
- चैट की निचली पैनल में 📋 मेनू बटन पर क्लिक करें
- सुनिश्चित करें कि ऐप खुला और मेनू लोड हुआ
- डीप लिंक खोलने का प्रयास करें:
https://t.me/YourBot/menu?startapp=LOCATION_ID
सामान्य समस्याएं#
| समस्या | समाधान |
|---|---|
| ऐप नहीं खुलता | सुनिश्चित करें कि डोमेन cenaly.com /setdomain के माध्यम से अनुमति प्राप्त है |
| सफेद स्क्रीन | सुनिश्चित करें कि Web App URL https://cenaly.com के रूप में निर्दिष्ट है (HTTPS आवश्यक है) |
startapp काम नहीं करता |
प्रारूप की जाँच करें: LOCATION_ID (बिना स्पेस, विशेष वर्णों के)। भाषा के लिए विभाजक — डबल अंडरस्कोर __ |
| थीम लागू नहीं होती | Telegram Mini App SDK को जोड़ा जाना चाहिए (क्लाइंट ऐप को अपडेट करें) |