Telegram Mini App — Οδηγός βήμα προς βήμα

Τι είναι;#

Το Telegram Mini App επιτρέπει στους πελάτες σας να ανοίγουν το ψηφιακό μενού του εστιατορίου απευθείας μέσα στο Telegram — χωρίς εγκατάσταση εφαρμογών και χωρίς μετάβαση σε πρόγραμμα περιήγησης. Το μενού εμφανίζεται σαν φυσικό κομμάτι του Telegram: προσαρμόζεται στο θέμα του χρήστη, υποστηρίζει το κουμπί «Πίσω» και τις χειρονομίες.

Πλεονεκτήματα#

• 📱 Μέσα στο Telegram — ο πελάτης δεν χρειάζεται να μεταβεί σε πρόγραμμα περιήγησης
• 🎨 Φυσική εμφάνιση — χρώματα, γραμματοσειρές και θέμα προσαρμόζονται στο Telegram
• 🔗 Deep Links — απευθείας σύνδεσμος στο μενού συγκεκριμένου εστιατορίου
• 🌍 Αυτόματη γλώσσα — η γλώσσα λαμβάνεται από τις ρυθμίσεις Telegram του χρήστη
• 🍪 Χωρίς cookies — το banner cookie δεν εμφανίζεται μέσα στο Telegram

Ο πιο γρήγορος δρόμος — ο οδηγός στο πάνελ#

Στο πάνελ διαχείρισης: Κατάστημα εφαρμογών → κάρτα «Κατάστημα στο Telegram» → «Ρύθμιση» (το παράθυρο ανοίγει απευθείας στη βιτρίνα, δεν χρειάζεται να πάτε πουθενά αλλού). Ο οδηγός θα σας καθοδηγήσει σε τέσσερα βήματα και θα κάνει ο ίδιος το μεγαλύτερο μέρος της δουλειάς:

1. Όνομα καταστήματος.
2. Δημιουργία bot στο @BotFather και έλεγχος του token — απλώς επικολλάτε το token στον οδηγό.
3. Αυτόματη ρύθμιση του bot: όνομα, σύντομη περιγραφή, κουμπί «Μενού» με σύνδεσμο στο μενού σας, webhook και εντολές — το Cenaly τα ρυθμίζει όλα μέσω του Telegram Bot API, δεν χρειάζεται να πατήσετε τίποτα χειροκίνητα.
4. Δημιουργία Mini App (/newapp στο BotFather) και σύνδεσμος του καταστήματός σας.

Η πρόοδος αποθηκεύεται: μπορείτε να κλείσετε τον οδηγό και να συνεχίσετε αργότερα.

Παρακάτω — η χειροκίνητη διαδρομή: τα ίδια ακριβώς βήματα εξ ολοκλήρου μέσω BotFather. Θα σας φανεί χρήσιμη αν το bot είναι ήδη ρυθμισμένο με τον δικό σας τρόπο ή αν θέλετε να καταλαβαίνετε τι ακριβώς συμβαίνει.

Γρήγορη εκκίνηση (χειροκίνητα)#

Βήμα 1 — Δημιουργήστε ένα bot#

Ανοίξτε το @BotFather στο Telegram και στείλτε:

/newbot

1. Εισαγάγετε το όνομα του bot (για παράδειγμα, Cenaly Menu Bot)
2. Εισαγάγετε το username (για παράδειγμα, MeniMenuBot) — πρέπει να τελειώνει σε Bot
3. Αποθηκεύστε το Bot Token που θα λάβετε (μορφή: 123456789:ABCdefGHI...)

Γιατί χρειάζεται το Bot Token;#

Το Bot Token είναι ένα μυστικό κλειδί για τον προγραμματιστικό έλεγχο του bot μέσω του Telegram Bot API. Αν κάνετε τα πάντα χειροκίνητα μέσω BotFather (βήματα 2–4), δεν απαιτείται.

Το token χρειάζεται για να παραχωρήσετε το bot στο Cenaly — τότε το πάνελ το ρυθμίζει μόνο του και το bot αρχίζει να δουλεύει για εσάς:

• Χαιρετισμός και κουμπί «Μενού» — το bot χαιρετά στη γλώσσα του επισκέπτη, λαμβάνοντας υπόψη τον κλάδο (εστιατόριο, κομμωτήριο, ξενοδοχείο, κατάστημα), και ανοίγει τη βιτρίνα ως Mini App
• Υπενθυμίσεις ραντεβού — ο επισκέπτης εγγράφεται για υπενθύμιση της επίσκεψης και την επιβεβαιώνει ή την ακυρώνει με το κουμπί «✅ Θα έρθω» / «❌ Ακύρωση» απευθείας στη συνομιλία
• Ειδοποιήσεις στον ιδιοκτήτη — τα νέα ραντεβού και οι ακυρώσεις έρχονται στην προσωπική σας συνομιλία με το bot. Η συνδρομή ενεργοποιείται με ιδιωτικό σύνδεσμο της μορφής t.me/{bot}?start=admin_…: εμφανίζεται στον οδηγό στο βήμα «Έτοιμο» και στην κάρτα ενσωμάτωσης. Μην δημοσιεύετε τον σύνδεσμο — οι ειδοποιήσεις θα αρχίσουν να φτάνουν σε οποιονδήποτε τον ανοίξει. (Ο επισκέπτης, με τη σειρά του, μπορεί να δει τα επερχόμενα ραντεβού του με την εντολή /bookings στη συνομιλία με το bot.)
• Αλληλογραφία με τους επισκέπτες — ως ξεχωριστό κανάλι στην ενότητα «Χώρος εργασίας» → τμήμα «Επισκέπτες»: τα μηνύματα από το Telegram πέφτουν στο κοινό inbox μαζί με τη συνομιλία του ιστότοπου, το WhatsApp, το Instagram και το email (για αυτό χρειάζεται δικό σας bot — ένα bot μπορεί να έχει μόνο ένα webhook)

Επιπλέον, το token θα σας φανεί χρήσιμο αν θελήσετε να αυτοματοποιήσετε κάτι δικό σας: να στέλνετε μηνύματα σε πελάτες, να προσθέτετε inline κουμπιά στα μηνύματα του bot (δείτε την ενότητα παρακάτω) ή να το συνδέσετε με το δικό σας σύστημα.

Βήμα 2 — Δημιουργήστε ένα Mini App#

Στείλτε στο BotFather την εντολή:

/newapp

1. Επιλέξτε το bot από τη λίστα
2. Title — όνομα της εφαρμογής (για παράδειγμα, Cenaly)
3. Description — περιγραφή (για παράδειγμα, Digital restaurant menu)
4. Photo — ανεβάστε μια εικόνα 640×640 px (εικονίδιο της εφαρμογής)
5. GIF — κινούμενη εικόνα (προαιρετικά). Για να την παραλείψετε, στείλτε /empty
6. Web App URL — δώστε τη διεύθυνση της εφαρμογής πελάτη σας:

https://cenaly.com

7. Short Name — σύντομο όνομα για τον σύνδεσμο (για παράδειγμα, menu)

Μετά από αυτό θα έχετε έναν λειτουργικό σύνδεσμο της μορφής:

https://t.me/YourBot/menu

Βήμα 3 — Προσθέστε το κουμπί «Μενού» στη συνομιλία του bot#

Στείλτε στο BotFather:

/setmenubutton

1. Επιλέξτε το bot
2. Στείλτε το URL:

https://cenaly.com

3. Εισαγάγετε το κείμενο του κουμπιού (για παράδειγμα, Open Menu ή 📋 Μενού)

Τώρα, όταν ανοίγετε τη συνομιλία με το bot, στο κάτω μέρος της οθόνης θα εμφανίζεται ένα κουμπί που ανοίγει την εφαρμογή σας.

Βήμα 4 — Επιτρέψτε τον τομέα#

Στείλτε στο BotFather:

/setdomain

Επιλέξτε το bot και δώστε τον τομέα:

cenaly.com

Αυτό θα επιτρέψει στο Telegram Web App να λειτουργεί στον τομέα σας και σε όλους τους υποτομείς του (για παράδειγμα, locationid.cenaly.com).

Deep Links — σύνδεσμοι σε συγκεκριμένο εστιατόριο#

Το Telegram υποστηρίζει την παράμετρο startapp, η οποία μεταβιβάζεται στην εφαρμογή κατά το άνοιγμα. Χρησιμοποιήστε την για συνδέσμους σε συγκεκριμένο εστιατόριο:

Παραδείγματα#

Αν το LOCATION_ID του εστιατορίου σας είναι 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 κουμπιά από το bot#

Αν το bot σας στέλνει μηνύματα σε πελάτες, μπορείτε να προσθέσετε ένα inline κουμπί που ανοίγει το μενού:

Επιλογή 1 — Κουμπί Web App (ανοίγει αμέσως)#

{
  "inline_keyboard": [[{
    "text": "📋 Άνοιγμα μενού",
    "web_app": {
      "url": "https://LOCATION_ID.cenaly.com/ru"
    }
  }]]
}

Επιλογή 2 — Κουμπί Deep Link#

{
  "inline_keyboard": [[{
    "text": "📋 Άνοιγμα μενού",
    "url": "https://t.me/YourBot/menu?startapp=LOCATION_ID__ru"
  }]]
}

Τι λειτουργεί αυτόματα#

Μετά τη σύνδεση, μέσα στο Telegram ενεργοποιούνται αυτόματα:

QR codes για εστιατόρια#

Τα υπάρχοντα QR codes με URL της μορφής https://lnc2w74z.cenaly.com συνεχίζουν να λειτουργούν ως συνήθως — μέσω browser.

Για πρόσθετη ενσωμάτωση με το Telegram, μπορείτε να τοποθετήσετε στα τραπέζια ένα δεύτερο QR code με σύνδεσμο προς το bot:

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

Έλεγχος λειτουργικότητας#

1. Ανοίξτε τον σύνδεσμο https://t.me/YourBot/menu στο τηλέφωνο
2. Πατήστε Start (αν ανοίγετε το bot για πρώτη φορά)
3. Πατήστε το κουμπί 📋 Μενού στο κάτω τμήμα της συνομιλίας
4. Βεβαιωθείτε ότι η εφαρμογή άνοιξε και φόρτωσε το μενού
5. Δοκιμάστε να ανοίξετε το deep link: https://t.me/YourBot/menu?startapp=LOCATION_ID

Συχνά προβλήματα#

Χρήσιμοι σύνδεσμοι#

• Τεκμηρίωση Telegram Mini Apps
• BotFather
• Telegram Bot API — Κουμπιά Web App