Telegram

Une visite chez BotFather, un collage

Telegram ne permet de créer des bots qu'à l'intérieur de Telegram même, en discutant avec un compte appelé @BotFather. C'est vrai pour tous les services, pas seulement pour ProxyAI. Le dialogue s'ouvre donc sur un court guide qui prend environ quatre-vingt-dix secondes et un seul collage.

Ouvrez Configurations → Canaux dans la barre latérale du tableau de bord, puis sur la carte Telegram, choisissez Configurer.

Le guide en haut, Créer votre bot (environ 90 secondes), vous propose :

1. Un bouton Ouvrir BotFather qui vous amène directement à ce chat.
2. Une copie en un clic de la commande /newbot à envoyer.
3. Une invite pour le nom d'affichage, celui que vous voulez.
4. Une invite pour le nom d'utilisateur ; Telegram exige qu'il se termine par bot, par exemple acme_support_bot.
5. La réponse de BotFather, qui contient le code à coller ici.

Le guide disparaît une fois le bot enregistré, un canal configuré n'affiche donc que ses réglages.

Traitez ce code comme un mot de passe. S'il est un jour divulgué, envoyez /revoke à BotFather, récupérez le nouveau code et enregistrez-le ici.

Remplissez le dialogue

Jeton du bot : collez le code que BotFather vous a envoyé. C'est le seul champ obligatoire.

Nom d'utilisateur du bot, sans le @. ProxyAI vérifie le nom réel auprès de Telegram lors de l'enregistrement, donc une petite erreur ici se corrige d'elle-même.

Mode confidentialité indique à ProxyAI ce qu'il doit attendre dans les discussions de groupe. Le réglage lui-même se fait dans BotFather, pas ici.

• Confidentialité de groupe activée (valeur par défaut de Telegram) : dans les groupes, le bot ne voit que les commandes, les réponses à ses propres messages et les messages qui le mentionnent avec @.
• Tous les messages du groupe : le bot voit tout ce qui se dit dans un groupe. Pour y parvenir, envoyez d'abord /setprivacy à BotFather et choisissez Disable, puis retirez le bot de chaque groupe et rajoutez-le. Un bot administrateur d'un groupe voit de toute façon tout.

Bouton de menu et Clavier en ligne : vous pouvez les régler maintenant, mais les réponses du bot n'affichent pas encore de boutons ; ne vous attendez donc à aucun changement visible dans Telegram pour l'instant.

Ce qui se passe à l'enregistrement

ProxyAI vérifie le code auprès de Telegram et connecte votre bot pour vous. Vous n'avez rien à recoller dans BotFather.

Si l'enregistrement échoue :

• Jeton invalide : le code a été remplacé ou annulé après que vous l'avez copié. Obtenez-en un nouveau auprès de BotFather.
• Échec du webhook : le code était bon, mais la connexion ne s'est pas terminée, en général à cause d'un incident ponctuel. Enregistrez à nouveau.

Testez

Ouvrez votre bot dans Telegram, envoyez-lui un message et vérifiez la réponse. Ajoutez-le ensuite à un groupe et confirmez qu'il se comporte comme vous l'avez choisi avec le mode confidentialité. C'est le réglage le plus souvent mal compris : le modifier dans BotFather n'affecte pas les groupes où le bot est déjà présent ; retirez-le et rajoutez-le là-bas.

Les réponses très longues sont tronquées pour respecter la limite de message de Telegram, plutôt que de ne pas être envoyées.