Ir al contenido
Promenu Guía
Ir al sitio Registrarse

Primeros pasos

Cómo conectar un Telegram Mini App a tu carta digital

Paso a paso: abre tu carta o menú en Telegram Mini App. Crea el bot en BotFather, pega el token en Promenu y pon el URL en Main App y Menu Button. 10–15 min.

Actualizado el 11 de septiembre de 2026 7 min de lectura

Una Telegram Mini App es la misma carta digital — o el menú en Telegram, como se dice en Latinoamérica — abierta dentro del chat: el cliente entra en tu bot y recorre el catálogo sin instalar nada ni salir de la conversación. Para locales cuyos clientes ya viven en el mensajero, es otra puerta al mismo catálogo que abrirían por QR.

Abajo va el camino de un bot vacío a una Mini App funcionando en Promenu. La mayoría termina en 10–15 minutos si el local ya existe. ¿Aún no tienes lugar? Monta primero la carta digital.

Qué necesitas

  • 10–15 minutos.
  • Acceso al panel de Promenu y un local que ya exista.
  • Telegram en el móvil o en el ordenador.
  • Un catálogo listo para mostrar: unos cuantos platos y Menu view (ver la carta) — viene encendido desde el principio.

Dónde ir en el panel

  1. Places (Lugares).
  2. Abre el local → Edit (Editar).
  3. En las secciones del local abre Mini App (mini aplicación).

La pantalla tiene dos campos y un enlace listo: Bot token (token del bot), Bot username (nombre de usuario del bot, sin @) y un URL que se ve así: https://tg.promenu.space/?rmode=…, más el botón Copy URL (Copiar URL). En la misma pantalla están las pistas "How to set up Mini App" y "How to create a bot in @BotFather" — el recorrido de abajo es ese camino en lenguaje claro.

Cómo conectar un Telegram Mini App: 4 pasos

  1. Crea un bot en Telegram

    Abre @BotFather — el bot oficial de Telegram para crear bots. Pulsa Start, luego Create a new bot o envía /newbot. El nombre del bot es lo que verán tus clientes (por ejemplo, "Café del Puerto"). El username va en letras latinas y debe terminar en bot, sin @ — luego lo pegarás en Promenu. La descripción y el avatar pueden esperar. BotFather te envía un token, una cadena larga como 123456:ABC-…. Cópialo y no se lo reenvíes a nadie.

  2. Pega los datos del bot en Promenu

    Vuelve a Places → tu local → Mini App. Pega el token de BotFather en Bot token — Show token (Mostrar token) te ayuda a comprobar que no hay espacios de más. En Bot username escribe el username sin @: si el bot es @biba_cafe_bot, pon biba_cafe_bot. Guarda la ficha del local. Promenu ya muestra el URL de la Mini App en esta pantalla — pulsa Copy URL.

  3. Pon el URL en BotFather

    Abre de nuevo @BotFather. Elige tu bot de la lista o envía /mybots. Luego: Bot Settings → Mini Apps. Pon el mismo URL de Promenu en dos sitios: Main App (la Mini App principal del bot) y Menu Button (el botón junto al campo de mensaje, para que el cliente abra la carta de un toque).

  4. Compruébalo dentro de Telegram

    Busca el bot por el username, pulsa Start y abre la Mini App desde el botón del menú. Deberías ver el nombre, la portada, las categorías y los platos — lo que esté encendido en Modes (Modos). Puedes abrir https://tg.promenu.space/?rmode=… en el navegador para echar un vistazo al catálogo, pero la Mini App de verdad solo se siente bien dentro de Telegram.

Qué más revisar cerca

Estas pantallas no sustituyen Mini App, pero sin ellas el cliente puede abrir un cascarón vacío.

  • Link (Enlace) — un slug público corto del local (letras latinas, dígitos, - y _, 3–64 caracteres). Dejarlo vacío no pasa nada.
  • Modes: Menu view ya está encendido. Activa Delivery (Domicilio) y Pickup (Recogida) si quieres pedidos desde Telegram — eso pide el plan Pro o Ultimate.
  • Active (Activo) — mientras esté apagado, el local sigue siendo un borrador y el cliente no lo verá.

Lista antes de publicar

  • Abrí el local → Mini App.
  • Creé un bot en @BotFather.
  • Pegué el token en Promenu.
  • Pegué el username sin @.
  • Copié el URL desde Promenu.
  • Puse ese URL como Main App y Menu Button en BotFather.
  • Abrí el bot en Telegram y la carta se ve bien.
  • El local está en Active y hay platos en la carta.

Dónde pulsar si se te olvida algo

Navegación rápida: Promenu y BotFather
TareaDónde
Ajustes de Mini AppPlaces → local → Mini App
Crear un botTelegram → @BotFather → /newbot
Poner el URLBotFather → bot → Bot Settings → Mini Apps
Enlace público del localPlace → Link
Domicilio y recogidaPlace → Modes
Vista previa de la fichaPlace profile → App preview

Si BotFather se queja del username o del URL, lo habitual es que el username ya esté ocupado — o que se haya colado un espacio en el enlace. Copia el URL otra vez con Copy URL y pégalo sin cambiar nada.

Preguntas frecuentes

¿Tengo que crear un bot nuevo?

El local necesita un bot en BotFather. Puedes reutilizar uno que ya sea tuyo: pega su token y su username en Promenu y pon el URL de la Mini App en los ajustes de ese bot.

¿Un solo bot puede servir a varios locales?

Un bot aparte por local o por marca suele ser más claro para el cliente. Si no estás seguro, empieza con un bot para un solo local.

¿Qué importa más, el token o el username?

Promenu necesita los dos. El token ata el panel al bot; el username dice a la gente y al sistema qué bot conectaste.

¿Por qué Telegram está vacío o muestra otra carta?

Revisa en este orden: en Promenu están guardados el token y el username correctos; Main App y Menu Button de BotFather usan el URL de este local; el local está en Active; hay platos en la carta; el modo correcto está encendido. ¿Sigues atascado? Escríbenos en Telegram a @EmilDevelop.

¿Es seguro guardar el token en el panel?

Solo quien puede editar el local ve el token. No lo pegues en chats. Si se filtró, revócalo en BotFather y actualízalo en Promenu.

¿Hace falta una lista blanca de dominios?

La pantalla actual de Mini App en Promenu no pide una lista blanca de dominios: basta con poner el URL del panel en Mini Apps de BotFather.

¿Listo para abrir la carta de tu local en Telegram?

Abrir el panel

¿Te quedan dudas sobre este paso? Escríbenos por Telegram