Mini apps Telegram : fonctionnement, sécurité et création

Une mini app Telegram, c'est une application web qui s'ouvre directement dans Telegram, sans rien installer. Jeux, portefeuilles crypto, boutiques, outils de productivité : des millions de personnes les utilisent chaque jour. Ce guide explique ce qu'est une mini app, comment l'ouvrir, les mini apps populaires, les questions de sécurité et le fameux « virus », comment créer sa propre mini app et comment fonctionnent les paiements en Stars.

Une mini app n'a pas accès à votre téléphone ou à vos messages sans votre autorisation, mais un lien piégé peut toujours mener à une arnaque. Ne saisissez jamais votre code de connexion Telegram dans une mini app.

Une mini app, c'est une page web dans Telegram

Techniquement, une mini app est un site web (HTML, CSS, JavaScript) qu'un bot ouvre dans une fenêtre intégrée de Telegram. Elle peut connaître votre nom et votre identifiant Telegram, adapter ses couleurs au thème de l'application, s'afficher en plein écran et demander des paiements. Elle est liée à un bot, ce qui explique qu'on parle aussi de « mini app de bot ». Pour comprendre les bots : bots Telegram.

Ouvrir une mini app : bouton, lien, menu

• Bouton du menu : dans la conversation avec un bot, un bouton à côté du champ de saisie ouvre l'app.
• Lien direct : un lien de type t.me/nomdubot/app ouvre directement la mini app.
• Boutons dans les messages : un canal ou un bot peut afficher un bouton « Ouvrir ».
• Recherche et catalogue : la recherche de Telegram propose une section d'applications populaires.

Les bases de l'application : Telegram, comment ça marche.

Mini apps populaires : jeux, portefeuilles, outils

Sécurité : permissions, liens piégés, « virus »

Une mini app fonctionne dans un environnement isolé, comme un site web : elle ne peut pas lire vos conversations ni installer quoi que ce soit sur votre téléphone. Elle doit demander votre accord pour votre numéro, votre position ou l'envoi de messages. Le vrai risque vient de ce que vous faites dans l'app : connecter un portefeuille et signer une transaction malveillante, saisir un mot de passe ou télécharger un fichier proposé par l'app. Ce que l'on appelle « virus » dans les recherches désigne surtout des faux jeux qui volent des portefeuilles ou des comptes. Vérifiez toujours que le bot est le bon, avec le bon nom d'utilisateur.

Créer une mini app : outils et étapes

1. Créez un bot avec @BotFather : créer un bot Telegram.
2. Développez votre site web avec le framework de votre choix et le script officiel des Web Apps de Telegram.
3. Hébergez le site en HTTPS.
4. Dans @BotFather, associez l'URL de votre site au bot comme mini app.
5. Vérifiez côté serveur les données d'initialisation signées par Telegram pour identifier l'utilisateur de façon fiable.

Des modèles et exemples open source existent sur GitHub pour démarrer plus vite.

Les paiements en Stars dans les mini apps

Pour les produits et services numériques, les mini apps utilisent les Telegram Stars, la monnaie interne de Telegram. L'utilisateur achète des Stars puis paie dans l'app ; le développeur peut ensuite convertir ses revenus via Fragment. Plus de détails : Telegram Premium et Stars.

Une mini app de jeu

TotalHash est un jeu de minage gratuit qui fonctionne comme une mini app dans Telegram. Les achats en Stars sont facultatifs et les tâches envoient de petites sommes en USD₮ et GRAM sur un portefeuille TON. Aucune promesse de gain.

Questions fréquentes

Qu'est-ce qu'une mini app Telegram ?

Une application web qui s'ouvre dans Telegram via un bot, sans installation.

Une mini app Telegram peut-elle contenir un virus ?

Elle ne peut rien installer, mais de faux jeux peuvent voler un portefeuille si vous signez une transaction.

Comment créer une mini app Telegram ?

Créez un bot avec @BotFather, développez un site en HTTPS et associez-le comme mini app.

Comment payer dans une mini app ?

Avec les Telegram Stars pour les produits numériques.