Telegram Mini App — vodič korak po korak

Šta je to?#

Telegram Mini App omogućava vašim klijentima da otvore digitalni meni restorana direktno unutar Telegrama — bez instaliranja aplikacija i bez prelaska u pregledač. Cenaly izgleda kao native deo Telegrama: prilagođava se temi korisnika, podržava dugme „Nazad“ i gestove.

Prednosti#

• 📱 Unutar Telegrama — klijent ne mora da prelazi u pregledač
• 🎨 Native izgled — boje, fontovi i tema se prilagođavaju Telegramu
• 🔗 Deep Links — direktan link na meni konkretnog restorana
• 🌍 Automatski jezik — jezik se preuzima iz Telegram podešavanja korisnika
• 🍪 Bez kolačića — baner sa kolačićima se ne prikazuje unutar Telegrama

Najbrži put — čarobnjak u panelu#

U admin panelu: Prodavnica aplikacija → kartica „Prodavnica u Telegramu“ → „Podesi“ (prozor se otvara direktno na izlogu, nigde ne morate da idete). Čarobnjak će vas provesti kroz četiri koraka i većinu posla obaviti sam:

1. Naziv prodavnice.
2. Kreiranje bota u @BotFather i provera tokena — token jednostavno nalepite u čarobnjak.
3. Automatsko podešavanje bota: ime, kratak opis, dugme „Cenaly“ sa linkom na vaš meni, webhook i komande — Cenaly sve postavlja preko Telegram Bot API-ja, ništa ne morate ručno da pritiskate.
4. Kreiranje Mini App-a (/newapp u BotFather-u) i link vaše prodavnice.

Napredak se čuva: čarobnjak možete zatvoriti i nastaviti kasnije.

U nastavku je ručni put: isto sve u potpunosti preko BotFather-a. Poslužiće ako je bot već podešen na svoj način ili ako želite da razumete šta se tačno dešava.

Brzi start (ručno)#

Korak 1 — Napravite bota#

Otvorite @BotFather u Telegramu i pošaljite:

/newbot

1. Unesite ime bota (na primer, Cenaly Menu Bot)
2. Unesite username (na primer, MeniMenuBot) — mora da se završava sa Bot
3. Sačuvajte dobijeni Bot Token (format: 123456789:ABCdefGHI...)

Zašto je potreban Bot Token?#

Bot Token je tajni ključ za programsko upravljanje botom preko Telegram Bot API-ja. Ako sve radite ručno preko BotFather-a (koraci 2–4), on nije potreban.

Token je potreban da biste predali bota Cenaly-ju — tada ga panel sam podešava i bot počinje da radi za vas:

• Pozdrav i dugme „Cenaly“ — bot pozdravlja na jeziku gosta, uzimajući u obzir delatnost (restoran, salon, hotel, prodavnica), i otvara izlog kao Mini App
• Podsetnici o terminu — gost se prijavljuje za podsetnik o poseti i potvrđuje ili otkazuje ga dugmetom „✅ Dolazim“ / „❌ Otkaži“ direktno u ćaskanju
• Obaveštenja vlasniku — novi termini i otkazivanja stižu u vaše lično ćaskanje sa botom. Pretplata se uključuje privatnim linkom oblika t.me/{бот}?start=admin_…: prikazuje se u čarobnjaku na koraku „Gotovo“ i u kartici integracije. Link ne objavljujte — obaveštenja će početi da prima svako ko ga otvori. (Gost, sa svoje strane, može da pogleda svoje predstojeće termine komandom /bookings u ćaskanju sa botom.)
• Prepiska sa gostima — posebnim kanalom u odeljku „Radno ćaskanje“ → sekcija „Gosti“: poruke iz Telegrama padaju u zajednički inbox zajedno sa ćaskanjem sa sajta, WhatsApp-om, Instagram-om i imejlom (za to je potreban sopstveni bot — jedan bot može da ima samo jedan webhook)

A token će vam koristiti i ako poželite da automatizujete nešto svoje: da šaljete poruke klijentima, dodajete inline dugmad u poruke bota (videti odeljak ispod) ili da ga povežete sa svojim sistemom.

Korak 2 — Napravite Mini App#

Pošaljite BotFather-u komandu:

/newapp

1. Izaberite bota sa liste
2. Title — naziv aplikacije (na primer, Cenaly)
3. Description — opis (na primer, Digital restaurant menu)
4. Photo — otpremite sliku 640×640 px (ikona aplikacije)
5. GIF — animacija (nije obavezno). Da biste preskočili, pošaljite /empty
6. Web App URL — navedite adresu vaše klijentske aplikacije:

https://cenaly.com

7. Short Name — kratko ime za link (na primer, menu)

Nakon toga dobićete radni link oblika:

https://t.me/YourBot/menu

Korak 3 — Dodajte dugme „Cenaly“ u ćaskanje bota#

Pošaljite BotFather-u:

/setmenubutton

1. Izaberite bota
2. Pošaljite URL:

https://cenaly.com

3. Unesite tekst dugmeta (na primer, Open Menu ili 📋 Мени)

Sada će se pri otvaranju ćaskanja sa botom na dnu ekrana pojaviti dugme koje otvara vašu aplikaciju.

Korak 4 — Dozvolite domen#

Pošaljite BotFather-u:

/setdomain

Izaberite bota i navedite domen:

cenaly.com

To će dozvoliti Telegram Web App-u da radi na vašem domenu i svim njegovim poddomenima (na primer, locationid.cenaly.com).

Deep Links — linkovi na konkretan restoran#

Telegram podržava parametar startapp, koji se prosleđuje aplikaciji pri otvaranju. Koristite ga za linkove na konkretan restoran:

Primeri#

Ako je LOCATION_ID vašeg restorana — lnc2w74z:

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

Inline dugmad iz bota#

Ako vaš bot šalje poruke klijentima, možete dodati inline dugme koje otvara meni:

Varijanta 1 — Web App dugme (otvara se odmah)#

{
  "inline_keyboard": [[{
    "text": "📋 Otvori meni",
    "web_app": {
      "url": "https://LOCATION_ID.cenaly.com/ru"
    }
  }]]
}

Varijanta 2 — Deep Link dugme#

{
  "inline_keyboard": [[{
    "text": "📋 Otvori meni",
    "url": "https://t.me/YourBot/menu?startapp=LOCATION_ID__ru"
  }]]
}

Šta radi automatski#

Nakon povezivanja, unutar Telegrama se automatski uključuju:

QR kodovi za restorane#

Postojeći QR kodovi sa URL-om oblika https://lnc2w74z.cenaly.com nastavljaju da rade kao i obično — preko pregledača.

Za dodatnu integraciju sa Telegramom možete na stolove postaviti drugi QR kod sa linkom ka botu:

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

Provera funkcionalnosti#

1. Otvorite link https://t.me/YourBot/menu na telefonu
2. Pritisnite Start (ako prvi put otvarate bota)
3. Pritisnite dugme 📋 Cenaly u donjoj traci ćaskanja
4. Uverite se da se aplikacija otvorila i učitala meni
5. Pokušajte da otvorite deep link: https://t.me/YourBot/menu?startapp=LOCATION_ID

Česti problemi#

Korisni linkovi#

• Dokumentacija Telegram Mini Apps
• BotFather
• Telegram Bot API — Web App dugmad