Cet article explique comment créer un bot Telegram et recevoir dans la messagerie les notifications des contrôles de surveillance des hôtes. Vous recevez ainsi les alertes sur votre smartphone et sur tout autre appareil connecté à Internet.
1. Créer un chatbot et obtenir un jeton dans Telegram
Commencez par créer un chatbot dans Telegram et récupérer son jeton :
- Ouvrez Telegram et recherchez le bot BotFather (@BotFather).
- Démarrez une conversation avec BotFather en cliquant sur Démarrer
- Saisissez la commande /newbot pour créer un bot (ou choisissez-la dans la liste).
- BotFather vous demande le nom du bot (par exemple MyTestBot). Ce nom s'affiche dans les contacts.
- Indiquez ensuite le nom d'utilisateur du bot. Il doit se terminer par bot (par exemple MyTestBot_bot).
Une fois le bot créé, BotFather vous fournit son jeton (par exemple 123456789:ABCdefGhIJKlmNoPQRstuVWXyz).
2. Obtenir l'identifiant de conversation
Pour recevoir les notifications dans Telegram, vous avez aussi besoin de l'identifiant de conversation. Voici comment l'obtenir :
- Envoyez un message à votre bot.
- Ouvrez ensuite ce lien dans le navigateur : https://api.telegram.org/bot<YourBotToken>/getUpdates
Remplacez <YourBotToken> par le jeton de votre bot.
Si tout est correct, le navigateur affiche un objet JSON. Pour une lecture plus confortable, cochez Pretty-print dans le navigateur.
Copiez le paramètre « id » de l'objet « chat ».
3. Configurer les notifications dans le programme
Copiez ensuite les données obtenues dans le programme.
Cliquez sur Paramètres du programme, puis sur Messageries. Collez les données dans les champs correspondants.
Dans la liste des contrôles, trouvez celui dont vous voulez recevoir les résultats dans Telegram. Cliquez dessus avec le bouton droit et choisissez Modifier le contrôle.
Cliquez plusieurs fois sur Suivant jusqu'à l'étape 3. Cochez Exécuter si le contrôle réussit, Exécuter si le contrôle échoue, ou les deux.
Choisissez la messagerie Telegram comme méthode de notification, comme sur l'image ci-dessous.
Si toutes les notifications doivent arriver dans un seul bot, vous pouvez laisser le champ Chat ID vide : cet identifiant est déjà dans les paramètres généraux du programme. Au niveau d'un contrôle, ce champ sert à envoyer les notifications vers des bots différents. Si vous avez plusieurs bots, indiquez l'identifiant de celui créé pour les alertes de ce contrôle.
Vous pouvez tester la notification tout de suite. Le bouton Test doit envoyer un message d'essai au bot.
Terminé.
Les notifications des contrôles arrivent désormais sous forme de messages dans le chatbot Telegram que vous avez créé.