Base de connaissances GetMyBot

Projets et canaux

Créez un projet, connectez ses canaux et vérifiez son état. Gestion de plusieurs bots, changement de token, pause et remise en service après un gel.

Sur cette page

Un projet rassemble les réglages, les réactions et les données d'un bot ou d'un service. Un canal le relie à un lieu d'échange précis : un bot Telegram, le chat de votre site ou une autre messagerie. Une école peut ainsi utiliser un seul projet avec deux canaux, Telegram et son site.

Créez le projet dans Projets, puis ajoutez un canal. Pour Telegram, vous aurez besoin du token donné par @BotFather : c'est la clé qui permet de gérer le bot. Vous pouvez changer de projet depuis le sélecteur en haut de l'interface.

Le bot peut aussi utiliser WhatsApp et VK avec les mêmes réactions. Consultez Canaux pour une vue d'ensemble et WhatsApp pour sa configuration.

Connecter un bot

  1. Si vous n'avez pas encore de projet, ouvrez Projets et cliquez sur Ajouter un projet. Dans sa fiche, cliquez sur Ajouter un canal, puis choisissez Telegram. Pour un premier bot, vous pouvez utiliser l'assistant de démarrage.
  2. Collez le token de @BotFather et cliquez sur Valider. GetMyBot affiche le @username trouvé pour que vous puissiez vérifier le bot choisi.
  3. Cliquez sur Connecter. Le token est chiffré lors de son stockage et la réception des événements démarre aussitôt.

Le canal Telegram apparaît alors dans la fiche du projet, à côté de ses autres canaux. La fiche montre le nom du projet, le @username du bot, le nombre d'utilisateurs, les réactions actives et les requêtes du jour. Le solde de requêtes figure dans Facturation et Statistiques.

Plusieurs bots

Un compte peut gérer plusieurs projets et bots à la fois, dans la limite de son forfait (« nombre maximal de bots »). Choisissez un projet avec le sélecteur en haut ou depuis Projets. Les rubriques Réactions, Chats et Statistiques affichent alors les données du projet sélectionné.

Comment le bot reçoit les messages

Une fois Telegram connecté, GetMyBot reçoit automatiquement les messages, les clics sur les boutons, les arrivées dans un chat et les paiements. Aucun réglage supplémentaire n'est nécessaire si le token est valide. Selon la configuration du serveur, Telegram envoie les événements à l'adresse de la plateforme (webhook) ou la plateforme les demande régulièrement à Telegram (long polling).

Activer ou désactiver le bot

Chaque bot peut être activé ou désactivé dans la fiche État du bot des Paramètres. Un bot désactivé ne réagit pas aux messages. Le changement s'applique immédiatement, sans reconnexion.

État du projet et disponibilité des canaux

Dans Projets, le projet porte son propre état : Actif, En pause ou Gelé. Il ne s'agit pas d'une vérification de la livraison Telegram. Chaque canal a aussi sa propre étiquette : En ligne, Aucun signal, Configuré, Désactivé ou Projet inactif. Un projet actif avec un chat web et sans Telegram ne doit donc pas paraître « arrêté ».

Si un projet actif n'a qu'un seul canal Telegram activé, En ligne signifie qu'un processus chargé du bot s'est signalé récemment ; sinon, l'étiquette indique Aucun signal. Avec plusieurs canaux Telegram activés, l'étiquette indique Configuré : le signal commun au projet ne peut pas être attribué avec certitude à un canal particulier. Pour les autres plateformes, Configuré confirme la connexion du canal, sans promettre la livraison de chaque message.

La plateforme utilise plusieurs processus équivalents. Chacun signale toutes les 30 secondes qu'il s'occupe du bot. Un signal reste considéré comme récent pendant une minute et demie, pour éviter qu'un seul signal manqué fasse clignoter l'état.

En pratique :

  • L'état peut prendre un peu de retard. Après une connexion ou un redémarrage de la plateforme, En ligne peut apparaître pendant cette fenêtre plutôt qu'immédiatement.
  • Si Aucun signal persiste plus de quelques minutes pour un canal Telegram activé, vérifiez le token et la fiche Bot health dans les Paramètres. Le projet reste actif tant que vous ne le mettez pas en pause et que la plateforme ne le gèle pas en raison du forfait.
  • Le signal est partagé entre les processus : il ne dépend pas du serveur qui a répondu à votre demande. Avec plusieurs canaux Telegram, il ne prouve pas que chacun fonctionne séparément.

Quand le bot n'est plus en ligne

Chaque minute, la plateforme vérifie les derniers signaux. Si aucun n'est récent pour un bot activé, elle ouvre un incident, détermine une fois sa cause puis tente automatiquement de remettre le bot en service.

Quatre causes peuvent apparaître dans la fiche Bot health :

  • Webhook : Telegram ne transmet plus les événements à la plateforme, qui réenregistre son adresse.
  • Token révoqué : getMe renvoie 401. L'incident ne peut pas être corrigé par un redémarrage ; générez un nouveau token dans @BotFather et saisissez-le via Changer le token.
  • Aucun serveur ne traite les événements : la plateforme redémarre le bot.
  • Cause inconnue : Telegram n'a pas répondu à la vérification.

Un redémarrage fait la même chose que Synchroniser : il vérifie le token avec getMe et réenregistre le webhook. Les tentatives sont espacées progressivement. Chaque essai, sa date, son résultat et son éventuelle erreur apparaissent dans le Restart log de l'incident, avec la date du prochain essai.

Si le bot reste muet plus longtemps que le seuil indiqué dans Bot health (5 minutes par défaut), son propriétaire reçoit une notification intitulée « Бот офлайн » (« Bot hors ligne ») dans la cloche et par e-mail. Les chats ajoutés à la liste des destinataires reçoivent aussi un message du bot. Il n'y a qu'une alerte par incident. Quand les signaux reviennent, « Бот снова онлайн » (« Bot de nouveau en ligne ») annonce la durée de l'interruption. Les anciens incidents, leur durée et leur cause restent consultables dans la même fiche.

Gel lié au forfait

En plus de l'état activé ou désactivé, un bot peut être gelé. La plateforme le gèle automatiquement quand le forfait actif ne couvre plus le nombre de bots connectés, dans deux cas :

  • Limite de bots dépassée : vous avez adopté un forfait autorisant moins de bots que le nombre déjà connecté.
  • Abonnement non renouvelé : le forfait payant a expiré et la limite du forfait gratuit s'applique.

Un bot gelé ne reçoit plus de messages : la réception des événements est coupée, pas simplement marquée d'un indicateur. Ses données, réactions et abonnés restent intacts. Le gel est réversible.

Pour le remettre en service, payez un forfait couvrant le nombre de bots voulu. Les bots sont réactivés automatiquement à l'entrée en vigueur du forfait payé, du plus ancien au plus récent, jusqu'à atteindre la nouvelle limite. Vous ne pouvez pas choisir directement lequel revient. Pour en privilégier un autre, supprimez d'abord les connexions dont vous n'avez plus besoin, puis payez le forfait.

Un compte entier peut aussi être gelé : tous ses bots et diffusions sont alors suspendus et la bannière Compte gelé apparaît. Seule l'assistance peut lever ce gel. Consultez aussi Paiements et solde.

Profil et synchronisation

Dans les Paramètres, Synchroniser met à jour le nom du bot depuis Telegram si vous l'avez changé dans @BotFather. La photo de profil du bot est récupérée automatiquement.

Changer le token

Si vous avez régénéré le token dans @BotFather (Bot Settings → Revoke / New token), mettez-le à jour dans Paramètres → Canaux → Telegram 🔑. Le nouveau token doit appartenir au même bot (correspondre au même identifiant interne Telegram) — toutes les réactions, abonnés et données sont ainsi conservés. Si le canal Telegram ne s’affiche pas, choisissez «Changer le token» dans la même fenêtre.

Transférer le projet à un autre compte

Paramètres → Changer de propriétaire envoie une proposition de transfert à un autre compte GetMyBot par e-mail. Elle reste valable 72 heures. Tant que le destinataire ne l'a pas acceptée, le projet vous appartient toujours et vous pouvez annuler la proposition. Après son acceptation, le propriétaire change et vous perdez l'accès au projet. Utilisez cette option pour remettre un projet à un client ou à un collègue.

Modèles de bots

Un modèle est un instantané des réglages du projet et de toutes ses réactions que vous pouvez appliquer à un autre projet :

  • Créer un modèle, dans les Paramètres, enregistre le projet actuel sous un nom.
  • Appliquer un modèle remplace les réglages du projet choisi par ceux du modèle et ajoute les réactions du modèle aux réactions existantes.

C'est utile pour créer plusieurs projets à partir du même bot type.

Installer une solution prête à l'emploi depuis le catalogue

Le catalogue de solutions utilise un assistant d'installation. Indiquez les paramètres, vérifiez la compatibilité et les connexions nécessaires, puis examinez la liste des ressources qui seront créées. Après l'installation, terminez les étapes restantes et essayez le scénario avec une demande de test.

Cet assistant est différent de l'application d'un modèle de bot. Sa vérification préalable signale les paramètres ou fonctions manquants. Cocher une étape ne prouve pas que le service externe fonctionne.

Mesurer les résultats d'une solution installée

Choisissez la période à évaluer. Pour comparer les résultats, sélectionnez un mode disponible et vérifiez la taille de l'échantillon ainsi que les diagnostics. Un manque de données ou de comparaison est différent d'un résultat égal à zéro.

Pour continuer