Bots Telegram et Mini Apps sur localhost : setWebhook, l'en-tête secret-token et la nouvelle vérification d'origine
Exécutez des bots Telegram et des Mini Apps sur localhost : configurez setWebhook, vérifiez l'en-tête secret-token et passez la vérification d'origine du Bot API 10.2. Conseils pour un tunnel stable.

Quick answer
Bots Telegram et Mini Apps sur localhost : Guide Webhook 2026: webhook testing answer
For local webhook testing, run your app locally, expose it with a public HTTPS tunnel, and paste the stable callback URL into the provider dashboard.
How do I test webhooks on localhost?
Start your local server, open a public HTTPS tunnel to that port, configure the provider webhook URL, and inspect events in your local logs.
Why does a stable webhook URL matter?
Stable URLs prevent provider dashboards from needing manual callback updates every time you restart a tunnel.
Telegram ne peut livrer les mises à jour que vers une adresse publique HTTPS, et localhost n’en fait pas partie. Depuis le 20 juillet 2026, les Mini Apps présentent une deuxième contrainte. Telegram bloque désormais les méthodes des Mini App lorsqu’elles sont appelées à partir d’une origine différente du domaine propre à la Mini App. Ensemble, ces deux faits font de votre URL de tunnel une pièce maîtresse de la configuration, et non un détail jetable.
Ce guide couvre le développement d’un bot Telegram et d’une Mini App sur une machine locale :
- enregistrer le webhook avec
setWebhook - authentifier les requêtes avec l’en-tête secret-token
- gérer les champs de mise à jour inconnus sans déclencher de nouveaux essais
- valider le
initDatade la Mini App - comprendre ce que la nouvelle vérification d’origine fait à une configuration de développement
Qu’est-ce qui a changé dans Bot API 10.2 (et ce qui a été livré depuis)
Telegram a publié Bot API 10.2 le 14 juillet 2026. Selon le journal officiel des modifications, cette version a également renforcé la sécurité des Mini App en interdisant les méthodes Mini App depuis des origines différentes du domaine d’origine de la Mini App. Cette protection a été activée automatiquement pour toutes les Mini Apps le 20 juillet 2026. Les bots peuvent se désengager via la Mini App BotFather. Se désengager signifie assumer la responsabilité de s’assurer que la Mini App n’a pas de liens vers des sites non fiables. La chaîne BotNews de Telegram a annoncé le changement comme avertissement: les sites externes ouverts depuis des liens dans une Mini App ne peuvent plus utiliser les méthodes Mini App par défaut.
D’autres ajouts de 10.2 valent la peine d’être connus, car ils apparaissent dans vos charges utiles de webhook :
- Messages éphémères : nouvelles méthodes de modification et de suppression, plus
receiver_useretephemeral_message_idsurMessage. - Messages riches :
InputRichMessagea obtenu les champsblocksetmedia. - Communities : un nouveau type
Community, les messages de servicecommunity_chat_addedetcommunity_chat_removed, et un champcommunitysurChatFullInfo. - Abonnements : un nouveau champ de premier niveau
subscriptionsurUpdate, portant un objetBotSubscriptionUpdated.
L’API Bot a continué d’évoluer depuis lors :
- Bot API 10.3 (24 août 2026) :
- boutons dans les messages riches
- boutons inline désactivés
- les paramètres des
ephemeral-messageconsolidés en un seul objetephemeral_message_parameters - un bouton Stop natif pour les brouillons en flux
- un nouveau champ
stopped_message_generationsurUpdate
- Bot API 10.4 (9 novembre 2026) :
- Widgets HTML, via
sendWidget,sendSharedWidget,answerWidgetQuery,editMessageWidgetDataeteditSharedWidgetData - Cartes TON et messages de service de transfert
- répliques éphémères déclenchées par les appuis sur les boutons
- selon les notes de version des bibliothèques, nouveaux types de mise à jour
widget_queryetshared_widget_query
- Widgets HTML, via
Aucune des annonces de 10.2 à 10.4 ne change la manière dont setWebhook ou l’en-tête secret-token fonctionnent. L’objet Update continue d’acquérir des champs de premier niveau, ce qui explique pourquoi l’étape 3 est importante.
Pourquoi localhost ne fonctionne pas pour les webhooks Telegram
Un webhook est une requête POST HTTPS sortante des serveurs de Telegram vers votre URL. Telegram ne peut pas atteindre http://localhost:3000, vous avez donc besoin d’un point final HTTPS public qui redirige vers votre machine. Exigences documentées par Telegram :
- L’URL doit être HTTPS.
- Les ports pris en charge pour le webhook sont 443, 80, 88 et 8443.
- Tant qu’un webhook est configuré, vous ne pouvez pas recevoir de mises à jour via
getUpdates. - Un certificat auto-signé nécessite de télécharger le certificat public via le paramètre
certificate, ce qui est rarement utile en développement. - Selon le résumé de Hookdeck de guide des webhooks Telegram, la livraison est IPv4-only et nécessite TLS 1.2 ou plus récent.
- Les mises à jour non livrées ne sont pas stockées plus de 24 heures.
Un tunnel satisfait tout cela en même temps. Il vous donne un nom d’hôte public avec un certificat valide sur le port 443 et redirige le trafic vers un port local comme 3000.
Il existe une exception unique côté bot. Si vous exécutez le serveur open-source telegram-bot-api localement, Telegram indique que votre bot peut utiliser une URL webhook HTTP, n’importe quelle adresse IP locale et n’importe quel port. Cela supprime le tunnel pour la livraison du webhook. Cela ne rend pas une Mini App accessible depuis un téléphone, car le client Telegram doit encore charger l’URL de la Mini App.
Chaque bot a exactement une URL de webhook. Appeler à nouveau setWebhook la remplace. Utilisez un bot de développement distinct, créé via BotFather, afin que vos expériences ne redirigent pas le trafic de production.
Étape 1 : Enregistrer le webhook avec setWebhook
Démarrez votre serveur local, lancez votre tunnel, puis enregistrez l’URL publique :
curl -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/setWebhook" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-subdomain.example.com/telegram/webhook",
"secret_token": "'"$TELEGRAM_WEBHOOK_SECRET"'",
"allowed_updates": ["message", "callback_query"],
"drop_pending_updates": true
}'
Les paramètres que vous utiliserez réellement :
| Parameter | What it does |
|---|---|
url |
HTTPS URL qui reçoit un seul Update JSON sérialisé par POST. Une chaîne vide retire le webhook. |
secret_token |
Secret renvoyé dans l’en-tête à chaque requête. 1–256 caractères. |
allowed_updates |
Types de mises à jour à recevoir. Une liste vide signifie tous les types sauf chat_member, message_reaction et message_reaction_count. Si omis, le réglage précédent est conservé. |
max_connections |
Nombre maximum de connexions HTTPS simultanées pour la livraison, 1–100, valeur par défaut 40. |
drop_pending_updates |
Supprime l’arriéré, utile lorsque vous déplacez un bot vers une nouvelle URL. |
ip_address |
Adresse IP fixe à utiliser au lieu de résoudre le DNS. |
certificate |
Certificat public (téléchargé en tant que fichier) pour les configurations auto-signées. |
Deux habitudes font gagner du temps en développement :
- Définir
drop_pending_updateslorsque vous changez les URL, afin que votre serveur local ne soit pas inondé de messages périmés. - Appeler
getWebhookInfoà chaque arrêt des livraisons. Il rapporte l’URL actuelle,pending_update_count,last_error_date,last_error_messageet lesallowed_updatesactifs.
Une modification de allowed_updates ne s’applique pas aux mises à jour créées avant l’appel, donc quelques mises à jour indésirables peuvent encore arriver.
curl "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/getWebhookInfo"
Pour revenir au polling, appelez deleteWebhook.
Étape 2 : Vérifier l’en-tête secret-token
Si vous passez secret_token à setWebhook, Telegram l’inclura dans chaque requête webhook dans l’en-tête X-Telegram-Bot-Api-Secret-Token. Le jeton doit comporter entre 1 et 256 caractères, et utiliser uniquement les caractères A-Z, a-z, 0-9, _ et -.
Cela est important car votre URL de tunnel est publique. Sans secret, toute personne qui découvre l’URL peut envoyer des mises à jour forgées, et rien dans la requête n’identifie Telegram. Si vous ne définissez aucun jeton, Telegram n’enverra pas du tout d’en-tête.
Le mécanisme est un secret partagé, pas une signature. Rien n’est calculé sur le corps, donc un secret divulgué permet à un attaquant de forger les requêtes jusqu’à ce que vous le tourniez. La rotation est simple : réutilisez setWebhook avec une nouvelle valeur. Le guide de Hookdeck répertorie aussi les plages sources publiées par Telegram (149.154.160.0/20 et 91.108.4.0/22) comme une seconde couche optionnelle, et note qu’elles peuvent changer.
Un gestionnaire Express minimal :
import express from "express";
import crypto from "node:crypto";
const SECRET = process.env.TELEGRAM_WEBHOOK_SECRET;
if (!SECRET) throw new Error("TELEGRAM_WEBHOOK_SECRET is not set");
const app = express();
app.use(express.json());
function secretMatches(received) {
const a = Buffer.from(received ?? "");
const b = Buffer.from(SECRET);
return a.length === b.length && crypto.timingSafeEqual(a, b);
}
app.post("/telegram/webhook", (req, res) => {
if (!secretMatches(req.get("x-telegram-bot-api-secret-token"))) {
return res.sendStatus(401);
}
res.sendStatus(200); // acknowledge, then process
handleUpdate(req.body).catch(console.error);
});
app.listen(3000);
Trois détails valent la peine d’être copiés :
- La comparaison est en temps constant.
- La vérification s’exécute avant que toute logique n’accède au corps.
- Le gestionnaire échoue de manière ferme si le secret n’est pas configuré.
Telegram ne publie pas de délai de réponse, alors ne faites pas dépendre la livraison d’un travail lent. Persistez ou mettez la mise à jour en file avant d’envoyer le 200, puis traitez-la. Si vous retournez 200 puis plantez, la mise à jour est perdue, stockez-la donc avant d’accuser réception.
Étape 3 : Tolérer les champs inconnus afin que Telegram ne réessaie pas
Telegram considère toute réponse autre qu’un code 2xx comme une livraison échouée. Il recommence la requête et abandonne après ce qu’il appelle un « nombre raisonnable d’essais », sans publier de calendrier. Cela a une conséquence nette pour les parsers stricts. Si votre gestionnaire rejette une mise à jour parce qu’elle contient un champ que vous ne reconnaissez pas, Telegram la renvoie continuellement, et vos journaux se remplissent des mêmes échecs.
Un Update contient update_id et au plus un autre champ, et l’ensemble de ces champs continue de s’élargir : managed_bot, guest_message, subscription, stopped_message_generation et, dans 10.4, les requêtes de widgets. Un décodeur qui échoue sur des clés inattendues peut commencer à renvoyer des erreurs alors que votre bot ne présente aucun problème. Règles pratiques :
- Analyser les champs que vous connaissez et ignorer les autres. En TypeScript avec Zod, évitez
.strict()sur les schémas webhook. En Go, évitezDisallowUnknownFieldssur le décodeur. En Rust avec serde, n’ajoutez pasdeny_unknown_fieldsaux types Telegram. - Renvoyez le 200 pour les mises à jour que vous ne traitez pas. Une mise à jour non prise en charge n’est pas une erreur.
- Journalisez les types de mise à jour inconnus à bas niveau, afin de remarquer les nouvelles fonctionnalités sans casser la livraison.
- Éliminer les doublons sur
update_id. Telegram le décrit comme le moyen d’ignorer les mises à jour répétées et de rétablir l’ordre. Après une semaine sans mises à jour, le prochain ID est choisi au hasard plutôt que de façon séquentielle. - Épinglez votre bibliothèque Telegram et lisez ses notes de version avant la mise à niveau. Les bibliothèques diffèrent dans la rapidité à couvrir les nouvelles versions de Bot API, et certaines abandonnent silencieusement des types de mises à jour qu’elles ne connaissent pas.
async function handleUpdate(update) { if (update.message) return onMessage(update.message); if (update.callback_query) return onCallback(update.callback_query); const kind = Object.keys(update).find((k) => k !== "update_id"); console.info("unhandled update kind:", kind); }
Utilisez allowed_updates comme couche secondaire. S’abonner uniquement aux types que vous gérez empêche l’arrivée de déclenchements non liés.
Étape 4 : Servir une Mini App depuis localhost
Une Mini App est une page web qui s’exécute dans le navigateur intégré de Telegram et communique avec le client via window.Telegram.WebApp. En développement, pointez-la vers votre URL de tunnel :
- Lancez votre serveur de développement frontend sur un port local.
- Démarrez le tunnel et notez le nom d’hôte HTTPS public.
- Définissez cette URL là où la Mini App est lancée. Telegram documente plusieurs itinéraires : un bouton inline ou clavier
web_app, le bouton de menu du bot (via/setmenubuttondans BotFather ou Menu Button dans les paramètres du bot), la Mini App principale du bot dans BotFather, et des liens directs du typehttps://t.me/botusername/appname. - Ouvrez le bot dans Telegram et lancez la Mini App.
Conservez le même nom d’hôte partout où il apparaît. La vérification d’origine ci-dessous rend cela plus qu’un simple détail.
Les Mini Apps en production sont servies via HTTPS, ce que n’importe quel tunnel fournit. L’environnement de test séparé de Telegram est l’exception. Il utilise son propre compte et son propre bot, et sa documentation autorise des liens HTTP simples pour les Mini Apps là-bas. Vous l’appelez via https://api.telegram.org/bot<token>/test/METHOD_NAME.
Deux pièges courants des frameworks reviennent souvent :
Vérifications d’hôte. Le serveur de développement de Vite répond uniquement aux requêtes dont l’en-tête
Hostestlocalhost, un sous-domaine.localhostou une adresse IP. Sinon il renvoie « Demande bloquée. Cet hôte n’est pas autorisé. » Ajoutez le nom d’hôte de votre tunnel àserver.allowedHosts. Un point initial correspond aux sous-domaines. N’en rien faire : ne définissez pasallowedHosts: true, car cela accepte n’importe quel en-têteHostet ouvre le serveur de dev au DNS rebinding.Rafraîchissement à chaud. Le WebSocket HMR doit aussi traverser le tunnel. Derrière un tunnel HTTPS, vous pourriez avoir besoin de définir
server.hmr.clientPortsur 443. Le guide Strapi le suggère, mais testez-le sur votre configuration.
Pour déboguer à l’intérieur du client Telegram, Telegram documente ces options :
- iOS : touchez l’icône Paramètres 10 fois et activez « Allow Web View Inspection », puis utilisez le menu Développement de Safari.
- Android : activez « WebView Debug » dans les paramètres de débogage de Telegram, puis ouvrez
chrome://inspect/#devices. - Desktop : la bêta Windows/Linux propose une inspection webview expérimentale, et la bêta macOS propose une option « Debug Mini Apps ».
Valider initData sur votre serveur
Lorsque la Mini App s’ouvre, window.Telegram.WebApp.initData contient une chaîne de requête signée. Elle est vide si la Mini App a été lancée depuis un bouton du clavier ou en mode inline. Ne faites jamais confiance à initDataUnsafe ou à tout objet utilisateur côté client. Envoyez la chaîne brute à votre backend et vérifiez-la avec l’algorithme documenté par Telegram :
- Supprimez le champ
hash. Conservez tous les autres champs reçus, y comprissignature, qui existe pour vérification par des tiers. - Triez les paires
key=valuerestantes par clé et assemblez-les avec des sauts de ligne (\\n). - Calculez une clé secrète : HMAC-SHA256 du token du bot, en utilisant la chaîne constante
WebAppDatacomme clé. - Calculez le HMAC-SHA256 de la chaîne de contrôle des données avec cette clé secrète, en hexadécimal.
- Comparez-la à
hashen temps constant, et rejetez les valeursauth_dateobsolètes.import crypto from "node:crypto"; function verifyInitData(initData, botToken, maxAgeSeconds = 3600) { const params = new URLSearchParams(initData); const hash = params.get("hash"); params.delete("hash"); const checkString = [...params.entries()] .sort(([a], [b]) => (a < b ? -1 : 1)) .map(([k, v]) => `${k}=${v}`) .join("\\n"); const secret = crypto.createHmac("sha256", "WebAppData").update(botToken).digest(); const expected = crypto.createHmac("sha256", secret).update(checkString).digest("hex"); const valid = hash && hash.length === expected.length && crypto.timingSafeEqual(Buffer.from(hash), Buffer.from(expected)); const fresh = Date.now() / 1000 - Number(params.get("auth_date")) <= maxAgeSeconds; return Boolean(valid && fresh); }
Telegram indique seulement de vérifier auth_date pour éviter les données périmées. La fenêtre d’une heure est votre choix. Si un tiers a besoin de valider les données sans le token de votre bot, Telegram propose un flux signature Ed25519 qui utilise l’ID numérique de votre bot et les clés publiques de Telegram.
La nouvelle vérification d’origine des Mini Apps, expliquée
Avant le 20 juillet 2026, toute page ouverte dans le webview de votre Mini App pouvait appeler les méthodes Telegram.WebApp.* telles que close(), expand(), le bouton principal ou sendData(). Désormais, ces appels ne sont autorisés que depuis le domaine propre à la Mini App. Le changelog de Telegram le nomme le « domaine d’origine de la Mini App ». La documentation des tiers le décrit comme le domaine enregistré dans BotFather.
Ce que cela signifie en pratique, selon l’article de Leadgram sur ce changement :
- Pages sur le domaine de la Mini App continuent de fonctionner.
- Pages sur un autre domaine ouvertes dans la Mini App, comme une page d’offre, une page de paiement ou une page d’authentification, ne peuvent plus appeler les méthodes de la Mini App. La note d’AdsGram signale aussi les configurations basées sur des iframes et multi-domaines comme affectées.
- Tout le reste fonctionne encore. Les pages tierces restent ouvertes dans le webview, et les liens ordinaires, les redirections HTTP, les liens
t.meet les appels côté serveur ne sont pas affectés. Exactement une chose est bloquée : appeler les méthodes de la Mini App de Telegram depuis un domaine étranger. Les appelsfetchsimples depuis votre page vers un domaine API séparé relèvent d’un autre problème. - Le domaine enregistré doit être le réel. Leadgram prévient que si l’URL de votre Mini App pointe vers une redirection, un tracker ou un courtier, la Mini App sera enregistrée sur ce domaine. Vos appels Telegram sur votre vrai domaine seront alors bloqués. Orientez l’enregistrement vers la destination finale.
Ce que cela signifie pour localhost et les tunnels
La règle porte sur les noms d’hôte. Ces conséquences en découlent :
- Des URL aléatoires et rotatives signifient que le nom d’hôte servant votre page change tandis que celui que vous avez enregistré reste ancien. Attendez-vous à ce que les méthodes de la Mini App échouent tant que vous ne les mettez pas à jour partout.
- Un sous-domaine stable vous permet d’enregistrer l’origine de la Mini App une fois. L’URL dans BotFather, celle utilisée par votre frontend et celle de votre webhook restent les mêmes entre les redémarrages.
- Des environnements séparés méritent des noms d’hôte distincts, idéalement avec un bot de développement distinct pour chacun. Gardez chaque page qui appelle
Telegram.WebAppsur le domaine enregistré.
Une liste de vérifications pour déboguer lorsqu’une méthode de la Mini App cesse de fonctionner en développement :
- Comparez l’origine de la page avec l’URL enregistrée. Sont-elles identiques, y compris le sous-domaine ?
- Vérifiez s’il existe une redirection intermédiaire entre l’URL enregistrée et la page.
- Recherchez dans votre code
Telegram.WebAppet vérifiez quels domaines servent ces pages. Leadgram suggère de suivre le chemin de l’utilisateur dans Telegram Desktop ou web.telegram.org avec DevTools ouvert. - Recherchez des iframes ou des navigations vers d’autres domaines, comme des fournisseurs d’auth ou des pages de paiement.
- Confirmez que le nom d’hôte du tunnel n’a pas changé depuis votre dernière inscription.
Si une page étrangère ne fait que appeler close() ou openLink(), la solution proposée par Leadgram consiste à remplacer l’appel par un lien ordinaire https://t.me/... ou une redirection.
Faut-il se désengager ?
La BotFather Mini App vous permet de désactiver la protection, mais la formulation de Telegram est un avertissement : en le faisant, vous prenez la responsabilité de veiller à ce que la Mini App ne fasse aucun lien vers des sites non fiables. Se désengager rétablit le comportement ancien, où toute page dans le webview pouvait piloter l’application, ce qui est exactement ce que Telegram a fermé. Se désengager pour faire fonctionner un environnement de développement n’est pas la bonne solution lorsque le véritable problème est une incompatibilité d’origine. Corrigez l’incompatibilité, gardez la protection activée, et réservez le désengagement pour les cas où vous contrôlez entièrement chaque page vers laquelle la Mini App peut naviguer.
Choisir un tunnel : pourquoi un sous-domaine stable est la réponse pratique
Chaque élément de configuration Telegram dans cet article est lié à une URL : le point de terminaison du webhook, le domaine de la Mini App et l’origine contre laquelle Telegram compare lorsqu’une page appelle une méthode de la Mini App. Lorsque l’URL change à chaque redémarrage, vous réenregistrez les trois à chaque fois. Une mise à jour oubliée produit des symptômes déroutants, comme des webhooks en silence ou des méthodes de Mini App qui fonctionnaient hier et échouent aujourd’hui.
Ce que vous offrent les options gratuites documentées :
| Option | Hostname | Notes |
|---|---|---|
| ngrok Free | Un domaine dev attribué par compte qui ne change pas lors du redémarrage de l’agent | Limites selon la documentation de ngrok : 1 Go de transfert de données sortant et 20 000 requêtes HTTP par mois, jusqu’à 3 points de terminaison en ligne. Les points de terminaison gratuits n’ont pas de délai d’expiration. |
| Cloudflare Quick Tunnel | Nom d’hôte aléatoire trycloudflare.com à chaque exécution |
Aucun compte requis, mais Cloudflare le marque comme test-only, avec une limite de 200 requêtes simultanées et sans Server-Sent Events. |
| Cloudflare named tunnel | Un nom d’hôte que vous choisissez sur votre domaine | Nécessite un compte Cloudflare et un domaine. |
Gardez à l’esprit l’interstitiel ngrok. Sur le niveau gratuit, ngrok affiche une page d’interstitiel devant tout le trafic HTML du navigateur. ngrok indique que cela n’affecte pas l’accès API ou programmatique, donc les livraisons webhook ne devraient pas être affectées. Une page Mini App chargée dans le webview de Telegram est du trafic HTML du navigateur, donc les utilisateurs peuvent voir la page d’avertissement. ngrok décrit deux moyens de le retirer : passer à un plan payant ou que le client envoie un en-tête skip ou un User-Agent non standard. La route d’en-tête est maladroite pour une page que le webview de Telegram charge.
D’autres services de tunneling offrent des sous-domaines stables sur des plans gratuits ou payants. Vérifiez les conditions actuelles de votre fournisseur pour la persistance des sous-domaines, la durée des sessions et les pages d’avertissement du navigateur avant de vous y fier.
Une liste de vérification de mise en place
- Créez un bot de développement dédié dans BotFather.
- Choisissez un tunnel avec un nom d’hôte stable, et utilisez ce nom d’hôte pour le webhook et la Mini App.
- Appelez
setWebhookune fois, avec unsecret_tokenet unallowed_updatesrestreint. - Enregistrez l’URL de la Mini App sur le même nom d’hôte. Évitez les redirections.
- Autorisez l’hôte dans la vérification d’hôte de votre serveur de développement.
- Vérifiez l’en-tête secret-token et
initDatacôté serveur. - Ignorez et journalisez les champs de mise à jour inconnus, et dédupliquez sur
update_id. - Lorsque les livraisons s’arrêtent, vérifiez
getWebhookInfod’abord.
Questions fréquemment posées
Quels ports Telegram peut-il envoyer les webhooks ?
443, 80, 88 et 8443. Un tunnel expose le port 443 et redirige vers le port local que vous utilisez.
Que se passe-t-il si mon webhook renvoie une erreur ?
Telegram considère les réponses non-2xx comme des échecs et réessaie, abandonnant après « un nombre raisonnable d’essais ». Un point de terminaison qui renvoie une erreur pour des données inattendues peut provoquer des livraisons répétées.
Puis-je ignorer le tunnel et utiliser getUpdates ?
Pour la logique du bot, oui, tant qu’aucun webhook n’est configuré. Une Mini App a encore besoin d’une URL que le client Telegram peut charger, donc elle nécessite un nom d’hôte public HTTPS. Les exceptions sont l’environnement de test et un serveur Bot API local, qui ne couvre que le côté bot.
Le secret token est-il obligatoire ?
Non, mais sans lui rien dans une requête n’identifie Telegram, et toute personne qui trouve votre URL de tunnel peut envoyer des mises à jour forgées.
Bot API 10.2 est-elle la dernière version ?
Non. Bot API 10.3 (24 août 2026) et 10.4 (9 novembre 2026) ont été publiées depuis. Le comportement de vérification d’origine du webhook et de la Mini App décrits ici reste valable.
Sources
- Journal des modifications de Telegram Bot API
- Référence Bot API Telegram : setWebhook, getWebhookInfo, Update, serveur Bot API local
- Documentation des Mini Apps Telegram : validation initData, tests, débogage
- Chaîne BotNews sur Telegram (avertissement d’origine 10.2, annonces 10.3 et 10.4)
- Guide de migration Bot API 10.2, DEV Community
- Guide des webhooks Telegram, Hookdeck
- Verrouillage de l’origine des Mini Apps, docs Leadgram
- Erreurs de développement de la Mini App Telegram, AdsGram
- Support Bot API 10.4 go-telegram/bot (types de mise à jour des widgets)
- Limites du plan gratuit ngrok
- Tunnels rapides Cloudflare
- Guide de démarrage Cloudflare Tunnel
- Ouverture de votre serveur de développement au public, Quasar
- Correction de “Blocked request” dans Strapi 5 (HMR clientPort)
Related InstaTunnel pages
Continue from this article into the most relevant product guides and workflows.
Related Topics
Keep building with InstaTunnel
Read the docs for implementation details or compare plans before you ship.