Habilidades telegram-mini-app
📦

telegram-mini-app

Seguro

Crear Mini Apps de Telegram con Integración de TON

Crea aplicaciones web con experiencia nativa que se ejecutan dentro de Telegram para más de 800 millones de usuarios. Integra blockchain TON, pagos y mecanismos virales sin salir del ecosistema de Telegram.

Soporta: Claude Codex Code(CC)
🥉 72 Bronce
1

Descargar el ZIP de la skill

2

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

3

Activa y empieza a usar

Pruébalo

Usando "telegram-mini-app". Configurar una Mini App básica de Telegram con saludo de usuario

Resultado esperado:

Página HTML con SDK de Telegram cargado, nombre del primer nombre del usuario mostrado usando initDataUnsafe.user, botón principal configurado con colores del tema de Telegram

Usando "telegram-mini-app". Agregar conexión de billetera TON a una Mini App existente

Resultado esperado:

TonConnectUIProvider envolviendo la app, componente TonConnectButton en el header, manifest.json con metadatos de la app, dirección de billetera accesible después de la conexión

Auditoría de seguridad

Seguro
v1 • 2/25/2026

Static analyzer flagged 41 patterns that are all false positives. The skill file (SKILL.md) is documentation-only markdown containing code examples. Backticks are markdown code fences, not shell execution. URLs are official Telegram SDK links or documentation placeholders. No executable code or security risks present.

1
Archivos escaneados
284
Líneas analizadas
0
hallazgos
1
Auditorías totales
No se encontraron problemas de seguridad
Auditado por: claude

Puntuación de calidad

38
Arquitectura
100
Mantenibilidad
87
Contenido
32
Comunidad
100
Seguridad
100
Cumplimiento de la especificación

Lo que puedes crear

Mini App de Juegos Web3

Crea un juego play-to-earn con integración de billetera TON, recompensas NFT y mecanismos de referido viral que se propagan a través de compartido en Telegram.

Tienda de Comercio Electrónico

Crea una Mini App comprable con pagos de Telegram Stars, seguimiento de pedidos y checkout fluido dentro de la interfaz de Telegram.

Herramienta de Compromiso Comunitario

Desarrolla una app de fidelización gamificada con recompensas diarias, rachas, tablas de clasificación y insignias de logros para aumentar el compromiso del canal.

Prueba estos prompts

Configuración Básica de Mini App 
Crea una plantilla HTML de Telegram Mini App con configuración de viewport adecuada, inicialización del SDK de Telegram Web App y extracción de datos del usuario desde initDataUnsafe.
Mini App React con Hooks 
Construye un hook de React para integración de Telegram Web App que exponga datos del usuario, query ID y métodos principales como expand, close y ready con tipos TypeScript apropiados.
Integración de Billetera TON 
Implementa la integración de billetera TON Connect para una Mini App de React incluyendo el wrapper del proveedor de UI, el componente de botón de conexión y la configuración del archivo de manifest.
Flujo de Pagos y Transacciones 
Crea un componente de botón de pago que envíe transacciones TON usando tonConnectUI, maneje la conversión a nanoton y establezca ventanas de validez de transacción.

Mejores prácticas

  • Siempre valida initData usando la verificación HMAC de Telegram en tu backend antes de confiar en la identidad del usuario
  • Coincide con el tema de Telegram usando variables CSS themeParams para una sensación nativa fluida
  • Diseña mobile-first con objetivos táctiles mínimos de 44px y prueba en dispositivos reales

Evitar

  • Ignorar los parámetros del tema de Telegram resultando en transiciones visuales bruscas
  • Diseñar para desktop cuando el 95% del uso de Telegram es móvil
  • Omitir estados de carga que hacen que los usuarios piensen que la app está rota

Preguntas frecuentes

¿Cómo descubren los usuarios mi Mini App?
Las Mini Apps se acceden a través de comandos del bot, botones en línea o enlaces directos. Los usuarios también pueden encontrarlas en el directorio de Mini Apps de Telegram una vez publicadas.
¿Puedo usar mi aplicación web existente como Mini App?
Sí, pero debes integrar el SDK de Telegram Web App y adaptar tu UI para coincidir con el tema de Telegram. El diseño responsivo mobile-first es esencial.
¿Qué es TON Connect y lo necesito?
TON Connect es un protocolo para conectar billeteras TON a Mini Apps. Solo lo necesitas si tu aplicación requiere transacciones blockchain o pagos con criptomonedas.
¿Cómo funcionan los pagos con Telegram Stars?
Telegram Stars es la moneda virtual de Telegram. Los usuarios compran Stars y luego los gastan en Mini Apps. Los desarrolladores pueden retirar ganancias como criptomoneda TON.
¿Pueden las Mini Apps acceder a datos del usuario sin permiso?
No. Los datos del usuario vienen de initDataUnsafe que Telegram proporciona solo cuando el usuario abre tu Mini App. Siempre verifica estos datos en tu backend.
¿Necesito alojar mi Mini App en servidores específicos?
Cualquier aplicación web alojada en HTTPS funciona. Telegram no requiere alojamiento específico. Sin embargo, TON Connect requiere un dominio HTTPS válido para el archivo de manifest.

Detalles del desarrollador

Autor

sickn33

Licencia

MIT

Repositorio

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/telegram-mini-app

Ref.

main

Estructura de archivos

📄 SKILL.md