Telegram
Notifications aux administrateurs via un bot Telegram. Le destinataire est choisi par l’ID du chat.
Ouvrez Integrations → Ajouter une intégration → Telegram. Pour une connexion déjà installée, utilisez Configurer.
Préparation
- Ouvrez @BotFather dans Telegram, envoyez /newbot, indiquez un nom et copiez le jeton fourni.
- Ajoutez le bot au chat ou au canal cible et donnez-lui le droit d’envoyer des messages ; pour un chat privé, écrivez d’abord au bot.
- Obtenez le chat ID à partir de l’objet update de l’API Bot ou utilisez un identifiant de canal valide, puis indiquez-le dans le formulaire.
- Pour une connexion standard, laissez l’adresse de l’API vide : https://api.telegram.org sera utilisée. Ensuite, enregistrez les paramètres et testez la connexion.
Paramètres
| Champ | Type | Rôle et règles de saisie |
|---|---|---|
| ID du chat | Paramètre | Identifiant du destinataire issu de message.chat.id dans l’API Bot ; pour un canal, le format valide est défini par l’API Bot. |
| Adresse de l’API Telegram | Paramètre | Adresse du service Telegram Bot API. Le champ est généralement laissé vide ; n’indiquez l’adresse d’un proxy que sur instruction de l’administrateur. |
| Jeton du bot | Secret | Token secret délivré par @BotFather. Ne le publiez pas et révoquez-le via BotFather en cas de fuite. |
Enregistrement et modification
Renseignez les paramètres et cliquez sur « Save ». À la réouverture, les secrets ne sont pas affichés : l’indicateur de présence d’un secret n’est pas sa valeur. Un champ vide pour un secret existant conserve l’ancienne valeur ; une nouvelle valeur la remplace. Après toute modification, testez de nouveau la connexion.
Le type Telegram est disponible dans le catalogue complet des intégrations.
Vérification du résultat
- Assurez-vous que le bot a accès au chat choisi et le droit d’envoyer des messages.
- Lancez le test de connexion dans MDM.
- Vérifiez la réception d’une notification de test autorisée précisément dans le chat voulu, puis associez le canal à une règle de notification.
Le statut « Configured » signifie que les paramètres sont enregistrés. Évaluez séparément le résultat du test de connexion et celui de l’opération cible. Les détails de la vérification sont disponibles dans la fiche de la connexion.
Restrictions et dépendances
Dans un chat privé, l’utilisateur doit d’abord engager la conversation avec le bot. Le succès de l’autorisation du bot ne confirme pas l’accès au chat choisi. Laissez l’endpoint vide pour l’API Bot standard ; l’adresse d’un proxy doit être convenue avec l’administrateur.
En cas de dysfonctionnement
| Symptôme | Que vérifier |
|---|---|
| Le bot s’authentifie, mais aucun message | Vérifiez le chatId, la présence du bot dans le groupe ou le canal et les droits d’envoi. |
| Unauthorized | Vérifiez le jeton et sa révocation éventuelle dans BotFather. |
| Erreur d’accès à l’API | Vérifiez l’accès réseau du serveur MDM et l’endpoint facultatif. |