Ir para o conteúdo
Promenu Guia
Ir para o site Registar

Primeiros passos

Como conectar o cardápio no Telegram com um Mini App

Passo a passo: abra o cardápio no Telegram Mini App. Crie o bot no BotFather, cole o token no Promenu e defina o URL como Main App e Menu Button. 10–15 min.

Atualizado em 11 de setembro de 2026 7 min de leitura

O cardápio no Telegram — a ementa, em Portugal — é o mesmo catálogo digital, aberto numa Mini App: o cliente toca no seu bot e folheia os pratos sem instalar nada e sem sair do chat. Para estabelecimentos cujos clientes já vivem no aplicativo, é mais uma porta para o mesmo cardápio que eles abririam pelo QR code.

Abaixo está o caminho de um bot vazio até uma Mini App funcionando no Promenu. A maioria termina em 10–15 minutos se o estabelecimento já existe. Ainda não tem local? Monte primeiro o cardápio digital.

O que você precisa

  • 10–15 minutos.
  • Acesso ao painel do Promenu e um estabelecimento que já exista.
  • Telegram no celular ou no computador.
  • Um catálogo pronto para mostrar: alguns pratos e Menu view (ver o cardápio) — já vem ligado desde o começo.

Onde ir no painel

  1. Places (Locais).
  2. Abra o estabelecimento → Edit (Editar).
  3. Nas seções do local abra Mini App (miniaplicativo).

A tela tem dois campos e um link pronto: Bot token (token do bot), Bot username (nome de usuário do bot, sem @) e um URL que parece com https://tg.promenu.space/?rmode=…, mais o botão Copy URL (Copiar URL). Na mesma tela ficam as dicas "How to set up Mini App" e "How to create a bot in @BotFather" — o passo a passo abaixo é esse caminho em linguagem simples.

Como conectar um Telegram Mini App: 4 passos

  1. Crie um bot no Telegram

    Abra o @BotFather — o bot oficial do Telegram para criar bots. Toque em Start, depois em Create a new bot ou envie /newbot. O nome do bot é o que os clientes vão ver (por exemplo, "Café da Esquina"). O username vai em letras latinas e precisa terminar em bot, sem @ — depois você cola no Promenu. Descrição e avatar podem esperar. O BotFather então envia um token, uma sequência longa como 123456:ABC-…. Copie e não encaminhe para ninguém.

  2. Cole os dados do bot no Promenu

    Volte em Places → o seu local → Mini App. Cole o token do BotFather em Bot token — o Show token (Mostrar token) ajuda a conferir se não entrou espaço a mais. Em Bot username digite o username sem @: se o bot é @biba_cafe_bot, escreva biba_cafe_bot. Salve a ficha do local. O Promenu já mostra o URL da Mini App nesta tela — toque em Copy URL.

  3. Defina o URL no BotFather

    Abra de novo o @BotFather. Escolha o seu bot na lista ou envie /mybots. Depois: Bot Settings → Mini Apps. Coloque o mesmo URL do Promenu em dois lugares: Main App (a Mini App principal do bot) e Menu Button (o botão ao lado do campo de mensagem, para o cliente abrir o cardápio num toque).

  4. Confira dentro do Telegram

    Encontre o bot pelo username, toque em Start e abra a Mini App pelo botão do menu. Você deve ver o nome, a capa, as categorias e os pratos — o que estiver ligado em Modes (Modos). Dá para abrir https://tg.promenu.space/?rmode=… no navegador para dar uma olhada no catálogo, mas a Mini App de verdade só funciona bem dentro do Telegram.

O que mais conferir por perto

Estas telas não substituem o Mini App, mas sem elas o cliente pode abrir um casco vazio.

  • Link (link público) — um slug curto do estabelecimento (letras latinas, dígitos, - e _, 3–64 caracteres). Deixar vazio não tem problema.
  • Modes: o Menu view já está ligado. Ative Delivery (Entrega) e Pickup (Retirada) se quiser pedidos pelo Telegram — isso pede o plano Pro ou Ultimate.
  • Active (Ativo) — enquanto estiver desligado, o estabelecimento continua rascunho e o cliente não vai ver.

Checklist antes de publicar

  • Abri o local → Mini App.
  • Criei um bot no @BotFather.
  • Colei o token no Promenu.
  • Colei o username sem @.
  • Copiei o URL no Promenu.
  • Defini esse URL como Main App e Menu Button no BotFather.
  • Abri o bot no Telegram e o cardápio está certo.
  • O local está em Active e tem pratos no cardápio.

Onde clicar se você esqueceu alguma coisa

Navegação rápida: Promenu e BotFather
TarefaOnde
Ajustes do Mini AppPlaces → local → Mini App
Criar um botTelegram → @BotFather → /newbot
Definir o URLBotFather → bot → Bot Settings → Mini Apps
Link público do estabelecimentoPlace → Link
Entrega e retiradaPlace → Modes
Prévia do cardPlace profile → App preview

Se o BotFather reclamar do username ou do URL, em geral o username já está ocupado — ou entrou um espaço no link. Copie o URL de novo com Copy URL e cole sem alterar nada.

Perguntas frequentes

Preciso criar um bot novo?

O estabelecimento precisa de um bot no BotFather. Você pode reaproveitar um bot que já seja seu: cole o token e o username no Promenu e defina o URL da Mini App nas configurações desse bot.

Um bot pode atender vários estabelecimentos?

Um bot separado por estabelecimento ou por marca costuma ficar mais claro para o cliente. Se você não tiver certeza, comece com um bot para um local.

O que importa mais, o token ou o username?

O Promenu precisa dos dois. O token liga o painel ao bot; o username diz às pessoas e ao sistema qual bot você conectou.

Por que o Telegram está vazio ou mostra o cardápio errado?

Confira nesta ordem: o Promenu tem o token e o username certos salvos; o Main App e o Menu Button do BotFather usam o URL deste local; o estabelecimento está em Active; há itens no cardápio; o modo certo está ligado. Ainda travou? Fale conosco no Telegram em @EmilDevelop.

É seguro guardar o token no painel?

Só quem pode editar o local vê o token. Não cole em chats. Se vazou, revogue no BotFather e atualize no Promenu.

Preciso de uma lista de permissão de domínios?

A tela atual de Mini App no Promenu não pede lista de permissão de domínios: basta colocar o URL do painel em Mini Apps no BotFather.

Pronto para abrir o cardápio do seu estabelecimento no Telegram?

Abrir o painel

Ficou alguma dúvida nesta etapa? Fale com a gente no Telegram