Telegram Mini App — Udhëzues hap pas hapi

Çfarë është?

Telegram Mini App u mundëson klientëve tuaj të hapin menunë dixhitale të restorantit direkt brenda Telegram — pa instaluar aplikacione dhe pa kaluar në shfletues. Menuja duket si një pjesë native e Telegram: përshtatet me temën e përdoruesit, mbështet butonin «Kthehu» dhe gjestet.

Avantazhet

• 📱 Brenda Telegram — klientit nuk i duhet të kalojë në shfletues
• 🎨 Pamje native — ngjyrat, fontet dhe tema përshtaten me Telegram
• 🔗 Deep Links — link direkt për menunë e një restoranti specifik
• 🌍 Gjuha automatike — gjuha merret nga cilësimet e Telegram të përdoruesit
• 🍪 Pa cookies — baneri i cookies nuk shfaqet brenda Telegram

Fillimi i shpejtë

Hapi 1 — Krijoni botin

Hapni @BotFather në Telegram dhe dërgoni:

/newbot

1. Vendosni emrin e botit (për shembull, Meni Menu Bot)
2. Vendosni username (për shembull, MeniMenuBot) — duhet të përfundojë me Bot
3. Ruani Bot Token e marrë (formati: 123456789:ABCdefGHI...)

💡 Nëse boti është krijuar tashmë, kaloni te Hapi 2.

Pse nevojitet Bot Token?

Bot Token është një çelës sekret për menaxhimin programatik të botit përmes Telegram Bot API. Për konfigurimin bazë të Mini App (hapat 2–4) ai nuk kërkohet — gjithçka bëhet përmes BotFather. Por ai do t'ju nevojitet nëse dëshironi të:

• Dërgoni mesazhe klientëve — njoftime për statusin e order, oferta, mesazhe mirëseardhjeje
• Shtoni butona inline në mesazhet e botit (për shembull, butonin "📋 Hap menu" — shihni seksionin më poshtë)
• Krijoni një Telegram bot për pranimin e order — boti mund të marrë dhe të përpunojë order
• Konfiguroni Webhook — të merrni ngjarje nga Telegram (shtypje butonash, komanda përdoruesi)
• Integroni me CRM ose sistemin POS — përpunim automatik i order përmes botit

🔒 Mos e publikoni Bot Token — kushdo që ka token-in mund të menaxhojë botin tuaj. Nëse token-i është komprometuar, revokojeni atë me komandën /revoke në BotFather.

Hapi 2 — Krijoni Mini App

Dërgoni komandën te BotFather:

/newapp

1. Zgjidhni botin nga lista
2. Title — emri i aplikacionit (për shembull, Meni)
3. Description — përshkrimi (për shembull, Digital restaurant menu)
4. Photo — ngarkoni një imazh 640×640 px (ikona e aplikacionit)
5. GIF — animacion (opsionale). Për ta kapërcyer, dërgoni /empty
6. Web App URL — specifikoni adresën e aplikacionit tuaj të klientit:

https://menugo.al

7. Short Name — emri i shkurtër për linkun (për shembull, menu)

Pas kësaj do të keni një link funksional të llojit:

https://t.me/YourBot/menu

Hapi 3 — Shtoni butonin "Menu" në bisedën e botit

Dërgoni te BotFather:

/setmenubutton

1. Zgjidhni botin
2. Dërgoni URL-në:

https://menugo.al

3. Vendosni tekstin e butonit (për shembull, Open Menu ose 📋 Menu)

Tani, kur hapni bisedën me botin, në fund të ekranit do të shfaqet një buton që hap aplikacionin tuaj.

Hapi 4 — Autorizoni domenin

Dërgoni te BotFather:

/setdomain

Zgjidhni botin dhe specifikoni domenin:

menugo.al

Kjo do të lejojë Telegram Web App të funksionojë në domenin tuaj dhe në të gjithë nëndomenet e tij (për shembull, locationid.menugo.al).

Deep Links — lidhje për një restorant specifik

Telegram mbështet parametrin startapp, i cili i kalohet aplikacionit gjatë hapjes. Përdoreni atë për lidhje me një restorant specifik:

Shembuj

Nëse LOCATION_ID i restorantit tuaj është lnc2w74z:

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

📌 LOCATION_ID është identifikuesi i vendndodhjes suaj në menugo.al. Mund ta gjeni atë në panelin e administrimit ose në një URL të llojit https://LOCATION_ID.menugo.al.

Butonat inline nga boti

Nëse boti juaj u dërgon mesazhe klientëve, ju mund të shtoni një buton inline që do të hapë menunë:

Opsioni 1 — Butoni Web App (hapet menjëherë)

{
  "inline_keyboard": [[{
    "text": "📋 Открыть меню",
    "web_app": {
      "url": "https://LOCATION_ID.menugo.al/ru"
    }
  }]]
}

Opsioni 2 — Butoni Deep Link

{
  "inline_keyboard": [[{
    "text": "📋 Открыть меню",
    "url": "https://t.me/YourBot/menu?startapp=LOCATION_ID__ru"
  }]]
}

Çfarë funksionon automatikisht

Pas lidhjes, brenda Telegram aktivizohen automatikisht:

Kodet QR për restorante

Kodet QR ekzistuese me URL të llojit https://lnc2w74z.menugo.al do të vazhdojnë të funksionojnë si zakonisht — përmes shfletuesit.

Për integrim shtesë me Telegram, mund të vendosni nëpër tavolina një kod të dytë QR me një link për te boti:

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

Verifikimi i funksionimit

1. Hapni linkun https://t.me/YourBot/menu në telefon
2. Klikoni Start (nëse e hapni bot-in për herë të parë)
3. Klikoni butonin 📋 Menu në panelin e poshtëm të bisedës
4. Sigurohuni që aplikacioni është hapur dhe ka ngarkuar menunë
5. Provoni të hapni deep link-un: https://t.me/YourBot/menu?startapp=LOCATION_ID

Problemet e shpeshta

Linke të dobishme

• Dokumentacioni i Telegram Mini Apps
• BotFather
• Telegram Bot API — Butonat e Web App