Telegram Mini App — ধাপে ধাপে নির্দেশিকা
এটি কী?#
Telegram Mini App আপনার গ্রাহকদের Telegram এর ভিতরে সরাসরি রেস্তোরাঁর ডিজিটাল মেনু খুলতে দেয় — অ্যাপ ইনস্টল না করেই এবং ব্রাউজারে না গিয়েই। মেনুটি Telegram এর নেটিভ অংশের মতো দেখায়: ব্যবহারকারীর থিমের সাথে মানিয়ে নেয়, "পিছনে" বোতাম এবং অঙ্গভঙ্গি সমর্থন করে।
সুবিধাসমূহ#
- 📱 Telegram এর ভিতরে — গ্রাহককে ব্রাউজারে যেতে হবে না
- 🎨 নেটিভ চেহারা — রং, ফন্ট এবং থিম Telegram এর সাথে মানিয়ে নেয়
- 🔗 ডিপ লিঙ্কস — নির্দিষ্ট রেস্তোরাঁর মেনুর সরাসরি লিঙ্ক
- 🌍 স্বয়ংক্রিয় ভাষা — ভাষা ব্যবহারকারীর Telegram সেটিংস থেকে নেওয়া হয়
- 🍪 কুকিজ ছাড়া — কুকি ব্যানার Telegram এর ভিতরে দেখানো হয় না
দ্রুত শুরু#
ধাপ ১ — একটি বট তৈরি করুন#
Telegram এ @BotFather খুলুন এবং পাঠান:
/newbot
- বটের নাম লিখুন (যেমন,
Cenaly Menu Bot) - ইউজারনেম লিখুন (যেমন,
MeniMenuBot) — এটিBotদিয়ে শেষ হতে হবে - প্রাপ্ত Bot Token সংরক্ষণ করুন (ফরম্যাট:
123456789:ABCdefGHI...)
Bot Token কেন প্রয়োজন?#
Bot Token — এটি একটি গোপন চাবি যা Telegram Bot API এর মাধ্যমে বটের প্রোগ্রামেটিক নিয়ন্ত্রণের জন্য ব্যবহৃত হয়। Mini App এর মৌলিক সেটআপের জন্য (ধাপ ২–৪) এটি প্রয়োজন হয় না — সবকিছু BotFather এর মাধ্যমে করা হয়। কিন্তু এটি প্রয়োজন হবে যদি আপনি চান:
- গ্রাহকদের বার্তা পাঠান — অর্ডারের স্থিতি, প্রচার, স্বাগত বার্তা
- ইনলাইন বোতাম যোগ করুন বটের বার্তায় (যেমন, "📋 মেনু খুলুন" বোতাম — নিচের অংশ দেখুন)
- অর্ডার গ্রহণের জন্য একটি Telegram বট তৈরি করুন — বট অর্ডার গ্রহণ এবং প্রক্রিয়াকরণ করতে পারে
- Webhook সেটআপ করুন — Telegram থেকে ইভেন্ট গ্রহণ করুন (বোতাম ক্লিক, ব্যবহারকারীর কমান্ড)
- CRM বা POS সিস্টেমের সাথে ইন্টিগ্রেট করুন — বটের মাধ্যমে অর্ডারের স্বয়ংক্রিয় প্রক্রিয়াকরণ
ধাপ ২ — Mini App তৈরি করুন#
BotFather এ কমান্ড পাঠান:
/newapp
- তালিকা থেকে বট নির্বাচন করুন
- Title — অ্যাপ্লিকেশনের নাম (যেমন,
Cenaly) - Description — বর্ণনা (যেমন,
Digital restaurant menu) - Photo — 640×640 px এর একটি ছবি আপলোড করুন (অ্যাপ্লিকেশনের আইকন)
- GIF — অ্যানিমেশন (ঐচ্ছিক)। বাদ দিতে
/emptyপাঠান - Web App URL — আপনার ক্লায়েন্ট অ্যাপ্লিকেশনের ঠিকানা দিন:
https://cenaly.com
- Short Name — লিঙ্কের জন্য সংক্ষিপ্ত নাম (যেমন,
menu)
এরপর আপনার কাছে একটি কার্যকরী লিঙ্ক থাকবে:
https://t.me/YourBot/menu
ধাপ ৩ — বট চ্যাটে "মেনু" বোতাম যোগ করুন#
BotFather এ পাঠান:
/setmenubutton
- বট নির্বাচন করুন
- URL পাঠান:
https://cenaly.com
- বোতামের টেক্সট লিখুন (যেমন,
Open Menuবা📋 মেনু)
এখন বটের সাথে চ্যাট খুললে স্ক্রিনের নিচে একটি বোতাম দেখা যাবে যা আপনার অ্যাপ্লিকেশন খুলবে।
ধাপ ৪ — ডোমেন অনুমোদন করুন#
BotFather এ পাঠান:
/setdomain
বট নির্বাচন করুন এবং ডোমেন দিন:
cenaly.com
এটি আপনার ডোমেন এবং এর সমস্ত সাবডোমেনে Telegram Web App কাজ করতে অনুমতি দেবে (যেমন, locationid.cenaly.com)।
Deep Links — নির্দিষ্ট রেস্তোরাঁর লিঙ্ক#
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
বট থেকে ইনলাইন বোতাম#
যদি আপনার বট গ্রাহকদের বার্তা পাঠায়, আপনি একটি ইনলাইন বোতাম যোগ করতে পারেন যা মেনু খুলবে:
বিকল্প ১ — Web App বোতাম (সরাসরি খোলে)#
{
"inline_keyboard": [[{
"text": "📋 মেনু খুলুন",
"web_app": {
"url": "https://LOCATION_ID.cenaly.com/ru"
}
}]]
}
বিকল্প ২ — Deep Link বোতাম#
{
"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 সংযুক্ত থাকতে হবে (ক্লায়েন্ট অ্যাপ্লিকেশন আপডেট করুন) |