Telegram Mini App — Guida passo-passo

Che cos'è?#

Telegram Mini App consente ai tuoi clienti di aprire il menu digitale del ristorante direttamente all'interno di Telegram, senza installare applicazioni e senza passare al browser. Il menu appare come una parte nativa di Telegram: si adatta al tema dell'utente, supporta il pulsante "Indietro" e i gesti.

Vantaggi#

• 📱 All'interno di Telegram — il cliente non deve passare al browser
• 🎨 Aspetto nativo — colori, font e tema si adattano a Telegram
• 🔗 Deep Links — link diretto al menu di un ristorante specifico
• 🌍 Lingua automatica — la lingua viene presa dalle impostazioni di Telegram dell'utente
• 🍪 Senza cookies — il banner dei cookie non viene mostrato all'interno di Telegram

Avvio rapido#

Passo 1 — Crea un bot#

Apri @BotFather in Telegram e invia:

/newbot

1. Inserisci il nome del bot (ad esempio, Cenaly Menu Bot)
2. Inserisci il username (ad esempio, MeniMenuBot) — deve terminare con Bot
3. Salva il Bot Token ricevuto (formato: 123456789:ABCdefGHI...)

Perché serve il Bot Token?#

Il Bot Token è una chiave segreta per la gestione programmata del bot tramite Telegram Bot API. Per la configurazione di base della Mini App (passi 2–4) non è richiesto — tutto si fa tramite BotFather. Ma sarà necessario se desideri:

• Inviare messaggi ai clienti — notifiche sullo stato dell'ordine, promozioni, messaggi di benvenuto
• Aggiungere pulsanti inline nei messaggi del bot (ad esempio, il pulsante "📋 Apri menu" — vedi sezione sotto)
• Creare un bot Telegram per ricevere ordini — il bot può ricevere e gestire ordini
• Configurare Webhook — ricevere eventi da Telegram (pressioni di pulsanti, comandi degli utenti)
• Integrare con CRM o sistema POS — gestione automatica degli ordini tramite bot

Passo 2 — Crea una Mini App#

Invia a BotFather il comando:

/newapp

1. Seleziona il bot dall'elenco
2. Title — nome dell'applicazione (ad esempio, Cenaly)
3. Description — descrizione (ad esempio, Menu digitale del ristorante)
4. Photo — carica un'immagine 640×640 px (icona dell'applicazione)
5. GIF — animazione (opzionale). Per saltare, invia /empty
6. Web App URL — inserisci l'indirizzo della tua applicazione cliente:

https://cenaly.com

7. Short Name — nome breve per il link (ad esempio, menu)

Dopo di ciò, avrai un link funzionante del tipo:

https://t.me/YourBot/menu

Passo 3 — Aggiungi il pulsante "Menu" nella chat del bot#

Invia a BotFather:

/setmenubutton

1. Seleziona il bot
2. Invia l'URL:

https://cenaly.com

3. Inserisci il testo del pulsante (ad esempio, Open Menu o 📋 Menu)

Ora, aprendo la chat con il bot, apparirà un pulsante in basso che apre la tua applicazione.

Passo 4 — Autorizza il dominio#

Invia a BotFather:

/setdomain

Seleziona il bot e inserisci il dominio:

cenaly.com

Questo autorizzerà Telegram Web App a funzionare sul tuo dominio e su tutti i suoi sottodomini (ad esempio, locationid.cenaly.com).

Deep Links — link a un ristorante specifico#

Telegram supporta il parametro startapp, che viene passato all'applicazione all'apertura. Usalo per i link a un ristorante specifico:

Esempi#

Se LOCATION_ID del tuo ristorante è lnc2w74z:

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

Pulsanti inline dal bot#

Se il tuo bot invia messaggi ai clienti, puoi aggiungere un pulsante inline che apre il menu:

Variante 1 — Pulsante Web App (si apre immediatamente)#

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

Variante 2 — Pulsante Deep Link#

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

Cosa funziona automaticamente#

Dopo la connessione all'interno di Telegram, si attivano automaticamente:

Codici QR per i ristoranti#

I codici QR già esistenti con URL del tipo https://lnc2w74z.cenaly.com continueranno a funzionare normalmente — tramite browser.

Per un'integrazione aggiuntiva con Telegram, puoi posizionare sui tavoli un secondo codice QR con il link al bot:

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

Verifica del funzionamento#

1. Apri il link https://t.me/YourBot/menu sul telefono
2. Premi Start (se apri il bot per la prima volta)
3. Premi il pulsante 📋 Menu nella barra inferiore della chat
4. Assicurati che l'applicazione si apra e carichi il menu
5. Prova ad aprire il deep link: https://t.me/YourBot/menu?startapp=LOCATION_ID

Problemi comuni#

Link utili#

• Documentazione Telegram Mini Apps
• BotFather
• Telegram Bot API — Pulsanti Web App