Actions personnalisées et intégration Telegram

• Présentation de l'intégration Telegram
• Créer un bot Telegram
• Envoyer des messages à une conversation Telegram
• Envoyer des messages à un canal Telegram

Telegram est une messagerie permettant d'envoyer messages, photos, vidéos et fichiers à vos contacts. Vous pouvez aussi créer des bots et des canaux pour envoyer des messages à plusieurs utilisateurs.

RdpGuard peut envoyer des notifications à une conversation ou à un canal Telegram via l'API des bots.

Pour cela, créez un bot Telegram et obtenez son jeton API. Vous devez aussi connaître l'identifiant de la conversation ou du canal de destination.

Ce guide explique pas à pas comment créer un bot, obtenir son jeton API et trouver les identifiants de conversation et de canal.

Utilisez ces informations pour configurer l'action Envoyer un message Telegram dans RdpGuard.

Créez votre bot avec @BotFather, le bot officiel de Telegram pour créer et gérer des bots.

1. Ouvrez Telegram et recherchez @BotFather. Choisissez le compte vérifié illustré ci-dessous.

   

2. Ouvrez la conversation avec BotFather et cliquez sur Démarrer.

   

3. Envoyez /newbot pour créer un bot.
4. Choisissez un nom pour votre bot.
5. Choisissez un nom d'utilisateur unique se terminant par bot.
6. Copiez le jeton API fourni par BotFather.

Conservez votre jeton API en lieu sûr et ne le partagez avec personne.

Utilisez une conversation privée avec votre bot pour recevoir les notifications sur votre compte Telegram. RdpGuard peut récupérer l'identifiant de conversation pour vous.

1. Ouvrez votre bot dans Telegram, cliquez sur Démarrer et envoyez-lui un message.

   

2. Exécutez le tableau de bord RdpGuard en tant qu'administrateur. Ouvrez Outils, Actions personnalisées / Notifications et cliquez sur Ajouter.
3. Choisissez un Événement, par exemple IP bloquée, puis Envoyer un message Telegram dans le champ Tâche.

4. Collez le jeton de BotFather dans Jeton du bot et cliquez sur Obtenir les discussions.

   

5. Sélectionnez votre conversation dans la liste Discussion. Modifiez le Message si nécessaire ; les variables d'action permettent d'inclure l'adresse IP, le nom d'utilisateur et d'autres détails de l'événement.
6. Cliquez sur Exécuter le test et confirmez pour envoyer un message de test à la conversation sélectionnée.

7. Laissez Activer cette action personnalisée coché et cliquez sur Ajouter l'action.

   

8. Cliquez sur Enregistrer les modifications dans Actions personnalisées.

Si Aucune discussion trouvée apparaît ou si votre conversation manque, envoyez un nouveau message au bot et cliquez de nouveau sur Obtenir les discussions. RdpGuard utilise les mises à jour récentes du bot, conservées par Telegram pendant 24 heures au maximum. Une fois l'action enregistrée, il n'est pas nécessaire d'envoyer un message chaque jour pour continuer à recevoir des notifications.

Utilisez un canal Telegram pour partager les notifications avec plusieurs abonnés. Ajoutez votre bot comme administrateur autorisé à publier, puis sélectionnez le canal dans RdpGuard. Utilisez un canal existant ou créez-en un comme suit.

Pour créer un canal Telegram :

1. Ouvrez l'onglet Discussions de Telegram et cliquez sur Nouveau message.

   

2. Cliquez sur Nouveau canal.

   

   Si Telegram affiche une introduction, cliquez sur Créer un canal.

   

3. Choisissez un nom pour le canal et cliquez sur Suivant.

   

4. Choisissez les paramètres de confidentialité du canal et cliquez sur Suivant.

   

Pour ajouter le bot comme administrateur du canal :

1. Ouvrez le canal depuis l'onglet Discussions.

   

2. Cliquez sur le nom du canal pour ouvrir ses paramètres.

   

3. Cliquez sur Administrateurs.

   

4. Cliquez sur Ajouter un administrateur.

   

5. Recherchez votre bot et sélectionnez-le.

   

6. Autorisez Publier des messages et cliquez sur Ajouter un administrateur.

   

Publiez un nouveau message dans le canal pour que RdpGuard puisse le trouver.

Pour configurer les notifications de canal dans RdpGuard :

1. Exécutez le tableau de bord RdpGuard en tant qu'administrateur. Ouvrez Outils, Actions personnalisées / Notifications et cliquez sur Ajouter.
2. Choisissez un Événement, puis Envoyer un message Telegram dans le champ Tâche.

3. Collez le jeton dans Jeton du bot et cliquez sur Obtenir les discussions.

   

4. Sélectionnez le canal dans la liste Discussion et saisissez le Message de notification.
5. Cliquez sur Exécuter le test et confirmez pour envoyer un message de test au canal.

6. Laissez Activer cette action personnalisée coché et cliquez sur Ajouter l'action.

   

7. Cliquez sur Enregistrer les modifications dans Actions personnalisées.

Si le canal manque, vérifiez que le bot est administrateur et autorisé à publier. Publiez un nouveau message dans le canal et cliquez de nouveau sur Obtenir les discussions.