跳到正文
Promenu 使用指南
返回网站 注册

第一步

如何把电子菜单接入 Telegram Mini App

分步说明：把电子菜单开在 Telegram Mini App 里——在 BotFather 建机器人、把 token 填进 Promenu、把 URL 设成 Main App 和 Menu Button。约 10–15 分钟。写给台湾、香港、新加坡及海外、客人已在用 Telegram 的门店。

更新于 2026年9月11日 阅读约 5 分钟

这份教程写给客人已经在用 Telegram 的经营者：台湾、香港、新加坡，以及海外餐饮门店。Telegram Mini App 就是同一份电子菜单，开在聊天里：客人点开你的机器人，不用另装 App，也不用离开对话，就能翻目录。中国大陆目前打不开 Telegram，所以这条路径不适合大陆门店。

下面是在 Promenu 里从空机器人做到能用的 Mini App 的路径。门店已经建好的话，多数人 10–15 分钟就能做完。还没有门店？先把电子菜单做起来。

需要准备什么

  • 10–15 分钟。
  • 能登录Promenu 后台，并且门店已经建好。
  • 手机或电脑上装着 Telegram。
  • 目录已经能给人看：有几道菜，而且 Menu view（菜单浏览）是开着的——一开始就是开着的。

后台要从哪里进

  1. Places（门店列表）。
  2. 打开门店 → Edit（编辑）。
  3. 在门店分区里打开 Mini App。

这个画面有两个字段和一条现成链接：Bot token（机器人令牌）、Bot username（机器人用户名，不要带 @），以及看起来像 https://tg.promenu.space/?rmode=… 的 URL，旁边有 Copy URL（复制链接）按钮。同一页上还有「How to set up Mini App」和「How to create a bot in @BotFather」两段提示——下面就是把这条路用白话写一遍。

如何接入 Telegram Mini App：4 步

  1. 在 Telegram 里建一个机器人

    打开 @BotFather——Telegram 官方用来建机器人的机器人。点 Start，再点 Create a new bot，或直接发送 /newbot。机器人名称是客人会看到的名字（例如「Harbour Cafe」）。Username 用拉丁字母，必须以 bot 结尾，不要带 @——稍后要填进 Promenu。简介和头像可以以后再补。BotFather 接着会发来一段 token，长得像 123456:ABC-…。复制下来，不要转发给任何人。

  2. 把机器人资料填进 Promenu

    回到 Places → 你的门店 → Mini App。把 BotFather 给的 token 贴进 Bot token——Show token（显示令牌）可以帮你检查有没有多出空格。在 Bot username 里填写 不带 @ 的 username：机器人如果是 @biba_cafe_bot，就写 biba_cafe_bot。保存门店卡片。这一页上 Promenu 已经给出 Mini App 的 URL——按 Copy URL。

  3. 在 BotFather 里填上 URL

    再打开 @BotFather。从列表里选你的机器人，或发送 /mybots。然后：Bot Settings → Mini Apps。同一条 Promenu URL 要填两个地方：Main App（机器人的主 Mini App）和 Menu Button（输入框旁边的按钮，客人一点就能打开菜单）。

  4. 在 Telegram 里检查一遍

    用 username 找到机器人，点 Start，再从菜单按钮打开 Mini App。你应该看到店名、封面、分类和菜品——也就是 Modes（模式）里已经打开的那些。也可以在浏览器里打开 https://tg.promenu.space/?rmode=… 看一眼目录，但真正的 Mini App 只有在 Telegram 里才完整。

旁边还要看什么

这些画面替代不了 Mini App，但缺了它们，客人可能打开一个空壳。

  • Link（链接）——门店的短公开 slug（拉丁字母、数字、- 和 _，3–64 个字符）。留空也可以。
  • Modes：Menu view 本来就是开着的。想从 Telegram 接单，再打开 Delivery（配送）和 Pickup（自取）——这两项需要 Pro 或 Ultimate 套餐。
  • Active（已激活）——没打开时，门店还是草稿，客人看不到。

上线前的检查清单

  • 已打开门店 → Mini App。
  • 已在 @BotFather 里建好机器人。
  • 已把 token 填进 Promenu。
  • 已填入不带 @ 的 username。
  • 已从 Promenu 复制 URL。
  • 已在 BotFather 把这条 URL 设成 Main App 和 Menu Button。
  • 已在 Telegram 里打开机器人，菜单显示正常。
  • 门店是 Active，菜单里有菜品。

忘了在哪操作时看这里

快速导航：Promenu 和 BotFather
要做什么在哪里
Mini App 设置Places → 门店 → Mini App
创建机器人Telegram → @BotFather → /newbot
填写 URLBotFather → 机器人 → Bot Settings → Mini Apps
门店公开链接门店 → Link
配送和自取门店 → Modes
卡片预览门店资料 → App preview

如果 BotFather 抱怨 username 或 URL，多半是 username 被人占用了，或者链接里多了一个空格。再用 Copy URL 复制一次，原样贴进去。

常见问题

必须新建一个机器人吗？

门店需要一个 BotFather 里的机器人。已经有自己的机器人也可以：把它的 token 和 username 填进 Promenu，再在那个机器人的设置里写上 Mini App 的 URL。

一个机器人能管好几家门店吗？

一家门店或一个品牌一个机器人，客人通常更清楚自己进了哪。不确定的话，先从一家店配一个机器人开始。

Token 和 username，哪个更重要？

Promenu 两个都要。Token 把后台和机器人绑在一起；username 告诉客人和系统，你接上的是哪一个机器人。

为什么 Telegram 里是空的，或打开了别的菜单？

按这个顺序查：Promenu 里保存的 token 和 username 是对的；BotFather 的 Main App 和 Menu Button 用的是这家门店的 URL；门店已切换为 Active；菜单里有菜品；打开了正确的模式。还是不行？在 Telegram 上找我们 @EmilDevelop。

把 token 放在后台安全吗？

只有能编辑这家门店的人看得到 token。不要把它贴进聊天。如果已经泄露，到 BotFather 作废，再在 Promenu 里更新。

还要单独加域名白名单吗？

现在的 Promenu Mini App 画面不要求域名白名单：把后台给出的 URL 填进 BotFather 的 Mini Apps 就够了。

准备好在 Telegram 里打开门店电子菜单了吗？

打开后台

这一步还有疑问？ 通过 Telegram 联系我们