ActualitéPublié le 8 min de lecture
Telegram ouvre les widgets HTML dans les messages des bots
Le 9 novembre 2026, Telegram a lancé la Bot API 10.4. Les bots peuvent désormais envoyer des widgets, de petits écrans interactifs en HTML dessinés dans le message lui-même. Pour l’instant, seulement dans la conversation privée avec le bot. Quelques jours plus tard, selon plusieurs signalements, les widgets ont cessé de fonctionner pour tout le monde, et au 18 novembre Telegram n’avait pas dit quand ils reviendraient.
Par Équipe LibertyBotBlog de LibertyBot

Mise à jour du 18 novembre : widgets hors service
Quelques jours après le lancement, les widgets ont cessé de fonctionner pour tout le monde, selon le canal d’actualités tginfo (s’ouvre dans un nouvel onglet), qui suit Telegram et a attribué la panne à des failles de sécurité. Telegram n’a pas expliqué pourquoi. Pavel Durov a répondu sur son canal (s’ouvre dans un nouvel onglet) que la faille signalée n’existe pas telle qu’elle a été décrite, qu’il fallait d’abord ouvrir un service tiers et que le problème a déjà été corrigé côté serveur. Au 18 novembre, aucune source officielle n’a dit que les widgets étaient revenus. Avant de prévoir quoi que ce soit avec eux, testez-les dans votre conversation avec le bot.
Ce qui a changé avec la Bot API 10.4
Le 9 novembre 2026, Telegram a publié la Bot API 10.4. La principale nouveauté est le widget, un bloc interactif fait en HTML que le bot dessine dans le message lui-même. Le lendemain, 10 novembre, Pavel Durov, fondateur de Telegram, l’a résumé ainsi sur son canal : « N’importe quel message Telegram peut désormais devenir une app ».
En pratique, le widget est un petit écran qui reste dans la bulle du message, au milieu de la conversation. La personne le touche et voit l’écran changer sans quitter la discussion. Telegram donne en exemple un sondage dont les barres bougent à chaque vote, une cotation qui se met à jour, un jeu de plateau et un code promo qui se copie d’un toucher.
Trois points expliquent comment il fonctionne.
- Le design est fixe. Le bot envoie le code du widget une fois, et personne ne le change ensuite. Pour modifier la mise en page, le bot envoie un nouveau widget.
- Les données changent. Ce qui s’affiche dedans, comme un score, un prix ou l’option choisie, le bot le met à jour dans le même message.
- Le toucher peut parler au bot. Si le bot autorise les requêtes en envoyant le widget, celui-ci envoie une courte requête au bot, comme le fait un bouton ordinaire, et le bot répond. Le bot sait qui a touché. Un toucher peut aussi ne changer que l’écran, sans aucune requête, comme ouvrir une réponse ou copier un code.
Le widget tourne sur l’appareil de la personne, isolé et sans accès à internet. Tout ce qu’il affiche vient du message ou du bot. Ce n’est pas non plus une Mini App. La Mini App est une page ouverte dans une fenêtre, alors que le widget fait partie du message et reste visible pendant que la conversation défile.
Il existe aussi le widget partagé. Le bot envoie le même widget dans plusieurs conversations et, quand il change ses données, le changement apparaît partout à la fois. C’est utile pour un score, un sondage ou un prix qui vaut pour tout le monde.
Où le widget fonctionne aujourd’hui
Telegram dit ouvrir les widgets par étapes. Dans le Telegram que tout le monde utilise, la 10.4 arrive avec trois verrous.
- Seulement dans la conversation privée avec le bot. Le widget en groupe, en mode inline et en transfert ne fonctionne pour l’instant que sur le serveur de test de Telegram, là où les développeurs testent. Dans un canal, le bot ne publie pas de widget.
- Contenu protégé. Tout widget envoyé est automatiquement protégé, et la personne ne peut pas transférer le message.
- Pas de copie. Même le bot ne peut pas copier le message du widget vers une autre conversation, car la Bot API refuse.
Toujours avec une légende
Celui qui utilise une app Telegram sans prise en charge des widgets voit le message comme un média non pris en charge, avec seulement la légende. C’est pourquoi Telegram demande une légende pour chaque widget. C’est elle qui apparaît dans la liste des discussions, dans les notifications et dans la recherche.
Ce que cela change pour ceux qui vendent sur Telegram
Jusqu’ici, le bot parlait avec du texte, des médias et des boutons sous le message. Le widget ouvre une autre voie, un écran qui répond au toucher dans la conversation. D’après les exemples de Telegram lui-même, on peut imaginer des usages comme ceux-ci, qui demandent tous que quelqu’un programme le widget.
- Questions fréquentes qui s’ouvrent au toucher. Le guide de Telegram lui-même prend comme exemple la liste de questions avec des réponses qui se déplient.
- Code promo copié d’un toucher. L’app affiche un avis avec le texte copié, donc la personne voit ce qu’elle a récupéré.
- Récapitulatif de commande. Une carte avec ce que la personne a choisi et le total, que le bot met à jour dans le même message.
- Sondage auprès du public. Un widget partagé envoyé à plusieurs acheteurs, avec un seul résultat pour tous.
Comme le widget ne va que dans la conversation privée et ne peut pas être transféré, il ne se propage pas tout seul. Celui qui le reçoit parle déjà au bot. Le widget peut aussi avoir des boutons ordinaires en dessous, comme n’importe quel message du bot.
Le portefeuille TON dans la Bot API 10.4
La 10.4 rapproche le bot du portefeuille de cryptomonnaie déjà intégré à l’app Telegram, le portefeuille TON. Par le widget, la personne paie et signe. En dehors du widget, le bot lit la carte du portefeuille et l’avis de transfert.
- Payer par le widget. Le widget demande une transaction au bot, la personne confirme dans une fenêtre du portefeuille, qui montre le bot, les montants et la destination, et le bot vérifie sur la blockchain que le paiement est parti.
- Signer avec le portefeuille. Le widget peut demander à la personne de signer une donnée avec son portefeuille, et le bot reçoit la signature.
- Carte du portefeuille. La carte que la personne affiche sur son profil, avec l’adresse et le solde, arrive au bot par les données du profil et aussi avec le toucher sur le widget.
- Avis de transfert. La conversation reçoit un avis de transfert fait avec un portefeuille TON, et le bot reçoit cet avis.
Le bouton de paiement n’apparaît pas pour tout le monde. Dans une ancienne app ou dans un pays où le portefeuille n’est pas disponible, il n’existe pas pour cette personne, et Telegram recommande de n’afficher le bouton que quand le portefeuille est là. Avant d’encaisser par n’importe quel moyen dans un bot, lisez les conditions de Telegram pour les bots (s’ouvre dans un nouvel onglet).
Les limites qui pèsent sur la vente
- Rien de l’extérieur. Le widget ne charge ni photo, ni police, ni page internet. Une image ne peut qu’être intégrée au code lui-même.
- Petit. Le code entier, avec ce qui y est intégré, fait au maximum 32 Ko et, après la compression par Telegram, au maximum 4 Ko. Une image intégrée ne se compresse presque pas.
- Pas de clavier. Le widget accepte le toucher, l’appui long et le glissement latéral (vers le haut et le bas, c’est la conversation qui défile), mais n’a pas de champ de texte. Pour demander un e-mail ou un nom, il faut toujours passer par la conversation.
- 600 pixels de haut au maximum. Rien ne défile à l’intérieur et le plein écran n’existe pas. Ce qui dépasse la hauteur est coupé.
- Pas de fonctions d’accessibilité dans cette version. Telegram demande que l’essentiel figure aussi dans la légende.
- Aucun secret. Telegram demande de traiter le code et les données partagées du widget comme publics.
Les autres nouveautés de la 10.4 qui touchent la vente
- Réponse visible seulement par celui qui a touché. Le toucher sur un bouton peut produire une réponse visible seulement par celui qui a touché, dans n’importe quelle conversation, sauf dans la discussion des messages directs d’un canal. En groupe, cela évite de remplir la conversation de réponses destinées à une seule personne.
- Numéro de carte repéré dans le texte. Telegram repère désormais les numéros de carte bancaire dans les messages, comme il repère déjà les téléphones et les e-mails, et le bot reçoit ce repérage.
Chez LibertyBot aujourd’hui
Les bots de LibertyBot n’envoient pas de widgets. Dans les flux Basique et Avancé, les plans apparaissent comme des boutons sous le message, un plan par ligne et, à la fin, RETOUR. Chaque plan peut avoir sa Couleur du bouton (Par défaut, Bleu, Vert ou Rouge), qui colore tout le bouton dans Telegram (dans une très ancienne app Telegram, le bouton apparaît sans couleur). Un plan activé sans prix n’apparaît pas pour le prospect.
Pour avoir le bot qui affiche ces boutons, commencez par comment créer un bot Telegram. Pour voir le chemin de la conversation jusqu’à la livraison, voyez comment fonctionne LibertyBot.
Questions fréquentes
Qu’est-ce qu’un widget sur Telegram ?
C’est un bloc interactif en HTML que le bot dessine dans le message. La personne le touche sans quitter la conversation, et le bot peut mettre à jour ce qu’il affiche.
Le widget fonctionne-t-il dans un groupe ou un canal ?
Dans le Telegram que tout le monde utilise, pas encore. Avec la Bot API 10.4, le widget va seulement dans la conversation privée avec le bot. En groupe, il n’existe pour l’instant que sur le serveur de test, et le bot ne publie pas de widget dans un canal.
Peut-on transférer ou copier un widget ?
Le transférer, pas aujourd’hui. Dans le Telegram que tout le monde utilise, le widget envoyé est protégé et ne peut pas être transféré. Le copier, non plus, car la Bot API ne copie pas le message d’un widget.
Un widget, est-ce la même chose qu’une Mini App ?
Non. La Mini App est une page ouverte dans une fenêtre, avec internet. Le widget vit dans le message, n’a pas internet et ne parle qu’au bot.
Sources (vérifiées le )
- Bot API de Telegram : changelog de la version 10.4 (9/11/2026) (s’ouvre dans un nouvel onglet)
- Telegram : guide des widgets pour les bots (s’ouvre dans un nouvel onglet)
- Bot API de Telegram : sendWidget (s’ouvre dans un nouvel onglet)
- Bot API de Telegram : TonWalletCard (s’ouvre dans un nouvel onglet)
- Canal Telegram Bot News : annonce de la Bot API 10.4 (s’ouvre dans un nouvel onglet)
- Canal de Pavel Durov : message du 10/11/2026 (s’ouvre dans un nouvel onglet)
- Canal de Pavel Durov : réponse sur la faille des widgets (s’ouvre dans un nouvel onglet)
- Canal d’actualités tginfo (non officiel) : widgets désactivés (s’ouvre dans un nouvel onglet)
- Canal d’actualités tginfo (non officiel) : les widgets restent désactivés (s’ouvre dans un nouvel onglet)
- Conditions d’utilisation de Telegram pour les bots (s’ouvre dans un nouvel onglet)


