Telegram Mini App — Przewodnik krok po kroku

Co to jest?#

Telegram Mini App pozwala Twoim klientom otwierać cyfrowe menu restauracji bezpośrednio w Telegramie — bez instalacji aplikacji i bez przechodzenia do przeglądarki. Menu wygląda jak natywna część Telegrama: dostosowuje się do motywu użytkownika, obsługuje przycisk „Wstecz” i gesty.

Korzyści#

• 📱 Wewnątrz Telegrama — klient nie musi przełączać się na przeglądarkę
• 🎨 Natywny wygląd — kolory, czcionki i motyw dostosowują się do Telegrama
• 🔗 Deep Links — bezpośredni link do menu konkretnej restauracji
• 🌍 Automatyczny język — język pobierany jest z ustawień Telegrama użytkownika
• 🍪 Bez cookies — baner cookie nie jest wyświetlany wewnątrz Telegrama

Szybki start#

Krok 1 — Utwórz bota#

Otwórz @BotFather w Telegramie i wyślij:

/newbot

1. Wprowadź nazwę bota (np. Cenaly Menu Bot)
2. Wprowadź username (np. MeniMenuBot) — musi kończyć się na Bot
3. Zapisz otrzymany Bot Token (format: 123456789:ABCdefGHI...)

Dlaczego potrzebny jest Bot Token?#

Bot Token to tajny klucz do programowego zarządzania botem przez Telegram Bot API. Do podstawowej konfiguracji Mini App (kroki 2–4) nie jest on wymagany — wszystko odbywa się przez BotFather. Ale będzie potrzebny, jeśli chcesz:

• Wysyłać wiadomości do klientów — powiadomienia o statusie zamówienia, promocje, wiadomości powitalne
• Dodawać przyciski inline do wiadomości bota (np. przycisk „📋 Otwórz menu” — patrz sekcja poniżej)
• Utworzyć bota Telegrama do przyjmowania zamówień — bot może odbierać i przetwarzać zamówienia
• Skonfigurować Webhook — odbierać zdarzenia z Telegrama (naciśnięcia przycisków, komendy użytkowników)
• Zintegrować z CRM lub systemem POS — automatyczne przetwarzanie zamówień przez bota

Krok 2 — Utwórz Mini App#

Wyślij do BotFather komendę:

/newapp

1. Wybierz bota z listy
2. Title — nazwa aplikacji (np. Cenaly)
3. Description — opis (np. Digital restaurant menu)
4. Photo — załaduj obrazek 640×640 px (ikona aplikacji)
5. GIF — animacja (opcjonalnie). Aby pominąć, wyślij /empty
6. Web App URL — podaj adres swojej aplikacji klienckiej:

https://cenaly.com

7. Short Name — krótka nazwa dla linku (np. menu)

Po tym otrzymasz działający link w formacie:

https://t.me/YourBot/menu

Krok 3 — Dodaj przycisk „Menu” do czatu bota#

Wyślij do BotFather:

/setmenubutton

1. Wybierz bota
2. Wyślij URL:

https://cenaly.com

3. Wprowadź tekst przycisku (np. Open Menu lub 📋 Menu)

Teraz po otwarciu czatu z botem na dole ekranu pojawi się przycisk, który otwiera Twoją aplikację.

Krok 4 — Zezwól na domenę#

Wyślij do BotFather:

/setdomain

Wybierz bota i podaj domenę:

cenaly.com

To pozwoli Telegram Web App działać na Twojej domenie i wszystkich jej subdomenach (np. locationid.cenaly.com).

Deep Links — linki do konkretnej restauracji#

Telegram obsługuje parametr startapp, który jest przekazywany do aplikacji przy otwarciu. Użyj go do linków do konkretnej restauracji:

Przykłady#

Jeśli LOCATION_ID Twojej restauracji to lnc2w74z:

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

Przycisk inline z bota#

Jeśli Twój bot wysyła wiadomości do klientów, możesz dodać przycisk inline, który otworzy menu:

Wariant 1 — Przycisk Web App (otwiera się od razu)#

{
  "inline_keyboard": [[{
    "text": "📋 Otwórz menu",
    "web_app": {
      "url": "https://LOCATION_ID.cenaly.com/ru"
    }
  }]]
}

Wariant 2 — Przycisk Deep Link#

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

Co działa automatycznie#

Po podłączeniu wewnątrz Telegrama automatycznie włączają się:

Kody QR dla restauracji#

Już istniejące kody QR z URL w formacie https://lnc2w74z.cenaly.com będą działać jak zwykle — przez przeglądarkę.

Dla dodatkowej integracji z Telegramem można umieścić na stołach drugi kod QR z linkiem do bota:

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

Sprawdzanie działania#

1. Otwórz link https://t.me/YourBot/menu na telefonie
2. Naciśnij Start (jeśli otwierasz bota po raz pierwszy)
3. Naciśnij przycisk 📋 Menu na dolnym pasku czatu
4. Upewnij się, że aplikacja się otworzyła i załadowała menu
5. Spróbuj otworzyć deep link: https://t.me/YourBot/menu?startapp=LOCATION_ID

Częste problemy#

Przydatne linki#

• Dokumentacja Telegram Mini Apps
• BotFather
• Telegram Bot API — Przycisk Web App