Pourquoi ?

Pilotez vos équipements et donnez des instructions à Jeedom avec Telegram, que ce soit via votre mobile ou bien l’application Desktop de Telegram. Sachez qu’il existe aussi une alternative vous permettant de répondre aux mêmes besoins avec Messenger si vous préférez vous passer de Telegram.

Comment ?

Avant de commencer, sachez qu’il est nécessaire que votre Jeedom soit accessible depuis l’extérieur en HTTPS. Si ce n’est pas déjà fait, vous pouvez suivre ce guide d’installation d’un certificat SSL Let’s Encrypt pour remplir cette condition.

Création du bot

La procédure sera réalisée via un mobile sous Android. Sachez bien entendu que cette démarche est également possible via iOS ou Windows Phone.

Installez dans un premier temps l’application Telegram (lien Android, iOS ou Windows Phone).

Au premier démarrage, Telegram vous demandera d’accepter plusieurs autorisations pour vos contacts, etc… Une fois ces étapes effectuées, accédez au menu via le bouton associé.

Accédez ensuite aux paramètres de Telegram.

Définissez ensuite un nom d’utilisateur Telegram.

Revenez ensuite sur la page précédente et cliquez sur la loupe présente en haut à droite de l’interface de sorte à rechercher « botfather« . Choisissez ce bot : va nous permettre de créer d’autres bots.

Cliquez ensuite sur le bouton « Démarrer« .

Le bot vous proposera plusieurs commandes. Sélectionnez la commande /newbot .

Choisissez ensuite un nom pour votre bot Telegram. Il s’agira du nom affiché dans vos discussions (différents du nom d’utilisateur qui, quant à lui, sera public et unique).

Définissez ensuite le nom d’utilisateur du bot (public et unique : vous risquez de devoir faire preuve d’originalité puisque de nombreux noms ont été créés depuis).

Votre bot est maintenant bien créé. Notez bien le token qui sera indiqué dans le message, il sera nécessaire ultérieurement.

Intégration dans Jeedom

Depuis Jeedom, commencez par installer le plugin Telegram.

Accédez ensuite à la configuration du plugin lorsque Jeedom vous le proposera.

Activez ensuite le plugin.

Accédez ensuite à la liste des équipements du plugin.

Créez ensuite un nouvel équipement et donnez-lui le nom de votre choix.

Commencez tout d’abord par l’activer puis renseignez le token récupéré précédemment, à la création du bot.

Vérifiez également que l’option « Créer automatiquement les nouveaux contacts » soit bien cochée.

Sauvegardez ensuite vos modifications.

Reprenez ensuite l’application Telegram (en mobile ou via la version desktop) puis recherchez et sélectionnez votre bot via la loupe située dans le coin supérieur droit.

Cliquez ensuite sur le bouton « Démarrer« .

Envoyez un message à votre bot.

Retournez ensuite dans l’équipement créé avec Jeedom et accédez à l’onglet « Commandes« . Vous y trouverez l’utilisateur à partir duquel vous venez d’envoyer un message à votre bot.

Assurez-vous que la case « Interactions » soit cochée pour pouvoir donner des instructions à votre Jeedom.

Vous pouvez maintenant donner des instructions à Jeedom par le biais de vos interactions. Je vous suggère d’approfondir le sujet en consultant la suite du guide pour connaître davantage d’options et fonctionnalités.

Pour aller plus loin

Désactiver l’ajout des nouveaux contacts

Si vous n’avez plus besoin d’ajouter de nouveaux contacts afin de piloter votre Jeedom avec Telegram et que vous avez suivi les étapes précédentes, je vous suggère de désactiver la création de nouveaux contacts. En effet, le bot étant public, vous pourriez recevoir des messages de tiers et ainsi avoir plusieurs utilisateurs non légitimes de créés dans votre équipement.

Pour ce faire, accédez à la configuration de votre équipement et, dans l’onglet « Général« , décochez l’option « Créer automatiquement les nouveaux contacts« .

Les notifications silencieuses

L’option permet, comme son nom l’indique, de recevoir des notifications silencieuses, que le téléphone soit en vibreur ou sonnerie. L’option se trouve également dans la configuration de votre équipement, dans l’onglet « Général« .

Envoyer une image

Telegram permet l’envoi d’une image, très pratique si vous faites de la vidéo surveillance par exemple. Pour ce faire, vous trouverez, selon l’appareil réalisant la capture, une commande permettant l’envoi de l’image dans laquelle vous pourrez saisir la méthode d’envoi en paramètre. Il vous faudra alors choisir la commande d’envoi de message avec Telegram.

Afficher un menu d’intéractions (Ask)

De la même manière qu’avec Messenger et le plugin FBbot, il vous est possible de créer un menu d’intéractions sur Telegram :

Pour ce faire, il faut dans un premier temps créer un scénario.

Utilisez ensuite la commande « Ask » comme dans l’exemple ci-dessous :

Dans cet exemple, le menu me permet d’obtenir des informations sur mes capteurs, les transports en commun, mais aussi d’activer ou de désactiver mon alarme.

Les alternatives à Telegram

Si vous préférez utiliser une autre application que Telegram, je vous suggère d’utiliser le plugin FBbot pour communiquer avec Jeedom via Messenger.