Aller au contenu principal

Service client

Guide BotFather : créer un bot Telegram et obtenir son token

BotFather est le bot officiel de Telegram pour créer et gérer des bots. Voici chaque étape, de /newbot à un token qui fonctionne, les réglages d'un bot d'entreprise, la marche à suivre si le token fuite et comment relier le bot à la boîte de réception d'équipe.

Équipe MonoChat Mis à jour: 4 min de lecture

Sur cette page
  1. Étape 1 : créer le bot avec /newbot
  2. Étape 2 : protéger le token
  3. Étape 3 : soigner le profil que voient vos clients
  4. Étape 4 : faire connaître le bot
  5. Étape 5 : relier le bot à MonoChat
  6. Erreurs fréquentes
  7. Sources

BotFather (@BotFather) est le bot officiel de Telegram pour créer et gérer des bots. Vous lui envoyez /newbot, choisissez un nom et un nom d’utilisateur, et il vous renvoie le token de votre bot : la clé qui permet à un logiciel comme MonoChat de recevoir et d’envoyer des messages en tant que votre bot. Comptez deux minutes ; les détails ci-dessous sont ce qui garde ensuite le bot sûr et fonctionnel.

Étape 1 : créer le bot avec /newbot

  1. Dans Telegram, recherchez @BotFather et ouvrez le compte doté du badge bleu de vérification.
  2. Envoyez /newbot.
  3. Envoyez le nom que vos clients verront dans le chat, par exemple « Cabinet dentaire Bellecour ». Vous pourrez le changer avec /setname.
  4. Envoyez le nom d’utilisateur : 5 à 32 caractères, lettres latines sans accents, chiffres et tirets bas, se terminant par « bot », comme dentaire_bellecour_bot ou DentaireBellecourBot. La casse ne compte pas et il ne peut plus être modifié : choisissez-le comme un nom de domaine.
  5. BotFather confirme par un message qui contient le lien du bot (t.me/dentaire_bellecour_bot) et son token, du type 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw.

Si le nom d’utilisateur est déjà pris, essayez une variante avec votre ville ou un tiret bas ; les noms d’utilisateur sont uniques dans tout Telegram.

Étape 2 : protéger le token

Le token est le mot de passe du bot. Quiconque le possède peut lire les messages reçus par votre bot et écrire en son nom.

  • Rangez-le dans votre gestionnaire de mots de passe, jamais dans un chat, un e-mail ou un document partagé.
  • Ne le collez que dans l’outil qui fait tourner le bot.
  • S’il a fuité, ou si un ancien salarié ou une agence l’avait, envoyez /token à BotFather pour en générer un nouveau, puis mettez à jour l’outil.
  • Pour voir vos bots et leurs réglages, envoyez /mybots à tout moment.

Étape 3 : soigner le profil que voient vos clients

Ces commandes de BotFather décident de ce que le client voit avant son premier message :

CommandeCe qu’elle règleConseil pour un bot d’entreprise
/setuserpicPhoto de profilVotre logo, carré et lisible en petit
/setdescriptionLe texte sous « Que peut faire ce bot ? » (512 caractères max.)Ce qu’on peut demander, et quand un humain répond
/setabouttextLa ligne du profil et des liens partagés (120 caractères max.)Une phrase et vos horaires
/setcommandsLe menu affiché quand on tape « / »/start, /help et deux ou trois commandes à vous, comme /rdv ou /commande
/setprivacyLes messages de groupe que reçoit le botGardez la confidentialité activée si le bot n’a pas besoin de tout lire
/setjoingroupsL’ajout du bot à des groupesDésactivez-le pour un bot de support en tête-à-tête

Étape 4 : faire connaître le bot

Un bot ne peut pas engager la conversation : une personne doit d’abord l’ouvrir et appuyer sur Démarrer, ou l’ajouter à un groupe. Le lien est donc votre canal d’acquisition :

  • Affichez t.me/<nom_utilisateur> sur votre site, vos factures, vos colis et vos réseaux sociaux, ou en QR code en boutique.
  • Ajoutez un paramètre pour savoir d’où viennent les gens : t.me/dentaire_bellecour_bot?start=instagram arrive au bot sous la forme /start instagram. Lettres, chiffres, _ et - sont acceptés, jusqu’à 64 caractères.

Étape 5 : relier le bot à MonoChat

MonoChat relie votre bot grâce au token, sans code :

  1. Dans MonoChat, ouvrez Paramètres › Discussion › Canaux et cliquez sur Connecter.
  2. Choisissez Telegram Bot.
  3. Collez le token de BotFather dans Clé du bot Telegram et cliquez sur Enregistrer.

Les messages adressés à votre bot arrivent désormais dans la boîte de réception d’équipe, à côté de WhatsApp, d’Instagram et de vos autres canaux. Vous pouvez y brancher un assistant IA qui répond à partir de vos propres contenus, passer la main à votre équipe et envoyer des diffusions Telegram à toutes les personnes qui ont démarré le bot.

Erreurs fréquentes

  • Relier un bot à deux outils. Un bot reçoit ses mises à jour par un webhook ou par polling, pas les deux ; le deuxième outil prive le premier de ses messages sans prévenir. Un bot par outil.
  • Supprimer au lieu de renommer. /deletebot supprime le bot, libère son nom d’utilisateur et ne s’annule pas. Pour un changement de marque, modifiez le nom et la photo.
  • Céder le bot à une agence pour de bon. Le transfert (/mybots › votre bot › Transfer ownership) n’est possible qu’à une personne qui a déjà utilisé le bot, et il est définitif. Gardez le bot sur un compte de l’entreprise.
  • Envoyer trop vite. Telegram demande aux bots de ne pas dépasser environ un message par seconde dans un chat, 20 par minute dans un groupe et environ 30 par seconde en envoi groupé.

Notre guide Telegram pour les entreprises compare les bots aux comptes Business, aux chaînes et aux groupes.

Vous pouvez commencer gratuitement sur app.monochat.ai.

Sources

FAQ

Questions fréquentes

Où trouver le token de mon bot Telegram ?

BotFather l'envoie dans le message qui confirme la création du bot. Si vous l'avez perdu ou pensez que quelqu'un d'autre l'a, envoyez /token à BotFather pour en générer un nouveau, puis collez-le dans l'outil qui fait tourner votre bot.

BotFather est-il gratuit ?

Oui. Créer et gérer des bots avec BotFather ne coûte rien, et un bot peut écrire gratuitement aux personnes qui l'ont démarré. Seules les diffusions payantes au-delà d'environ 30 messages par seconde sont facturées, en Telegram Stars.

Puis-je changer le nom d'utilisateur du bot plus tard ?

Non. Le nom d'utilisateur qui se termine par « bot » est fixé dès que BotFather crée le bot. Le nom affiché, la description, le texte « À propos » et la photo se modifient à tout moment.

Que se passe-t-il si quelqu'un obtient le token de mon bot ?

Cette personne peut piloter le bot : lire les messages qu'il reçoit et écrire en son nom. Envoyez tout de suite /token à BotFather pour générer un nouveau token et remplacez-le dans chaque outil qui utilise le bot.

Pourquoi mon bot ne répond plus depuis que je l'ai relié à un deuxième outil ?

Un bot reçoit ses messages soit par un seul webhook, soit par polling, jamais les deux. Quand le deuxième outil installe son propre webhook, le premier ne reçoit plus rien. Reliez chaque bot à un seul outil et créez un second bot pour vos tests.

Premier mois de Growth offert

WhatsApp, Instagram et Messenger dans une seule boîte de réception

Commencez gratuitement avec MonoChat : boîte de réception d'équipe, assistants IA, modèles et campagnes sur les API officielles de Meta.

Un code par entreprise • 30 jours pour l’utiliser • Sans carte bancaire

$150 pour démarrer.

Obtenir