Telegram Mini App — Guia Passo a Passo

O que é?#

O Telegram Mini App permite que seus clientes abram o menu digital do restaurante diretamente dentro do Telegram — sem instalar aplicativos e sem mudar para o navegador. O menu parece uma parte nativa do Telegram: adapta-se ao tema do usuário, suporta o botão "Voltar" e gestos.

Vantagens#

• 📱 Dentro do Telegram — o cliente não precisa mudar para o navegador
• 🎨 Aparência Nativa — cores, fontes e tema adaptam-se ao Telegram
• 🔗 Deep Links — link direto para o menu de um restaurante específico
• 🌍 Idioma Automático — o idioma é retirado das configurações do Telegram do usuário
• 🍪 Sem cookies — o banner de cookies não é exibido dentro do Telegram

Início Rápido#

Passo 1 — Crie um bot#

Abra @BotFather no Telegram e envie:

/newbot

1. Insira o nome do bot (por exemplo, Cenaly Menu Bot)
2. Insira o username (por exemplo, MeniMenuBot) — deve terminar com Bot
3. Salve o Bot Token recebido (formato: 123456789:ABCdefGHI...)

Para que serve o Bot Token?#

O Bot Token é uma chave secreta para gerenciar o bot programaticamente através da Telegram Bot API. Para a configuração básica do Mini App (passos 2–4) ele não é necessário — tudo é feito através do BotFather. Mas será necessário se você quiser:

• Enviar mensagens aos clientes — notificações de status de pedido, promoções, mensagens de boas-vindas
• Adicionar botões inline nas mensagens do bot (por exemplo, botão "📋 Abrir menu" — veja a seção abaixo)
• Criar um bot do Telegram para receber pedidos — o bot pode receber e processar pedidos
• Configurar Webhook — receber eventos do Telegram (cliques em botões, comandos de usuários)
• Integrar com CRM ou sistema POS — processamento automático de pedidos através do bot

Passo 2 — Crie o Mini App#

Envie o comando para o BotFather:

/newapp

1. Escolha o bot da lista
2. Title — nome do aplicativo (por exemplo, Cenaly)
3. Description — descrição (por exemplo, Menu digital de restaurante)
4. Photo — carregue uma imagem de 640×640 px (ícone do aplicativo)
5. GIF — animação (opcional). Para pular, envie /empty
6. Web App URL — insira o endereço do seu aplicativo cliente:

https://cenaly.com

7. Short Name — nome curto para o link (por exemplo, menu)

Depois disso, você terá um link funcional no formato:

https://t.me/YourBot/menu

Passo 3 — Adicione o botão "Menu" no chat do bot#

Envie para o BotFather:

/setmenubutton

1. Escolha o bot
2. Envie o URL:

https://cenaly.com

3. Insira o texto do botão (por exemplo, Open Menu ou 📋 Menu)

Agora, ao abrir o chat com o bot, um botão aparecerá na parte inferior da tela, que abrirá seu aplicativo.

Passo 4 — Permita o domínio#

Envie para o BotFather:

/setdomain

Escolha o bot e insira o domínio:

cenaly.com

Isso permitirá que o Telegram Web App funcione em seu domínio e todos os seus subdomínios (por exemplo, locationid.cenaly.com).

Deep Links — links para um restaurante específico#

O Telegram suporta o parâmetro startapp, que é passado para o aplicativo ao abrir. Use-o para links para um restaurante específico:

Exemplos#

Se o LOCATION_ID do seu restaurante for lnc2w74z:

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

Botões Inline do bot#

Se o seu bot envia mensagens aos clientes, você pode adicionar um botão inline que abrirá o menu:

Variante 1 — Botão Web App (abre imediatamente)#

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

Variante 2 — Botão de Link Direto#

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

O que funciona automaticamente#

Após a conexão dentro do Telegram, os seguintes recursos são ativados automaticamente:

Códigos QR para restaurantes#

Os códigos QR já existentes com URL no formato https://lnc2w74z.cenaly.com continuarão funcionando normalmente — através do navegador.

Para integração adicional com o Telegram, você pode colocar uma segunda QR code nas mesas com o link para o bot:

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

Verificação de Funcionamento#

1. Abra o link https://t.me/YourBot/menu no celular
2. Clique em Start (se estiver abrindo o bot pela primeira vez)
3. Clique no botão 📋 Menu na barra inferior do chat
4. Certifique-se de que o aplicativo abriu e carregou o menu
5. Tente abrir o deep link: https://t.me/YourBot/menu?startapp=LOCATION_ID

Problemas Comuns#

Links Úteis#

• Documentação dos Mini Apps do Telegram
• BotFather
• Telegram Bot API — Botões Web App