Telegram Mini App — Schritt-für-Schritt-Anleitung

Was ist das?#

Telegram Mini App ermöglicht es Ihren Kunden, das digitale Restaurantmenü direkt innerhalb von Telegram zu öffnen — ohne App-Installation und ohne Wechsel zum Browser. Das Menü erscheint als nativer Teil von Telegram: es passt sich dem Thema des Nutzers an und unterstützt die „Zurück“-Taste und Gesten.

Vorteile#

• 📱 Innerhalb von Telegram — der Kunde muss nicht zum Browser wechseln
• 🎨 Natives Aussehen — Farben, Schriftarten und Thema passen sich Telegram an
• 🔗 Deep Links — direkter Link zum Menü eines bestimmten Restaurants
• 🌍 Automatische Sprache — die Sprache wird aus den Telegram-Einstellungen des Nutzers übernommen
• 🍪 Ohne Cookies — Cookie-Banner wird innerhalb von Telegram nicht angezeigt

Schneller Start#

Schritt 1 — Bot erstellen#

Öffnen Sie @BotFather in Telegram und senden Sie:

/newbot

1. Geben Sie den Bot-Namen ein (z.B. Cenaly Menu Bot)
2. Geben Sie den Benutzernamen ein (z.B. MeniMenuBot) — muss mit Bot enden
3. Speichern Sie das erhaltene Bot-Token (Format: 123456789:ABCdefGHI...)

Warum wird das Bot-Token benötigt?#

Das Bot-Token ist ein geheimer Schlüssel zur programmatischen Steuerung des Bots über die Telegram Bot API. Für die grundlegende Einrichtung der Mini App (Schritte 2–4) wird es nicht benötigt — alles wird über BotFather erledigt. Es wird jedoch benötigt, wenn Sie:

• Nachrichten an Kunden senden möchten — Benachrichtigungen über Bestellstatus, Aktionen, Willkommensnachrichten
• Inline-Buttons zu Bot-Nachrichten hinzufügen möchten (z.B. den Button „📋 Menü öffnen“ — siehe Abschnitt unten)
• Einen Telegram-Bot zur Bestellannahme erstellen möchten — der Bot kann Bestellungen empfangen und verarbeiten
• Webhook einrichten möchten — Ereignisse von Telegram empfangen (Button-Klicks, Benutzerbefehle)
• Mit CRM oder POS-System integrieren möchten — automatische Bestellverarbeitung über den Bot

Schritt 2 — Mini App erstellen#

Senden Sie BotFather den Befehl:

/newapp

1. Wählen Sie den Bot aus der Liste
2. Titel — Name der Anwendung (z.B. Cenaly)
3. Beschreibung — Beschreibung (z.B. Digitales Restaurantmenü)
4. Foto — Laden Sie ein Bild 640×640 px hoch (App-Icon)
5. GIF — Animation (optional). Um zu überspringen, senden Sie /empty
6. Web App URL — Geben Sie die Adresse Ihrer Client-Anwendung an:

https://cenaly.com

7. Short Name — Kurzname für den Link (z.B. menu)

Danach erhalten Sie einen funktionierenden Link im Format:

https://t.me/YourBot/menu

Schritt 3 — Fügen Sie den „Menü“-Button zum Bot-Chat hinzu#

Senden Sie BotFather:

/setmenubutton

1. Wählen Sie den Bot
2. Senden Sie die URL:

https://cenaly.com

3. Geben Sie den Text des Buttons ein (z.B. Open Menu oder 📋 Menü)

Nun erscheint beim Öffnen des Chats mit dem Bot unten auf dem Bildschirm ein Button, der Ihre Anwendung öffnet.

Schritt 4 — Domain erlauben#

Senden Sie BotFather:

/setdomain

Wählen Sie den Bot und geben Sie die Domain an:

cenaly.com

Dies erlaubt es der Telegram Web App, auf Ihrer Domain und allen ihren Subdomains (z.B. locationid.cenaly.com) zu arbeiten.

Deep Links — Links zu einem bestimmten Restaurant#

Telegram unterstützt den Parameter startapp, der beim Öffnen an die Anwendung übergeben wird. Verwenden Sie ihn für Links zu einem bestimmten Restaurant:

Beispiele#

Wenn LOCATION_ID Ihres Restaurants lnc2w74z ist:

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

Inline-Buttons aus dem Bot#

Wenn Ihr Bot Nachrichten an Kunden sendet, können Sie einen Inline-Button hinzufügen, der das Menü öffnet:

Variante 1 — Web App Button (öffnet sich sofort)#

{
  "inline_keyboard": [[{
    "text": "📋 Menü öffnen",
    "web_app": {
      "url": "https://LOCATION_ID.cenaly.com/ru"
    }
  }]]
}

Variante 2 — Deep Link Button#

{
  "inline_keyboard": [[{
    "text": "📋 Menü öffnen",
    "url": "https://t.me/YourBot/menu?startapp=LOCATION_ID__ru"
  }]]
}

Was funktioniert automatisch#

Nach der Verbindung innerhalb von Telegram werden automatisch aktiviert:

QR-Codes für Restaurants#

Bereits vorhandene QR-Codes mit URLs im Format https://lnc2w74z.cenaly.com funktionieren weiterhin wie gewohnt — über den Browser.

Für zusätzliche Integration mit Telegram können Sie auf den Tischen einen zweiten QR-Code mit dem Bot-Link platzieren:

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

Funktionsprüfung#

1. Öffnen Sie den Link https://t.me/YourBot/menu auf Ihrem Telefon
2. Drücken Sie Start (wenn Sie den Bot zum ersten Mal öffnen)
3. Drücken Sie den Button 📋 Menü in der unteren Chat-Leiste
4. Stellen Sie sicher, dass die Anwendung geöffnet wird und das Menü lädt
5. Versuchen Sie, den Deep Link zu öffnen: https://t.me/YourBot/menu?startapp=LOCATION_ID

Häufige Probleme#

Nützliche Links#

• Telegram Mini Apps Dokumentation
• BotFather
• Telegram Bot API — Web App Buttons