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, Cenaly Menu Bot)
2. Vendosni username (për shembull, MeniMenuBot) — duhet të përfundojë me Bot
3. Ruani Bot Token e marrë (formati: 123456789:ABCdefGHI...)

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

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, Cenaly)
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://cenaly.com

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://cenaly.com

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:

cenaly.com

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

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

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.cenaly.com/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.cenaly.com 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