Où trouver le token du bot Telegram ?
Le token est une clé secrète qui permet à Mini Apps Builder de connecter votre bot au projet. Ce n’est pas le mot de passe Telegram ni un lien vers le bot. Pour l’obtenir, il n’est pas nécessaire de programmer.
Comment obtenir un token si le bot n’existe pas encore
Ouvrez le BotFather officiel. Il s’agit de l’outil Telegram pour créer des bots et les gérer. Vérifiez le nom d’utilisateur — il doit s’agir exactement de @BotFather, sans lettres ni chiffres supplémentaires. L’interface est la même sur toutes les plateformes : Android, iOS, macOS, Windows, Linux, Web.
Les étapes suivantes se font dans le chat BotFather : appuyez sur Start Bot,
Vous verrez ce message. Ensuite, vous pouvez créer un bot de deux façons : via le chat ou via Mini App.
Création d’un nouveau bot via le chat
Vous devez sélectionner dans le message envoyé par BotFather /newbot. Cliquez simplement sur ce texte dans le message, et le processus de création du bot démarrera immédiatement.
BotFather vous demandera comment nommer l’application. Il s’agit du « nom » de votre bot/application, visible par tout utilisateur sur Telegram. Vous pourrez toutefois le modifier plus tard à tout moment.
Après avoir saisi le « nom », BotFather vous demandera de créer un username_bot — il s’agit d’un identifiant unique, qui ne pourra pas être modifié après la création. De plus, Telegram vous indiquera si la variante saisie est déjà utilisée.
Après avoir saisi le username_bot, vous verrez ce message : cela signifie que le bot a été créé. Le message contiendra le bot token. Cliquez simplement dessus pour le copier ; vous pourrez ensuite le coller sur notre site.
Le token copié doit être collé dans le champ "Token" lors de la création du projet dans Mini Apps Builder. Le projet sera alors créé.
Création d’un nouveau bot via Mini App
C’est la deuxième façon de créer un nouveau bot et d’obtenir le bot token. Si vous avez déjà utilisé la méthode ci-dessus, vous pouvez ne pas lire cette partie.
Appuyez sur le bouton "Open" en bas à gauche, à côté du champ de saisie du texte dans le chat.
Un écran comme celui-ci s’ouvrira. Si vous n’avez jamais créé de bots, vous verrez du "vide" sous le texte "My bots". Dans tous les cas, nous examinons ici le scénario de création d’un nouveau bot, donc appuyez sur le bouton "Create a New Bot".
Les champs mis en évidence sont obligatoires. Vous pourrez ajouter le logo et la section "About" plus tard, à tout moment.
Bot Name - le nom de votre bot/application, visible par tout utilisateur sur Telegram. Vous pourrez toutefois le modifier plus tard à tout moment.
username_bot - il s’agit d’un identifiant unique, qui ne pourra pas être modifié après la création. De plus, Telegram vous indiquera si la variante saisie est déjà utilisée.
Après avoir saisi Bot Name et username_bot, cliquez sur le bouton "Create Bot" en bas de l’écran.
Vous verrez un écran comme celui-ci ; cliquez sur le bouton "Copy" pour copier le Bot Token de ce bot.
Après avoir cliqué sur le bouton "Copy", vous verrez brièvement cette notification. Cela signifie que vous avez copié le token et que vous pouvez le coller sur notre site.
Le token copié doit être collé dans le champ "Token" lors de la création du projet dans Mini Apps Builder. Le projet sera alors créé.
Que faire si cela ne fonctionne pas
| Problème | Que faire |
|---|---|
| Le bot recherché n’apparaît pas dans la liste | Vérifiez si le compte Telegram auquel appartient le bot est ouvert. S’il a été créé par une autre personne, demandez-lui qui en est le propriétaire. |
| BotFather n’accepte pas le username | Utilisez des lettres latines, des chiffres et des underscores, et ajoutez le suffixe bot. Si le nom est déjà pris, trouvez-en un autre. |
| Impossible d’envoyer la commande | Ouvrez bien le chat @BotFather et envoyez /mybots ou /newbot dans la zone de message. |
| Mini Apps Builder n’accepte pas le token | Copiez-le à nouveau. Vérifiez que vous avez collé toute la chaîne sans texte supplémentaire ni espaces. |
Si l’erreur persiste, envoyez au support de Mini Apps Builder son texte et décrivez la dernière étape effectuée. Ne joignez pas le token lui-même. Sur la capture d’écran, masquez-le entièrement.
Comment garder le token en sécurité
Le token donne accès à la gestion du bot, traitez-le donc comme un mot de passe. Ne le publiez pas et ne l’envoyez pas à des tiers. Saisissez la clé uniquement dans le champ dédié du service auquel vous faites confiance pour connecter le bot.
