Telegram Mini App — Stapsgewijze handleiding

Wat is het?#

Telegram Mini App laat uw klanten het digitale restaurantmenu rechtstreeks in Telegram openen — zonder apps te installeren en zonder naar de browser te gaan. Het menu ziet eruit als een native onderdeel van Telegram: het past zich aan het thema van de gebruiker aan en ondersteunt de knop „Terug” en gebaren.

Voordelen#

• 📱 Binnen Telegram — de klant hoeft niet naar de browser te schakelen
• 🎨 Native uiterlijk — kleuren, lettertypen en thema passen zich aan Telegram aan
• 🔗 Deep Links — een directe link naar het menu van een specifiek restaurant
• 🌍 Automatische taal — de taal wordt overgenomen uit de Telegram-instellingen van de gebruiker
• 🍪 Geen cookies — er wordt binnen Telegram geen cookiebanner getoond

De snelste route — de wizard in het paneel#

In het beheerpaneel: App Store → kaart „Winkel in Telegram” → „Instellen” (het venster opent rechtstreeks in de etalage, u hoeft nergens naartoe). De wizard leidt u in vier stappen door het proces en doet het grootste deel van het werk zelf:

1. Naam van de winkel.
2. Een bot aanmaken in @BotFather en het token controleren — u plakt het token gewoon in de wizard.
3. Automatische configuratie van de bot: naam, korte beschrijving, de knop „Menu” met een link naar uw menu, de webhook en commando's — Cenaly stelt alles in via de Telegram Bot API, u hoeft niets handmatig aan te klikken.
4. Een Mini App aanmaken (/newapp in BotFather) en de link van uw winkel.

De voortgang wordt opgeslagen: u kunt de wizard sluiten en later verdergaan.

Hieronder staat de handmatige route: hetzelfde volledig via BotFather. Die is handig als de bot al op een eigen manier is ingesteld of als u wilt begrijpen wat er precies gebeurt.

Snel starten (handmatig)#

Stap 1 — Maak een bot aan#

Open @BotFather in Telegram en stuur:

/newbot

1. Voer de botnaam in (bijvoorbeeld Cenaly Menu Bot)
2. Voer de username in (bijvoorbeeld MeniMenuBot) — moet eindigen op Bot
3. Bewaar het ontvangen Bot Token (formaat: 123456789:ABCdefGHI...)

Waarom is een Bot Token nodig?#

Het Bot Token is een geheime sleutel voor het programmatisch beheren van de bot via de Telegram Bot API. Als u alles handmatig via BotFather doet (stappen 2–4), is het niet nodig.

Het token is nodig om de bot aan Cenaly te koppelen — dan configureert het paneel hem zelf en gaat de bot voor u werken:

• Welkomstbericht en de knop „Menu” — de bot begroet de gast in de taal van de gast, rekening houdend met de branche (restaurant, salon, hotel, winkel), en opent de etalage als Mini App
• Herinneringen voor afspraken — de gast meldt zich aan voor een herinnering aan het bezoek en bevestigt of annuleert die met de knop „✅ Ik kom” / „❌ Annuleren” rechtstreeks in de chat
• Meldingen aan de eigenaar — nieuwe afspraken en annuleringen komen binnen in uw persoonlijke chat met de bot. Het abonnement wordt geactiveerd via een privélink zoals t.me/{bot}?start=admin_…: die wordt getoond in de wizard bij de stap „Klaar” en op de integratiekaart. Publiceer de link niet — iedereen die hem opent, gaat de meldingen ontvangen. (De gast kan op zijn beurt zijn aankomende afspraken bekijken met het commando /bookings in de chat met de bot.)
• Correspondentie met gasten — als apart kanaal in het gedeelte „Werkchat” → sectie „Gasten”: berichten uit Telegram komen samen met de chat van de website, WhatsApp, Instagram en e-mail in één gedeelde inbox (hiervoor is een eigen bot nodig — één bot kan maar één webhook hebben)

Daarnaast is het token handig als u iets eigens wilt automatiseren: berichten naar klanten sturen, inline-knoppen aan botberichten toevoegen (zie het gedeelte hieronder) of de bot aan uw eigen systeem koppelen.

Stap 2 — Maak een Mini App aan#

Stuur BotFather het commando:

/newapp

1. Kies de bot uit de lijst
2. Title — de naam van de app (bijvoorbeeld Cenaly)
3. Description — een beschrijving (bijvoorbeeld Digital restaurant menu)
4. Photo — upload een afbeelding van 640×640 px (het app-pictogram)
5. GIF — een animatie (optioneel). Stuur /empty om over te slaan
6. Web App URL — geef het adres van uw klantapplicatie op:

https://cenaly.com

7. Short Name — een korte naam voor de link (bijvoorbeeld menu)

Daarna krijgt u een werkende link zoals:

https://t.me/YourBot/menu

Stap 3 — Voeg de knop „Menu” toe aan de chat met de bot#

Stuur BotFather:

/setmenubutton

1. Kies de bot
2. Stuur de URL:

https://cenaly.com

3. Voer de tekst van de knop in (bijvoorbeeld Open Menu of 📋 Меню)

Nu verschijnt er onderaan het scherm een knop wanneer de chat met de bot wordt geopend, die uw app opent.

Stap 4 — Sta het domein toe#

Stuur BotFather:

/setdomain

Kies de bot en geef het domein op:

cenaly.com

Hiermee staat u Telegram Web App toe om te werken op uw domein en al zijn subdomeinen (bijvoorbeeld locationid.cenaly.com).

Deep Links — links naar een specifiek restaurant#

Telegram ondersteunt de parameter startapp, die bij het openen aan de app wordt doorgegeven. Gebruik die voor links naar een specifiek restaurant:

Voorbeelden#

Als de LOCATION_ID van uw restaurant lnc2w74z is:

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

Inline-knoppen vanuit de bot#

Als uw bot berichten naar klanten stuurt, kunt u een inline-knop toevoegen die het menu opent:

Variant 1 — Web App-knop (opent direct)#

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

Variant 2 — Deep Link-knop#

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

Wat automatisch werkt#

Na het koppelen worden binnen Telegram automatisch ingeschakeld:

QR-codes voor restaurants#

Bestaande QR-codes met een URL zoals https://lnc2w74z.cenaly.com blijven gewoon werken — via de browser.

Voor extra integratie met Telegram kunt u op de tafels een tweede QR-code plaatsen met een link naar de bot:

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

Werking controleren#

1. Open de link https://t.me/YourBot/menu op uw telefoon
2. Tik op Start (als u de bot voor het eerst opent)
3. Tik op de knop 📋 Menu in het onderste paneel van de chat
4. Controleer of de app is geopend en het menu heeft geladen
5. Probeer de deep link te openen: https://t.me/YourBot/menu?startapp=LOCATION_ID

Veelvoorkomende problemen#

Nuttige links#

• Documentatie Telegram Mini Apps
• BotFather
• Telegram Bot API — Web App-knoppen