Cómo crear tu primera Mini App de Telegram: guía paso a paso

¡Descubre cómo crear tu propia Mini App de Telegram! En esta guía de TMA, te acompañamos paso a paso por todo el proceso. Llega hoy mismo a millones de usuarios dentro de Telegram.
how-to-build-your-first-telegram-mini-app-a-step-by-step-guide

Telegram vs. WeChat: la batalla de las superapps

WeChat lleva años siendo el líder indiscutible entre las superapps. Desde su lanzamiento en 2011, se ha convertido en parte esencial del día a día en China al reunir en una sola plataforma mensajería, redes sociales, pagos y comercio electrónico. Telegram llegó después, en 2013, pero ha avanzado a gran velocidad y hoy es un fuerte rival en el panorama global de las superapps. Ahora, los desarrolladores pueden crear servicios innovadores e incluso desarrollar pequeñas soluciones directamente dentro de Telegram. Con la documentación adecuada para Mini Apps, cualquiera que quiera crear un bot de Telegram o diseñar una Mini App con tecnologías web conocidas puede empezar a desarrollar aplicaciones con más facilidad que nunca.

Principales diferencias entre Telegram y WeChat:

Característica

WeChat

Telegram

Año de lanzamiento

2011

2013

Mercado principal

China (presencia limitada en el resto del mundo)

Global

Privacidad

Sujeto a su propia política de privacidad y a las leyes chinas aplicables

Cifrado de extremo a extremo en los chats secretos; los chats en la nube y las Mini Apps no cuentan con la protección de los chats secretos

Funciones de superapp

Ecosistema consolidado: pagos, compras y servicios

En rápida expansión, con Mini Apps y billeteras de criptomonedas

Usuarios

Unos 1.300 millones de usuarios activos mensuales (cifra histórica, no una estimación actual)

Más de 800 millones de usuarios activos mensuales (cifra histórica, no una estimación actual)

WeChat lleva mucho tiempo dominando el mercado chino como una app todo en uno, pero la app de Telegram está dando pasos firmes para competir con ella a escala mundial. Gracias a su apuesta por la privacidad, sus funciones de vanguardia y sus herramientas para desarrolladores, Telegram se está haciendo un lugar propio. Gracias a Telegram Mini Apps (TMA), los desarrolladores ya pueden crear aplicaciones web que se integran a la perfección en la plataforma, lo que le permite acortar distancias rápidamente y ganar popularidad en todo el mundo.

Ahora veamos cómo crear una Mini App de Telegram y sumarte a la creciente comunidad de desarrolladores que aprovechan todo el potencial de Telegram.

¿Qué son las Telegram Mini Apps y por qué son tan populares?

Telegram Mini Apps (TMA) son, básicamente, aplicaciones web que funcionan dentro de Telegram. Imagínalas como sitios web convencionales creados con HTML, CSS y JavaScript, pero con acceso a las funciones exclusivas de Telegram a través de su SDK. Se abren dentro de Telegram y ofrecen una experiencia fluida, integración de datos y sistemas de pago incorporados. Para sacar el máximo partido a Telegram con las Mini Apps, los desarrolladores suelen crear un bot con BotFather, asignarle un nombre de usuario y configurar los ajustes para conectarlo con la app. Una vez listo, pueden compartir las Mini Apps en grupos de Telegram o directamente con otros usuarios, convirtiéndolas en una potente extensión del ecosistema. Entender cómo funcionan las Telegram Mini Apps es clave para los desarrolladores que quieran aprovechar esta plataforma.

Por qué los desarrolladores eligen las TMA:

Característica

Ventaja

No hace falta publicarla en una tienda de apps

Se ejecuta como una aplicación web dentro de Telegram. Aun así, se aplican las normas de Telegram y las políticas pertinentes de las tiendas y los servicios de pago.

Sin instalación

Los usuarios pueden acceder a tu app directamente desde Telegram.

Libertad para elegir tecnologías

Desarrolla con React, Vue o JavaScript sin frameworks: elige lo que mejor te funcione.

Una audiencia enorme

Accede al ecosistema global de Telegram; el tamaño de su audiencia no garantiza que tu app vaya a recibir tráfico.

Ejemplos de Telegram Mini Apps exitosas

Veamos algunos ejemplos reales para descubrir qué se puede hacer:

  • Wallet: un ejemplo de servicios de billetera disponibles a través de Telegram; las funciones dependen de cada billetera y de la región.
  • Hamster Kombat: un juego clicker que consiguió una participación masiva.
  • DurgerKing: la Mini App de ejemplo de Telegram para probar el proceso de pedido y pago de comida.
AdsGram

Comienza a ganar en 3 pasos

  1. 01Conectar
  2. 02Colocar anuncios
  3. 03Recibir pagos
Monetiza ahora

Cómo empezar con las Telegram Mini Apps

Qué necesitas:

  • Un editor de código (VS Code o WebStorm te servirán).
  • Conocimientos básicos de HTML, CSS y JavaScript.
  • Telegram instalado en el teléfono y en el ordenador.
  • Ganas de explorar algo nuevo.

Paso 1: crea un bot auxiliar

Todo empieza creando un bot de Telegram. Será el punto de entrada a tu aplicación. Así se hace:

  1. Busca @BotFather en Telegram.
  2. Envía el comando /newbot.
  3. Elige un nombre para tu bot.
  4. Guarda de forma segura en tu servidor el token que te proporcione BotFather: lo necesitarás para la Bot API. No lo incluyas nunca en el código del navegador ni en un repositorio público.

A continuación tienes el código Node.js para tu servidor. Instala node-telegram-bot-api, define token a partir de una variable de entorno del servidor y sustituye https://your-domain.com/app por la URL HTTPS de tu aplicación publicada antes de ejecutarlo. El botón web_app integrado está pensado para usarse en un chat privado con el bot:

javascript
const TelegramBot = require('node-telegram-bot-api');
const bot = new TelegramBot(token, { polling: true });

bot.onText(/\/start/, (msg) => {
const chatId = msg.chat.id;
bot.sendMessage(chatId, '¡Te damos la bienvenida! Pulsa el botón de abajo para abrir la app.', {
reply_markup: {
inline_keyboard: [[
{
text: 'Abrir la app',
web_app: { url: 'https://your-domain.com/app' }
}
]]
}
});
});

Paso 2: configura el entorno

Crea una estructura básica para tu mini app de Telegram y prepara el entorno de pruebas:

Estructura de directorios del proyecto (el contenido de index.html aparece en el paso 3):

text
my-tma/
├── index.html
├── styles/
│ └── main.css
├── scripts/
│ └── app.js
└── assets/
└── images/

Paso 3: crea tu app

Guarda este HTML como index.html. Carga el puente de Telegram WebApp y scripts/app.js. Es un ejemplo de interfaz, no una implementación de autenticación: valida initData de Telegram en tu backend antes de confiar en la identidad del usuario.
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Mi primera TMA</title>
<link rel="stylesheet" href="styles/main.css">
<script src="https://telegram.org/js/telegram-web-app.js"></script>
</head>
<body>
<div id="app">
<h1>¡Hola, Telegram!</h1>
</div>
<script src="scripts/app.js"></script>
</body>
</html>

Personaliza el estilo de tu app

Guarda el siguiente código JavaScript como scripts/app.js. setupTheme aplica los colores del tema de Telegram, mientras que styles/main.css es una hoja de estilos independiente que puedes personalizar. Prueba la app en Telegram para Android e iOS. Importante: sendData solo funciona en Mini Apps abiertas desde un botón web_app del teclado de respuesta, no desde el botón inline del paso 1. Para guardar datos cuando se abre desde ese botón inline, implementa un endpoint en el backend y valida initData. Este ejemplo no guarda los datos ni procesa los mensajes web_app_data entrantes:

javascript
const app = {
data: { count: 0 },

init() {
this.setupTheme();
this.setupCounter();
this.setupMainButton();
},

setupTheme() {
const theme = window.Telegram.WebApp.themeParams;
document.body.style.backgroundColor = theme.bg_color;
document.body.style.color = theme.text_color;
},

setupCounter() {
const counter = document.createElement('div');
counter.innerHTML = `
<h2>Contador: <span id="count">0</span></h2>
<button id="increment">+1</button>
<button id="decrement">-1</button>
`;
document.querySelector('#app').appendChild(counter);

document.querySelector('#increment').onclick = () => this.updateCount(1);
document.querySelector('#decrement').onclick = () => this.updateCount(-1);
},

setupMainButton() {
const MainButton = window.Telegram.WebApp.MainButton;
MainButton.setText('Guardar');
MainButton.onClick(() => this.saveData());
MainButton.show();
},

updateCount(delta) {
this.data.count += delta;
document.querySelector('#count').textContent = this.data.count;
},

saveData() {
window.Telegram.WebApp.sendData(JSON.stringify(this.data));
}
};

window.Telegram.WebApp.ready();
app.init();

Amplía las funcionalidades

Una vez que tengas lo básico, puedes mejorar tu Mini App con funciones avanzadas:

  • Añade funciones Web3 basadas en TON cuando tenga sentido. Para comprar bienes y servicios digitales dentro de Telegram, usa Telegram Stars, no TON.
  • Añade pagos con Telegram Stars para bienes y servicios digitales, y asegúrate de confirmar los pagos y gestionar los reembolsos correctamente.
  • Guarda los datos de los usuarios en un servidor después de validar initData y comprobar todos los valores enviados.
  • Añade animaciones y lógica avanzada.
  • Añade notificaciones del bot con el permiso necesario del usuario. Una Mini App no puede enviar mensajes a cualquier usuario.
  • Añade un botón de menú para facilitar la navegación.

¿Y ahora qué?

  1. Despliega tu app en un servidor HTTPS.
  2. Conecta tu app con Telegram a través de @BotFather.
  3. Depura y prueba la app en condiciones reales.
  4. Lanza tu Mini App de Telegram y recopila las primeras opiniones.
  5. Comparte tu código en GitHub para recibir comentarios de la comunidad, pero no incluyas tokens del bot, secretos ni datos personales.
  6. Recopila opiniones de los usuarios e itera.

Sigue estos pasos y estarás más cerca de crear una Mini App de Telegram de éxito que aproveche al máximo el ecosistema, cada vez más amplio, de la plataforma.

Elizaveta Bydanova
Elizaveta Bydanova
Líder del equipo de desarrollo de negocios, Adsgram

Leer siguiente

Las últimas noticias de la industria, entrevistas, tecnologías y recursos

Plataforma automatizada todo en uno para publicidad efectiva

Comienza tu viaje publicitario con nosotros hoy.