Telegram Mini App — Ghid pas cu pas

Ce este?#

Telegram Mini App le permite clienților dumneavoastră să deschidă meniul digital al restaurantului direct în Telegram — fără instalarea de aplicații și fără a trece în browser. Meniul arată ca o parte nativă a Telegram: se adaptează la tema utilizatorului, acceptă butonul „Înapoi” și gesturile.

Avantaje#

• 📱 În interiorul Telegram — clientul nu trebuie să treacă în browser
• 🎨 Aspect nativ — culorile, fonturile și tema se adaptează la Telegram
• 🔗 Deep Links — link direct către meniul unui anumit restaurant
• 🌍 Limbă automată — limba este preluată din setările Telegram ale utilizatorului
• 🍪 Fără cookies — bannerul cookie nu este afișat în interiorul Telegram

Calea cea mai rapidă — asistentul din panou#

În panoul de administrare: Magazin de aplicații → cardul „Magazin în Telegram” → „Configurare” (fereastra se deschide direct în vitrină, nu trebuie să plecați nicăieri). Asistentul vă va ghida prin patru pași și va face singur cea mai mare parte a lucrului:

1. Numele magazinului.
2. Crearea unui bot în @BotFather și verificarea tokenului — tokenul îl lipiți pur și simplu în asistent.
3. Configurarea automată a botului: nume, descriere scurtă, butonul „Meniu” cu link către meniul dumneavoastră, webhook și comenzi — Cenaly le configurează pe toate prin Telegram Bot API, nu trebuie să apăsați nimic manual.
4. Crearea Mini App (/newapp în BotFather) și linkul magazinului dumneavoastră.

Progresul se salvează: asistentul poate fi închis și continuat mai târziu.

Mai jos este calea manuală: același lucru, în întregime prin BotFather. Vă va fi utilă dacă botul este deja configurat în felul dumneavoastră sau dacă doriți să înțelegeți ce se întâmplă exact.

Start rapid (manual)#

Pasul 1 — Creați un bot#

Deschideți @BotFather în Telegram și trimiteți:

/newbot

1. Introduceți numele botului (de exemplu, Cenaly Menu Bot)
2. Introduceți username (de exemplu, MeniMenuBot) — trebuie să se termine cu Bot
3. Salvați Bot Token-ul primit (format: 123456789:ABCdefGHI...)

De ce este necesar Bot Token?#

Bot Token este o cheie secretă pentru gestionarea programatică a botului prin Telegram Bot API. Dacă faceți totul manual prin BotFather (pașii 2–4), acesta nu este necesar.

Tokenul este necesar pentru a preda botul către Cenaly — atunci panoul îl configurează singur și botul începe să lucreze pentru dumneavoastră:

• Mesaj de întâmpinare și butonul „Meniu” — botul salută în limba oaspetelui, ținând cont de verticală (restaurant, salon, hotel, magazin), și deschide vitrina ca Mini App
• Memento-uri despre programare — oaspetele se abonează la memento-ul despre vizită și îl confirmă sau îl anulează cu butonul „✅ Vin” / „❌ Anulez” direct în chat
• Notificări pentru proprietar — programările noi și anulările ajung în chatul dumneavoastră personal cu botul. Abonamentul se activează printr-un link privat de forma t.me/{bot}?start=admin_…: acesta este afișat în asistent la pasul „Gata” și în cardul integrării. Nu publicați linkul — notificările le va primi oricine îl deschide. (Oaspetele, la rândul său, își poate vedea programările viitoare cu comanda /bookings în chatul cu botul.)
• Corespondența cu oaspeții — printr-un canal separat în secțiunea „Chat de lucru” → secțiunea „Oaspeți”: mesajele din Telegram ajung în inboxul comun împreună cu chatul site-ului, WhatsApp, Instagram și e-mail (pentru aceasta este nevoie de un bot propriu — un bot poate avea un singur webhook)

În plus, tokenul vă va fi util dacă doriți să automatizați ceva al dumneavoastră: să trimiteți mesaje clienților, să adăugați butoane inline în mesajele botului (vezi secțiunea de mai jos) sau să îl conectați la sistemul dumneavoastră.

Pasul 2 — Creați Mini App#

Trimiteți BotFather comanda:

/newapp

1. Alegeți botul din listă
2. Title — numele aplicației (de exemplu, Cenaly)
3. Description — descrierea (de exemplu, Digital restaurant menu)
4. Photo — încărcați o imagine de 640×640 px (pictograma aplicației)
5. GIF — animație (opțional). Pentru a sări peste, trimiteți /empty
6. Web App URL — indicați adresa aplicației dumneavoastră pentru clienți:

https://cenaly.com

7. Short Name — nume scurt pentru link (de exemplu, menu)

După aceasta veți avea un link funcțional de forma:

https://t.me/YourBot/menu

Pasul 3 — Adăugați butonul „Meniu” în chatul botului#

Trimiteți BotFather:

/setmenubutton

1. Alegeți botul
2. Trimiteți URL-ul:

https://cenaly.com

3. Introduceți textul butonului (de exemplu, Open Menu sau 📋 Меню)

Acum, la deschiderea chatului cu botul, în partea de jos a ecranului va apărea un buton care deschide aplicația dumneavoastră.

Pasul 4 — Autorizați domeniul#

Trimiteți BotFather:

/setdomain

Alegeți botul și indicați domeniul:

cenaly.com

Aceasta va permite Telegram Web App să funcționeze pe domeniul dumneavoastră și pe toate subdomeniile acestuia (de exemplu, locationid.cenaly.com).

Deep Links — linkuri către un anumit restaurant#

Telegram acceptă parametrul startapp, care este transmis aplicației la deschidere. Folosiți-l pentru linkuri către un anumit restaurant:

Exemple#

Dacă LOCATION_ID al restaurantului dumneavoastră este lnc2w74z:

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

Butoane inline din bot#

Dacă botul dumneavoastră trimite mesaje clienților, puteți adăuga un buton inline care deschide meniul:

Varianta 1 — buton Web App (se deschide imediat)#

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

Varianta 2 — buton Deep Link#

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

Ce funcționează automat#

După conectare, în interiorul Telegram se activează automat:

Coduri QR pentru restaurante#

Codurile QR existente cu URL de forma https://lnc2w74z.cenaly.com vor continua să funcționeze ca de obicei — prin browser.

Pentru o integrare suplimentară cu Telegram, puteți plasa pe mese un al doilea cod QR cu link către bot:

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

Verificarea funcționării#

1. Deschideți linkul https://t.me/YourBot/menu pe telefon
2. Apăsați Start (dacă deschideți botul pentru prima dată)
3. Apăsați butonul 📋 Meniu din panoul de jos al chatului
4. Verificați că aplicația s-a deschis și a încărcat meniul
5. Încercați să deschideți deep linkul: https://t.me/YourBot/menu?startapp=LOCATION_ID

Probleme frecvente#

Linkuri utile#

• Documentația Telegram Mini Apps
• BotFather
• Telegram Bot API — butoane Web App